v2 Auto

Delete Query

Delete a terminal query.

Only queries in a terminal status (triggered, expired, cancelled, failed) can be deleted. Active queries must be cancelled first. Do not use this endpoint to cancel running queries; use POST /v2/auto/queries/{queryId}/cancel for active queries.

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",
  "deletedAt": "2026-04-01T12:00:00.000Z"
}
delete/v2/auto/queries/{queryId}

Request

  • Base URL: https://api.elfa.ai
  • URL: https://api.elfa.ai/v2/auto/queries/{queryId}
  • Auth: API key in header x-elfa-api-key

Path parameters

queryIdstring required

The unique query identifier

Response

Ok

ApiKeyDeleteQueryResponse required

Changes

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