Skip to main content
PATCH
Update media metadata

Authorizations

Authorization
string
header
required

Organization-scoped bearer credential: a customer API key (1club_sk_live_...) or an MCP OAuth access token.

Path Parameters

mediaId
integer
required

Body

application/json
name
string
altText
string | null
caption
string | null

Response

The updated media item

An item in the organization's media library. Files are hosted externally (Cloudinary for anything uploaded through the admin editor); this record is the library entry that website sections and content reference by url.

id
integer
url
string

Public URL of the file. Immutable - register a new item to replace a file.

name
string

Display name. Searched, along with altText, when looking an image up by name.

altText
string | null

Alternative text for screen readers. Also searched.

caption
string | null
mediaType
enum<string>
Available options:
image,
video
createdAt
string<date-time>
updatedAt
string<date-time>