Practical guides
Track background work
Tell the difference between accepted, running and finished.
Some actions take time. An HTTP 202 Accepted response means Acquisity accepted the work and created an operation to track it.
- Read the response's
Locationheader, which points to/v1/operations/{operationId}. - Call Get operation with your authorized key.
- Check
status. Keep polling while it isqueuedorrunning, allowing time between requests and respecting rate limits. - Stop polling at a terminal status and inspect the result or error.
| Status | Meaning |
|---|---|
queued / running | Work has not finished. |
succeeded | The operation completed; inspect result for the endpoint-specific outcome. |
failed | Work failed; inspect its error before deciding whether to retry. |
cancelled | Work was cancelled. Do not report success. |
needs_attention | Work stopped and needs attention. Do not report success or keep polling as if it were running. |
Read the outcome carefully: campaign lead search succeeds when dispatched. The leads arrive later. Other actions return their own documented result fields.
Organization-owned operations can only be read by that organization; user-owned operations by that user. Preserve the operation ID if your integration times out so it can check the existing work instead of submitting it again.