---
title: "Cancel a context add job"
method: DELETE
path: "/api/v1/context/add-async/{id}/cancel"
tags: ["context"]
---

# Cancel a context add job

`DELETE /api/v1/context/add-async/{id}/cancel`

Attempts to cancel a context add job by job id.
- If the job is already completed or failed, returns 404.
- If the job is currently running ("active"), returns 409 and cannot be cancelled.
- Only jobs in "waiting" or "delayed" state can be cancelled.

## Path parameters

- `id` string, required

## Response `200`

Job cancelled successfully

- object
  - `success` boolean, required
  - `jobId` string, required
  - `status` string, required
  - `message` string, required

## Other responses

- `400` — Invalid job id
- `401` — Unauthorized
- `402` — Payment Required
- `403` — Forbidden: insufficient scope
- `404` — Job not found or already completed/failed
- `409` — Job is currently running and cannot be cancelled
- `500` — Internal Server Error

---

[API](https://skmtc.net/alchemyst-ai/apis/alchemyst-ai-api-v1-documentation.md) · [All operations](https://skmtc.net/alchemyst-ai/apis/alchemyst-ai-api-v1-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alchemyst-ai/alchemyst-ai-api-v1-documentation/versions/af43a0360c78/schema)