Update media
/api/v2/media/{media}Authorization
bearerAuth In: header
Path Parameters
uuidQuery Parameters
Optional account to run this request against. Defaults to the account the API token is scoped to, so callers with a single account can omit it. Must be an account the authenticated user belongs to; staff may target any account. For write requests the value may be sent in the JSON body instead of the query string. The resolved account is returned on the X-Resi-Account-Id response header.
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Fields depend on the target kind. File media accepts caption, alt_text, tags. Embed media accepts title, url, embed_type, provider, settings, sort_order, tags. Sending a field that does not apply to the resolved kind returns 422. Updating a file changes the shared asset across every placement it is attached to.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/api/v2/media/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Content-Type: application/json" \ -d '{}'{ "data": { "kind": "file", "media": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "url": "string", "thumb_url": "string", "full_url": "string", "caption": "string", "alt_text": "string", "tags": [ "string" ], "reference_url": "string", "reference_id": "string", "property_id": "05003a8a-8f3c-454b-8884-a906ec46f5f5", "folder_id": "7695bac3-9397-4ec2-9335-45a2a16f1901" }, "attachments": [ { "attachable_type": "property", "attachable_id": "59195f01-f1b9-4338-a5d0-42410c1862ca", "slot": "string", "sort_order": 0 } ] }}