Durable jobs

Queue long-running API work through POST /api/v1/jobs. All seven operations support durable execution, idempotent creation, cursor pagination, cancellation, polling, stored SSE replay, sandbox mode, and signed webhook delivery. Jobs and recoverable results are retained for 30 days. Durable workers require their migrations and runtime configuration before activation.

1
2
3
4
5
6
7
8
9
10
11
12curl https://deepsearch.app/api/v1/jobs \
  -H "Authorization: Bearer $DEEPSEARCH_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-job-1" \
  -d '{
    "operation": "dossier",
    "input": {
      "person": { "name": "Ada Lovelace" },
      "format": "json"
    },
    "sandbox": true
  }'

Events are a finite replay by default. Use follow=1 to follow progress and after or Last-Event-IDto resume. Follow connections end after four minutes; reconnect explicitly using the last event ID. Cancellation stops remaining work at a checkpoint; work already delivered can remain charged.