Cancel an active query.

Only queries in active status can be cancelled. Queries already in a terminal state return 409 Conflict. This endpoint does not delete query records; use DELETE /v2/auto/queries/{queryId} after a terminal status when you need soft-delete behavior.

Cost

Free.

Auth

Required header:

x-elfa-api-key: <api_key>

Request Example

Path parameter:

• queryId (string)

Response Example (200)

{
  "id": "a12d20ff-6cb2-433e-afed-cc2e6a0380b6",
  "status": "cancelled",
  "cancelledAt": "2026-04-01T12:00:00.000Z"
}

Best practice: keep cancellation idempotent in your client workflow; treat repeated cancel attempts as safe no-op behavior.