Update Media
PATCH
/api/media/{path}/metadata
const url = 'https://example.com/api/media/example/metadata';const options = { method: 'PATCH', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"description":"The ridge at dusk, second pass","tags":["keeper","portrait"],"character_ids":["example"],"included_in_training_dataset":true}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PATCH \ --url https://example.com/api/media/example/metadata \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "description": "The ridge at dusk, second pass", "tags": [ "keeper", "portrait" ], "character_ids": [ "example" ], "included_in_training_dataset": true }'Edit an asset’s human-authored fields: caption, tags, subjects, training flag.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”path
required
Path
string
Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
MediaMetadataPatch
Everything about an asset a human edits after it exists.
Every field is optional and omitting one leaves it alone — a PATCH carrying
only tags must not clear a caption.
object
tags
Any of:
Array<string>
null
character_ids
Any of:
Array<string>
null
Responses
Section titled “Responses”Successful Response
Media typeapplication/json
Response Update Media Api Media Path Metadata Patch
object
key
additional properties
any
Examplegenerated
{}Validation Error
Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationErrorobject
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{ "detail": [ { "loc": [ "example" ], "msg": "example", "type": "example" } ]}