Skip to content
AxAxiom

Jobs

POST /v1/jobs requires Idempotency-Key. The documented candidate request fails with model_not_available and does not create a job.

curl -sS -X POST https://axiomgen.dev/v1/jobs \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: 3f1c0c4e-8a2b-4d7e-9c11-6b0a2f5d1e77" \
  -H "Content-Type: application/json" \
  -d '{"model":"flux-1-schnell","version":"candidate-1","input":{"prompt":"A ceramic cup on a walnut table, morning light","width":1024,"height":1024}}'
{
  "error": {
    "code": "model_not_available",
    "message": "flux-1-schnell@candidate-1 is registered as \"candidate\" and is not available for generation. No provider was called.",
    "request_id": "generated-per-request"
  }
}

GET /v1/jobs and GET /v1/jobs/{id} list and read only the calling organization. Another tenant's id is a 404.

POST /v1/jobs/{id}/cancel cancels a queued job and releases its reservation. A running job records a cancel request; the worker honors it before calling a provider. A finished job is returned unchanged. Cancellation is cooperative and at-least-once work can still be retried until a terminal state is stored.