Start a client project
Create one deep client report against the shared Agency project quota. Never falls back to personal credits. Async: 202 on a new dispatch, 200 with reused=true when the clientRunId replays an existing report. clientRunId is scoped to the calling key; reusing one that belongs to a different workspace is 409 CLIENT_RUN_ID_CONFLICT. A response carrying dispatchPending=true means the dispatch outcome is unknown - retry the same clientRunId and arguments after 60 seconds; recovery reuses the original report and credit. 503 TRIGGER_DISPATCH_FAILED is a definite rejection: the credit was restored and that request stays failed on replay, so a new attempt needs a new clientRunId. Creating a report here does not email the client or publish a share link.
Authorizations
Your API key (prv_...), sent as-is. It is the only credential the API needs - see the Authentication guide.
Body
Idempotency key, scoped to the calling API key.
20040 - 5000018080808012Optional and deep-only. An Agency project always spends one shared deep project credit; any other value is 400 INVALID_SCAN_TYPE.
deep Not accepted here. Client share links are created in the Agency dashboard; publish=true is 400 INVALID_INPUT.
false Response
Existing report replayed via clientRunId (reused=true).
PENDING, PROCESSING, COMPLETED, FAILED starter, deep Present only while the report is not terminal.
Present when this clientRunId replayed an existing report.
The dispatch outcome is unknown. Retry the same clientRunId and arguments after 60 seconds; recovery reuses the original report and credit. Past 23 hours the recovery text directs you to support instead of risking a duplicate job.
What to do next, present alongside dispatchPending.