---
title: "Cancel a deep research job"
method: POST
path: "/ai/v1/deep-research/{id}/cancel"
---

# Cancel a deep research job

`POST /ai/v1/deep-research/{id}/cancel`

## Request

- Base URL: `https://api.messari.io`
- URL: `https://api.messari.io/ai/v1/deep-research/{id}/cancel`
- Auth: API key in header `X-Messari-API-Key`
- TypeScript: <https://skmtc.dev/messari/apis/messari-api-deep-research-v1/docs/ai/v1/deep-research/:id/cancel/post.ts> (a function with typed inputs; its response is checked against the schema)

Requests cancellation of a running deep research job. Only jobs with status 'queued' or 'in_progress' can be cancelled. The job's status will transition to 'cancelled'.

## Response `200`

Default response

- object
  - `job_id` string, byte, required: Unique identifier for the cancelled deep research job
  - `object` string, required: Type of object returned, always 'deep_research'
  - `status` string, required: Status of the job after cancellation

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/messari/apis/messari-api-deep-research-v1.md) - [All operations](https://skmtc.dev/messari/apis/messari-api-deep-research-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/messari/apis/messari-api-deep-research-v1/revisions/af35b9757e14?raw)