---
title: "Delete a pending asynchronous AI job"
method: DELETE
path: "/ai-jobs/{jobId}"
tags: ["AI Jobs"]
---

# Delete a pending asynchronous AI job

`DELETE /ai-jobs/{jobId}`

## Request

- Base URL: `https://www.cloudworldmodel.ai/api`
- URL: `https://www.cloudworldmodel.ai/api/ai-jobs/{jobId}`
- Auth: HTTP bearer

Cancels a pending or running AI analysis job. Idempotent — cancelling
an already-terminal job returns 200 with the terminal state.

**Authentication:** Required (API key, write scope).

## Path parameters

- `jobId` string, required

## Response `200`

Cancellation result

- object
  - `id` string
  - `status` 'cancelled' | 'completed' | 'failed'

## Other responses

- `401`: Authentication required or invalid API key
- `403`: Insufficient permissions — the API key lacks the required scope
- `404`: Resource not found
- `500`: Internal server error

---

[API](https://skmtc.dev/cloudworldmodel/apis/cloud-world-model-agent-api.md) · [All operations](https://skmtc.dev/cloudworldmodel/apis/cloud-world-model-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cloudworldmodel/apis/cloud-world-model-agent-api/revisions/ecc3ad1ff07f?raw)