> ## 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 Deep Research

> Cancel a running deep research job

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

## Cancel Deep Research

```bash theme={null}
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

```json theme={null}
{
  "success": true,
  "message": "Deep research job cancelled successfully"
}
```

### Response (Already Completed)

```json theme={null}
{
  "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](/api-reference/endpoint/get-deep-research-status) endpoint to check final status


## OpenAPI

````yaml POST /api/search/deep_research/{job_id}/cancel
openapi: 3.1.0
info:
  title: Clado Search & Enrichment API
  description: API for searching LinkedIn profiles and enriching contact information
  version: 1.0.0
servers:
  - url: https://search.clado.ai
    description: Production server
security:
  - bearerAuth: []
paths:
  /api/search/deep_research/{job_id}/cancel:
    post:
      tags:
        - Deep Research
      summary: Cancel Deep Research Job
      operationId: cancelDeepResearchJob
      parameters:
        - name: job_id
          in: path
          required: true
          description: Unique identifier for the deep research job to cancel
          schema:
            type: string
      responses:
        '200':
          description: Job cancelled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CancelJobResponse'
components:
  schemas:
    CancelJobResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key authentication. Keys start with 'lk_'.

````