Delete Job | Captain Docs

Cancel and delete an indexing job.

Behavior:

If job is pending or running -> transitions to cancelled
If job is already completed/failed/cancelled -> returns 200 with current state (idempotent)

Cancel and delete an indexing job. Behavior: - If job is pending or running -> transitions to cancelled - If job is already completed/failed/cancelled -> returns 200 with current state (idempotent)

Authentication

AuthorizationBearer

Bearer token authentication using API key

Path parameters

job_idstringRequired

Response

Delete Result

job_idstring

statusstring

messagestring

cancelled_atstring or null

1	import requests
2
3	BASE_URL = "https://api.runcaptain.com"
4	API_KEY = "your_api_key"
5	ORG_ID = "your_organization_id"
6	JOB_ID = "job_s3_abc123"
7
8	headers = {
9	"Authorization": f"Bearer {API_KEY}",
10	"X-Organization-ID": ORG_ID
11	}
12
13	response = requests.delete(
14	f"{BASE_URL}/v2/jobs/{JOB_ID}",
15	headers=headers,
16	timeout=30.0
17	)
18
19	if response.status_code == 200:
20	data = response.json()
21	print(f"Job {data['job_id']} deleted at {data['cancelled_at']}")
22	else:
23	print(f"Error: {response.status_code}")

1	{
2	"job_id": "job_s3_abc123",
3	"status": "cancelled",
4	"message": "Job deleted successfully",
5	"cancelled_at": "2025-01-20T08:20:00Z"
6	}

Authentication

Path parameters

Headers

Response