---
title: "Start a sample asynchronous job without authentication"
method: POST
path: "/demo/jobs"
tags: ["Demo"]
---

# Start a sample asynchronous job without authentication

`POST /demo/jobs`

Public, no-auth demo of the asynchronous-job pattern. Starts a synthetic job and returns `202 Accepted` with a `Location` header (and `data.status_url`) pointing at the job-status resource. Poll `GET /demo/jobs/{id}` until the status is terminal. No real work runs; the status is a fixed sample.

## Headers

- `Idempotency-Key` string

## Response `202`

Job accepted. Poll the returned status URL for progress.

- object
  - `success` true, required
  - `demo` true, required
  - `note` string
  - `data` object, required
    - `id` string, required
    - `type` string
    - `status` 'queued' | 'processing' | 'completed' | 'failed', required
    - `status_url` string, uri, required
    - `created_at` string, date-time

## Other responses

- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/primitive/apis/primitive-api.md) · [All operations](https://skmtc.dev/primitive/apis/primitive-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/primitive/primitive-api/revisions/c2299d28022c/schema)