Skip to content

content_media_get

Read one media asset: its storage status, type and size.

Tool

content_media_get

Read one media asset: its storage status, type and size.

Read one media asset: its storage status, type and size.

Behavior

HTTP
GET /content/media/:id

Arguments

NameTypeRequiredDescription
idstringThe media asset id returned when it was created.

Response

FieldTypeAlwaysDescription
idstringMedia asset id. Use it to attach the asset to a post.
keystringObject key in the product bucket. Private — hand it to no one, it is not a URL.
mimestringStored media type, or null while still pending.
errorstringWhy the asset is failed — a readable reason, or null when nothing went wrong.
sourcestringHow the bytes arrived: url (fetched by the toolkit) or upload (PUT by the app).
statusstringStorage status: pending (the bytes are not in the bucket yet) -> ready (stored, attachable to a post) or failed (ingestion gave up; see error).
filenamestringOriginal filename, kept for display only.
createdAtstringISO-8601 creation time.
sizeBytesintegerStored size in bytes, or null while pending.
sourceUrlstringThe URL the bytes were fetched from, if any.
updatedAtstringISO-8601 time of the last change.

Try it

Read one media asset: its storage status, type and size.

When to use

Read one media asset: its storage status, type and size.

Example

Ask your agent something like this:

Read one media asset: its storage status, type and size.

The agent will invoke content_media_get with these arguments:

{
  "id": "<id>"
}

Esc

Start typing to search the docs.

navigateselect