Skip to main content
GET
/
tasks
/
{task_id}
Get Task Status
curl --request GET \
  --url https://api.moda.app/v1/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "task_01HT9WK8N3M2J4A5Z6P7Q8R9TV",
  "attempt": 123,
  "max_attempts": 123,
  "links": {
    "self": "<string>",
    "events": "<string>",
    "cancel": "<string>",
    "canvas": "<string>"
  },
  "created_at": "<string>",
  "started_at": "<string>",
  "completed_at": "<string>",
  "progress": {
    "percent": 123,
    "step": "<string>",
    "message": "<string>"
  },
  "input": {},
  "result": {},
  "error": {},
  "credits": {
    "credits_used": 123,
    "credits_remaining": 123
  },
  "retry_after_ms": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.moda.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key from Settings > Developer > REST API

Headers

​
Moda-Version
enum<string>
default:2026-05-01

Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.

Available options:
2026-04-12,
2026-05-01
Example:

"2026-05-01"

Path Parameters

​
task_id
string
required

Prefixed task_ wire ID (Crockford base32 body). Path parameters additionally accept a bare UUID string for back-compat; JSON body fields require the prefixed form.

Pattern: ^task_[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$
Example:

"task_01HT9WK8N3M2J4A5Z6P7Q8R9TV"

Response

Successful Response

Canonical wire-format for every async design operation.

All consumers -- REST, webhooks, SSE, MCP -- serialize through Task.from_db() so the shape is always consistent.

​
id
string
required

Prefixed task_... identifier.

Pattern: ^task_[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$
Example:

"task_01HT9WK8N3M2J4A5Z6P7Q8R9TV"

​
kind
enum<string>
required

Discriminator for the kind-specific result payload.

Available options:
design,
export,
remix,
brand_kit_extract
​
status
enum<string>
required

Current lifecycle status.

Available options:
queued,
running,
succeeded,
failed,
canceled,
expired
​
attempt
integer
required

Current attempt number (1-based).

​
max_attempts
integer
required

Maximum attempts before dead-lettering.

​
links
TaskLinks · object
required

HATEOAS links for this task.

​
created_at
string | null

ISO 8601 timestamp.

​
started_at
string | null

ISO 8601 timestamp.

​
completed_at
string | null

ISO 8601 timestamp.

​
progress
TaskProgress · object

Live progress for running tasks. Null when not applicable.

​
input
Input · object

Sanitized echo of the original request.

​
result
Result · object

Kind-specific result payload. Present only for succeeded tasks.

​
error
Error · object

Error info for failed tasks: {message, retryable}.

​
credits
CreditUsage · object

Credit usage. Present only for completed tasks when billing is enabled.

​
retry_after_ms
integer | null

Suggested milliseconds to wait before the next poll. Null for terminal tasks.