Skip to content

Cancel Parse Job

ParsingCancelResponse Parsing.Cancel(ParsingCancelParamsparameters, CancellationTokencancellationToken = default)
POST/api/v2/parse/{job_id}/cancel

Cancel a running parse job.

Stops processing and marks the job as CANCELLED. Returns the updated job. Jobs already in a terminal state (COMPLETED, FAILED, CANCELLED) cannot be cancelled.

ParametersExpand Collapse
ParsingCancelParams parameters
required string jobID
string? organizationID
string? projectID
ReturnsExpand Collapse
class ParsingCancelResponse:

A parse job.

required string ID

Unique parse job identifier

required string ProjectID

Project this job belongs to

required Status Status

Current job status: PENDING, RUNNING, COMPLETED, FAILED, or CANCELLED

One of the following:
"CANCELLED"Cancelled
"COMPLETED"Completed
"FAILED"Failed
"PENDING"Pending
"RUNNING"Running
DateTimeOffset? CreatedAt

Creation datetime

formatdate-time
string? ErrorMessage

Error details when status is FAILED

string? Name

Optional display name for this parse job

string? Tier

Parsing tier used for this job

DateTimeOffset? UpdatedAt

Update datetime

formatdate-time
Usage? Usage

Usage recorded against a job.

Double? Credits

Total credits billed against this job. Null until billing has recorded it.

IReadOnlyDictionary<string, string>? UserMetadata

Key/value tags associated with this job.

Cancel Parse Job

ParsingCancelParams parameters = new() { JobID = "job_id" };

var response = await client.Parsing.Cancel(parameters);

Console.WriteLine(response);
{
  "id": "pjb-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "project_id": "prj-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "status": "CANCELLED",
  "created_at": "2019-12-27T18:11:19.117Z",
  "error_message": "error_message",
  "name": "Q4 Financial Report",
  "tier": "fast",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "usage": {
    "credits": 30
  },
  "user_metadata": {
    "owner": "jerry",
    "team": "research"
  }
}
Returns Examples
{
  "id": "pjb-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "project_id": "prj-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "status": "CANCELLED",
  "created_at": "2019-12-27T18:11:19.117Z",
  "error_message": "error_message",
  "name": "Q4 Financial Report",
  "tier": "fast",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "usage": {
    "credits": 30
  },
  "user_metadata": {
    "owner": "jerry",
    "team": "research"
  }
}
Note for AI agents: this documentation is built for programmatic access. - Overview of all docs: https://developers.llamaindex.ai/llms.txt - Any page is available as raw Markdown by appending index.md to its URL — e.g. https://developers.llamaindex.ai/llamaparse/parse/getting_started/index.md - Agent-friendly REST search APIs live under https://developers.llamaindex.ai/api/ — search (BM25 full-text), grep (regex), read (fetch a page), and list (browse the doc tree). See https://developers.llamaindex.ai/llms.txt for parameters. - A hosted documentation MCP server is available at https://developers.llamaindex.ai/mcp. If you support MCP, you can ask the user to install it for browsing these docs directly (an alternative to the REST API). Setup: https://developers.llamaindex.ai/for-agents/mcp/ - Other LlamaIndex tooling for agents — the LlamaParse Platform MCP server, agent skills and plugins, and the n8n node — is mapped at https://developers.llamaindex.ai/for-agents/