Download an image result

Download an image through the time-limited signed URL returned on the task.

GET/api/v1/assets/{asset_id}/content

Browse common endpoints

Overview

The signed URL is bound to the account, task, asset, representation, and asset deletion time. Use the complete URL as returned; do not rebuild its signature or add a bearer key.

Authentication: Signed URL

Request

Path parameters

Name	Type	Description
`asset_id`required	string	Asset ID returned in the task result.

Query parameters

Name	Type	Description
`expires`required	string	Fixed expiry value included in the signed URL.
`representation`required	url	Fixed to url.
`signature`required	string	Time-limited server-issued signature.

Response

A successful response is image binary; errors still use the standard JSON error envelope.

HTTP	Meaning
`200`	Request succeeded
`404`	Resource not found or signature invalid
`410`	Task result or signed asset expired
`500`	Internal service error

Success response type

image/png | image/jpeg | image/webp

Important boundaries

Images are retained on the server for 3 hours and then automatically removed; a signed URL never outlives image deletion.
This endpoint returns binary content and is not executed by the JSON-only explorer.

Open the machine-readable OpenAPI

Code & API explorer

GET · /api/v1/assets/{asset_id}/content

curl -X GET "$OGA_BASE_URL/api/v1/assets/asset_01JEXAMPLE/content?expires=<EXPIRES>&representation=<REPRESENTATION>&signature=<SIGNATURE>" \
  -H "X-Request-Id: <UUID_V4>" \
  -H "Accept-Language: en-US"

Requests go only to this site's fixed same-origin endpoint. The API key stays in this page's password field and is never placed in a URL, persisted, or copied into an example.

This endpoint returns image binary. To avoid loading a private asset into the docs page, use the copyable command instead of the JSON explorer.

Response