Basker Docs

Update Media with PUT

Update a Media. Rate limit: 20 requests per minute per API key. This PUT route has the same partial-update behavior and response as PATCH.

PUT
/{version}/{tenant}/media/{id}
Authorization<token>

Use format: users API-Key YOUR_API_KEY

In: header

Path Parameters

version*string

API version

Default"2026-02"
Value in"2026-02"
tenant*string

Tenant slug

id*string

Media ID

Query Parameters

select?

Field selection object. Example query: select[slug]=true&select[updatedAt]=true

populate?

Relationship population object. Example query: populate[media][url]=true

depth?integer

Relationship population depth.

Range0 <= value
locale?string

Content locale, or all to return every locale.

fallbackLocale?string

Locale to use when the requested locale has no value.

draft?boolean

When true, read or write the draft version.

Defaultfalse
joins?

Controls pagination, sorting, filtering, and counts for joined fields.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X PUT "https://api.basker.app/partners/2026-02/string/media/string?select%5Bslug%5D=true&select%5BupdatedAt%5D=true&populate%5Bmedia%5D=%5Bobject+Object%5D" \  -H "Content-Type: application/json" \  -d '{}'
{
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "alt": "string",
  "caption": "string",
  "credit": "string",
  "filename": "string",
  "focalX": 0,
  "focalY": 0,
  "height": 0,
  "prefix": "string",
  "src": "string",
  "url": "string",
  "width": 0
}
Empty
{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please retry later."
}