Skip to main content
POST
/
api
/
search
/
deep_research
/
{job_id}
/
cancel
Cancel Deep Research Job
curl --request POST \
  --url https://search.clado.ai/api/search/deep_research/{job_id}/cancel \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "message": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.clado.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

ParameterTypeRequiredDescription
job_idstringYesThe 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 CodeDescription
401Unauthorized - API key missing or invalid
404Not Found - Job ID does not exist
409Conflict - Job cannot be cancelled (already completed or failed)
500Internal 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