jobs

Get job status

Poll a generation job's status. Returns pptx_url and preview_url when complete. For deck jobs, includes per-slide progress. Includes cost_charged — the retail price you paid.

get/v1/jobs/{job_id}

Request

  • Base URL: https://api.slideforge.dev
  • URL: https://api.slideforge.dev/v1/jobs/{job_id}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

job_idstring required

Query parameters

waitinteger

Long-poll: hold the connection up to N seconds (max 60) waiting for terminal status. 0 = immediate response (default).

fieldsstring nullable

Comma-separated field names to include (e.g. 'status,cost_charged'). Returns only those fields + job_id. Default: all fields.

sigstring

HMAC signature for signed-URL polling (used by MCP Apps iframe which has no Bearer token).

expstring

Signature expiry timestamp (unix epoch).

Response

Job status with results when complete

job_idstring required
namestring nullable
statusstring required
current_iterationinteger
max_iterationsinteger
current_scorenumber nullable
target_scorenumber
pptx_urlstring nullable
preview_urlstring nullable
pdf_urlstring nullable
final_scorenumber nullable
score_breakdownobject nullable
iterationsinteger nullable
cost_chargednumber nullable
latency_msinteger nullable
strategystring nullable
slides_completedinteger nullable
slides_failedinteger nullable
failed_slidesobject[] nullable
errorstring nullable

Changes

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