Quickstart

Dispatch your first checklist run in under 5 minutes.

1. Get an API key

Copy the key — it starts with rdk_live_. You'll only see it once.

2. Create a template

curl -X POST https://api.rundun.app/v1/templates \
  -H "Authorization: Bearer rdk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Vehicle handoff",
    "sections": [{
      "id": "g-ext1",
      "title": "Exterior",
      "steps": [{
        "id": "s-od01",
        "type": "number",
        "label": "Odometer reading",
        "required": true,
        "config": { "unit": "km", "min": 0 }
      }]
    }]
  }'

3. Dispatch a run

curl -X POST https://api.rundun.app/v1/runs \
  -H "Authorization: Bearer rdk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "t-...",
    "webhook": {
      "url": "https://your-app.com/hooks/rundun",
      "secret": "your-secret",
      "events": ["run.completed"]
    },
    "expires_in_hours": 24
  }'

Response includes a link — send it to whoever needs to complete the checklist.

4. Receive the webhook

When the checklist is complete, Rundun POSTs to your webhook URL:

{
  "event": "run.completed",
  "run_id": "r-...",
  "data": {
    "answers": { "s-od01": { "answer": 42150 } }
  }
}

See Webhook events for the full payload shape.