Skip to main content
GET
/
v1
/
switchx
/
generations
/
{job_id}
Get Job Status
curl --request GET \
  --url https://api.modal.beeble.ai/v1/switchx/generations/{job_id} \
  --header 'x-api-key: <api-key>'
{
  "id": "<string>",
  "status": "<string>",
  "progress": 123,
  "generation_type": "<string>",
  "alpha_mode": "<string>",
  "output": {
    "render": "<string>",
    "source": "<string>",
    "alpha": "<string>"
  },
  "error": "<string>",
  "created_at": "<string>",
  "modified_at": "<string>",
  "completed_at": "<string>"
}

Authorizations

x-api-key
string
header
required

Path Parameters

job_id
string
required

Response

200 - application/json

Successful Response

Status response for a SwitchX job.

id
string
required

Job identifier (swx_...)

status
string
required

in_queue, processing, completed, or failed

progress
integer | null

Progress percentage (0–100)

generation_type
string | null

'image' or 'video'

alpha_mode
string | null

'auto', 'fill', or 'custom'

output
SwitchXOutputUrls · object

Output URLs (present when status is completed). URLs expire — download promptly.

error
string | null

Error message (present when status is failed)

created_at
string | null

ISO 8601 timestamp when the job was created

modified_at
string | null

ISO 8601 timestamp of the last status change

completed_at
string | null

ISO 8601 timestamp when the job completed or failed