Skip to main content
GET
/
models
/
{model_id}
/
status
Poll a model's creation status
curl --request GET \
  --url https://api.samsa.ai/public/v1/models/{model_id}/status \
  --header 'Authorization: Bearer <token>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "error": "<string>"
}
Poll a model’s creation status. Returns the lifecycle status (pending, processing, completed, or failed) and, on failure, the error detail. Unknown or other-organization ids return 404 not_found. Requires the models.read scope. Once status is completed, the model is ready to compose into image generation, Magic Edit, and styled video.

Authorizations

​
Authorization
string
header
required

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

Headers

​
authorization
string | null

Path Parameters

​
model_id
string<uuid>
required

Response

Successful Response

GET /models/{id}/status body (ADR §7.2).

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

pending, processing, completed, or failed.

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

"processing"

​
error
string | null

Failure detail when status is failed; otherwise null.