/api/exploration

POST /api/exploration/thread/{thread-id}/cancel

Changed on

Cancel an in-flight exploration thread. Stamps canceled_at and completed_at on the thread, and bulk-flips any still-pending ExplorationQuery rows to canceled. In-flight queries currently mid-QP-execution are left to run to natural completion — their result rows are orphaned but harmless (timeline scoring skips canceled threads).

Idempotent: a thread with completed_at IS NOT NULL (already terminal — natural completion or prior cancel) returns 200 with its existing state. Authorization is the same write check as other thread-mutating endpoints.

post/api/exploration/thread/{thread-id}/cancel

Request

  • Base URL
    (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    API key in header X-API-Key

Path parameters

thread-idinteger required

value must be an integer greater than zero.

Response

Successful response

canceled_atunknown required
completed_atunknown required
idinteger required

value must be an integer greater than zero.

Changes