Asset Management

Poll the ingest status of up to 100 assets

Where a batch of your assets is in ingest, in one call — the poll after an upload or a URL ingest, instead of GET /api/v1/assets/{id} per asset per tick. PROCESSING is still running; DONE and FAILED are final. width and height appear once ingest has measured them; a FAILED asset carries error — retryable: false means the file itself cannot be read.

Nothing is signed and nothing is written to the audit log: the answer is your own assets' progress, and IDs that are not yours are absent rather than reported. A POST only because a batch of ids does not fit a query string, so it takes no Idempotency-Key — a replay would answer a stale status.

USE THIS WHEN:

  • Waiting for uploaded or URL-ingested assets to finish (poll every one or two seconds)

DO NOT USE WHEN:

  • You need the whole asset → GET /api/v1/assets/{id} once it is DONE
  • You want the bytes → GET /api/v1/assets/{id}/content
post/api/v1/assets/status

Request

  • Base URL: https://api.imagestep.dev
  • URL: https://api.imagestep.dev/api/v1/assets/status
  • Auth: API key in header Authorization

Request body

idsstring[] required

Asset IDs to poll: at least one, at most 100; a repeated id is answered once

Response

OK

Changes

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