V2
Classify

Cancel Classify Job

Changed on

Cancel a running classify 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.

post/api/v2/classify/{job_id}/cancel

Request

  • Base URL: https://api.cloud.llamaindex.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.cloud.llamaindex.ai/api/v2/classify/{job_id}/cancel
  • Auth: HTTP bearer

Path parameters

job_idstring required

Query parameters

project_idstring uuid nullable
organization_idstring uuid nullable

Cookies

sessionstring nullable

Response

Successful Response

created_atstring date-time nullable

Creation datetime

updated_atstring date-time nullable

Update datetime

file_inputstring required

ID of the input file or parse job

project_idstring required

Project this job belongs to

user_idstring required

User who created this job

status'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' required

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

document_input_type'url' | 'file_id' | 'parse_job_id' required

Whether the input was a file or parse job (FILE or PARSE_JOB)

error_messagestring nullable

Error message if job failed

configuration_idstring nullable

Product configuration ID

transaction_idstring nullable

Idempotency key

parse_job_idstring nullable

Associated parse job ID

Example response

{
  "configuration": {
    "rules": [
      {
        "type": "invoice",
        "description": "contains invoice number, line items, and total amount"
      }
    ],
    "parsing_configuration": {
      "lang": "en",
      "target_pages": "1,3,5-7",
      "max_pages": 10
    }
  },
  "usage": {
    "credits": 30,
    "parse_credits": 3
  }
}

Changes

  • a38b684f8e1bRevision changes
    • breaking

      the /// response property's maxLength was increased from 500 to 2000 for the response status

    • warning

      added the new CANCELLED enum value to the response property for the response status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property to the response with the status

  • 614771991b52Revision changes
    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status