Stop a running query

DELETE 
/queries/:queryid

Requests cancellation of a query. The caller must be the user who submitted the query; a Super Admin (via the X-Amorphic-Super-Admin header) may cancel any query.

Cancellation is asynchronous. A 200 means the stop was accepted, and the returned QueryStatus is the state observed at that moment, not a guaranteed final state. A query that has already finished cannot be stopped and is reported with GE-1034 as HTTP 500.

Note that an unknown query id is reported as HTTP 400 with IPV-1002, not 404.

Request

Responses

200

Stop request accepted. QueryStatus reports the state observed when the stop was processed.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

Input validation or authorization failure. Body is {"Message": " - "}. Codes: IPV-1002 (query id not found), AUTH-1010 (the query belongs to a different user), AUTH-1001 / AUTH-1030 / GE-1060 (authorization).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Backend failure, and also the case where the query is in a state that cannot be stopped, which the handler raises as GE-1034 rather than a 400. Body is {"Message": " - "}.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers