Alpha
Verify

Create Verify Job

Changed on

Create a Verify job.

Analyzes a document for signs of doctoring (splicing, copy-move, AI generation, metadata tampering, ...). Set file_input to a file ID (dfl-...). Optionally provide a configuration object to control the semantic agent.

The job runs asynchronously. Poll GET /verify/{job_id} with expand=result to check status and retrieve results.

post/api/alpha/verify

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/alpha/verify
  • Auth: HTTP bearer

Query parameters

project_idstring uuid nullable
organization_idstring uuid nullable

Cookies

sessionstring nullable

Request body

webhook_configuration_idsstring[] nullable

IDs of saved webhook configurations to notify for this job.

file_inputstring required

File ID of the document to analyze

transaction_idstring nullable

Idempotency key scoped to the project. Reusing a key returns the original job; the new request body is ignored.

Example request

{
  "webhook_configuration_ids": [
    "whc-...",
    "whc-..."
  ],
  "webhook_configurations": [
    {
      "webhook_url": "https://example.com/webhooks/llamacloud",
      "webhook_headers": {
        "Authorization": "Bearer sk-..."
      },
      "webhook_signing_secret": "whsec_...",
      "webhook_events": [
        "parse.success",
        "parse.error"
      ],
      "webhook_output_format": "json"
    }
  ],
  "file_input": "dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "configuration": {
    "tier": "agentic",
    "target_pages": "1,3,5-7"
  },
  "transaction_id": "tx-unique-idempotency-key"
}

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

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

Type of the document input (FILE)

error_messagestring nullable

Error message if job failed

transaction_idstring nullable

Idempotency key

Example response

{
  "configuration": {
    "tier": "agentic",
    "target_pages": "1,3,5-7"
  }
}

Changes