---
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`

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.net/messari/apis/messari-api-deep-research-v1.md) · [All operations](https://skmtc.net/messari/apis/messari-api-deep-research-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/messari/messari-api-deep-research-v1/versions/af35b9757e14/schema)