Skip to main content
GET
Retrieve a resize job's status and results
Retrieve the status of a resize job. While it is pending or processing, keep polling; once completed, the response carries the produced images, each with a presigned url valid for 24 hours. Only jobs your organization created are visible; any other id returns 404 not_found. Requires the images.transform scope.

Example: completed job

200 OK
Pass a webhook_url on the original resize request to receive a signed callback instead of polling. See Webhooks.

Authorizations

Authorization
string
header
required

Organization API key as a bearer token: Authorization: Bearer samsa_sk_....

Path Parameters

resize_id
string<uuid>
required

Response

Successful Response

GET /images/resizes/{id} body — same contract as image generation.

Backed by image_generation_tasks like the other image jobs; a distinct component name for the docs.

id
string<uuid>
required
status
enum<string>
required

pending, processing, completed, failed, or cancelled.

Available options:
pending,
processing,
completed,
failed,
cancelled
Example:

"completed"

created_at
string<date-time>
required

When the job was submitted.

credits_used
integer | null

Net credits charged for this job, after any refunds.

Example:

5

images
PublicImageAsset · object[]

Produced images (presigned URLs); empty until completed.

error
string | null

Failure detail when status is failed; otherwise null.