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
| Name | Type | Required | Description |
|---|---|---|---|
| id | string | • | The media asset id returned when it was created. |
Response
| Field | Type | Always | Description |
|---|---|---|---|
| id | string | • | Media asset id. Use it to attach the asset to a post. |
| key | string | • | Object key in the product bucket. Private — hand it to no one, it is not a URL. |
| mime | string | • | Stored media type, or null while still pending. |
| error | string | • | Why the asset is failed — a readable reason, or null when nothing went wrong. |
| source | string | • | How the bytes arrived: url (fetched by the toolkit) or upload (PUT by the app). |
| status | string | • | Storage status: pending (the bytes are not in the bucket yet) -> ready (stored, attachable to a post) or failed (ingestion gave up; see error). |
| filename | string | • | Original filename, kept for display only. |
| createdAt | string | • | ISO-8601 creation time. |
| sizeBytes | integer | • | Stored size in bytes, or null while pending. |
| sourceUrl | string | • | The URL the bytes were fetched from, if any. |
| updatedAt | string | • | ISO-8601 time of the last change. |
Try it
Read one media asset: its storage status, type and size.