Async jobs

Create an async job.

Queues any of the seven lookup operations and returns immediately. Poll the job, replay events, or receive job webhooks.

post/api/v1/jobs

Request

  • Base URL: https://deepsearch.app
  • URL: https://deepsearch.app/api/v1/jobs
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Safely retry job creation. Reusing a key with a different body returns 409.

X-Request-Idstring

Optional correlation id echoed on the job.

X-DeepSearch-Clientstring

Optional name/version naming the calling client. Self-reported and used only for aggregate analytics: it never affects authentication, rate limits, billing or the response. The official SDKs and CLI send it; any other name is counted as a custom client.

Request body

OR
OR
OR
OR
OR
OR

Response

Idempotent replay of an already completed job.

Changes

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