Assets

Get status of a single asset

Returns detailed status for a single file or URL asset. asset_id is the media_source_id returned in both files[] and urls[] of the bundle response — it is the universal identifier for all asset types. The response includes poll_interval_seconds; wait at least that many seconds before polling again.

get/v1/assets/{asset_id}

Request

  • Base URL: https://api.blee.com
  • URL: https://api.blee.com/v1/assets/{asset_id}
  • Auth: HTTP bearer

Path parameters

asset_idstring required

The media_source_id of the asset (from the files[] or urls[] array in the bundle response).

Response

Asset status.

asset_idstring required

The media_source_id of this asset. Use as the path parameter for GET /v1/assets/{asset_id}.

type'file' | 'url' required

"file" for uploaded files; "url" for submitted web links.

file_idstring

Present when type is file. The file_id from POST /v1/files.

filenamestring

Present when type is file.

urlstring

Present when type is url.

media_source_idstring required
dashboard_urlstring required
status'queued' | 'analyzing' | 'failed' | 'pending_review' | 'approved' | 'not_approved' required

Per-asset lifecycle combining AI-analysis progress and reviewer verdict. queued is only returned on PATCH for newly added assets. analyzing means AI analysis is still running. failed means the AI pipeline could not analyze this asset. pending_review means AI analysis completed but no reviewer has reached a verdict yet. approved / not_approved reflect the reviewer's verdict.

errorstring nullable required
poll_interval_secondsinteger required

Recommended number of seconds to wait before polling again. Respect this interval; do not poll more frequently.

external_refstring nullable required

Partner-supplied bundle reference inherited from the asset's bundle. Set once at bundle creation and inherited by new versions. null when the bundle was created without one.

Example response

{
  "result": {
    "summary": "Asset approved.",
    "analysis_completed_at": "2026-05-18T23:00:00Z"
  },
  "reviewers": [
    {
      "name": "Jane Reviewer",
      "review_status": "APPROVED",
      "review_status_label": "Approved with conditions",
      "review_status_reason": "Looks good once disclaimer is fixed.",
      "review_status_updated_at": "2026-05-19T15:42:00Z"
    }
  ],
  "comments": [
    {
      "created_at": "2026-05-19T15:30:00Z",
      "created_by_name": "Jane Reviewer"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.