Retrieve an asset

Retrieve the processing state of a previously uploaded asset. Assets are scoped to the requesting API key; references from other keys look like 404.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Retrieve the current processing state of a previously uploaded asset. Assets are scoped to your API key; references from other keys look like 404.

Response

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "supe_assets",
    "attributes": {
      "status": "processed",
      "media_kind": "image",
      "submitted_at": "2026-05-04T00:00:00Z",
      "processed_at": "2026-05-04T00:00:08Z",
      "original_retained": false
    },
    "links": {
      "self": "https://api.soundstripe.com/v1/supe/assets/550e8400-e29b-41d4-a716-446655440000"
    }
  },
  "links": {
    "self": "https://api.soundstripe.com/v1/supe/assets/550e8400-e29b-41d4-a716-446655440000"
  }
}

Attributes

AttributeTypeDescription
statusstringOne of pending, processing, processed, failed, blocked, or expired.
media_kindstringimage or video.
submitted_atstringISO-8601 timestamp of upload.
processed_atstringISO-8601 timestamp of successful processing. Present only after success.
original_retainedbooleanWhether the uploaded bytes are still retained. The original is automatically purged once the asset reaches a terminal state.
error_codestringPresent only on terminal-failure states.
error_messagestringPresent only on terminal-failure states.

Terminal failure codes

CodeMeaning
processing_failedProcessing failed and retries are exhausted.
blocked_for_safetyThe asset was rejected by safety filters.
Path Params
string
required

The asset ID returned when the asset was uploaded

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/vnd.api+json