Cancel Deep Research

Cancel a running deep research job

POST /api/search/deep_research/{job_id}/cancel

Cancel Deep Research Job

cURL

curl --request POST \
  --url https://search.clado.ai/api/search/deep_research/{job_id}/cancel \
  --header 'Authorization: Bearer <token>'

200

{
  "success": true,
  "message": "<string>"
}

Cancel a deep research job that is currently running. This will stop the job and prevent further credit consumption.

Cancel Deep Research

curl -X POST https://search.clado.ai/api/search/deep_research/550e8400-e29b-41d4-a716-446655440000/cancel \
  -H "Authorization: Bearer YOUR_API_KEY"

Path Parameters

Parameter	Type	Required	Description
job_id	string	Yes	The job ID of the deep research job to cancel

Response

{
  "success": true,
  "message": "Deep research job cancelled successfully"
}

Response (Already Completed)

{
  "success": false,
  "message": "Cannot cancel job: already completed"
}

Error Responses

Status Code	Description
401	Unauthorized - API key missing or invalid
404	Not Found - Job ID does not exist
409	Conflict - Job cannot be cancelled (already completed or failed)
500	Internal Server Error - Error cancelling job

Notes

• This endpoint is free - no credits are consumed
• No rate limiting applied
• Only pending jobs can be cancelled
• Cancelled jobs will not consume additional credits and only deduct credits correlating to partial results
• Partial results may be available for cancelled jobs
• Use the Get Deep Research Status endpoint to check final status

Authorizations

Authorization · string · header · required

API key authentication. Keys start with 'lk_'.

Path Parameters

job_id · string · required

Unique identifier for the deep research job to cancel

Response

200 - application/json

Job cancelled

success · boolean

message · string