LlamaExtract

Extract Stateless

Stateless extraction using a default agent in the user's default project; requires data_schema, config, and one of file_id / text / base64 file data.

post/api/v1/extraction/run

Query parameters

project_idstring uuid nullable

organization_idstring uuid nullable

Cookies

sessionstring nullable

Request body

file_idstring uuid nullable

The ID of the file to extract from

textstring nullable

The text content to extract from

Example request

{
  "webhook_configurations": [
    {
      "webhook_url": "https://example.com/webhooks/llamacloud",
      "webhook_headers": {
        "Authorization": "Bearer sk-..."
      },
      "webhook_events": [
        "parse.success",
        "parse.error"
      ],
      "webhook_output_format": "json"
    }
  ]
}

Response

Successful Response

idstring uuid required

The id of the extraction job

status'PENDING' | 'SUCCESS' | 'ERROR' | 'PARTIAL_SUCCESS' | 'CANCELLED' required

The status of the extraction job

errorstring nullable

The error that occurred during extraction

file_idstring uuid nullable

The id of the file that the extract was extracted from

Changes

Changed in 3 of the 33 revisions of this API.210

Jun 9, 2026b17341164de92See the full diff
- ○
  added the optional property detail/items/ctx to the response with the 422 status
  response-optional-property-added
- ○
  added the optional property detail/items/input to the response with the 422 status
  response-optional-property-added
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 4, 2026d40e17e17bd16See the full diff
- ○
  added the new classify.running enum value to the request property webhook_configurations/anyOf[subschema #1]/items/webhook_events/anyOf[subschema #1]/items/
  request-property-enum-value-added
- ○
  added the new sheets.cancelled enum value to the request property webhook_configurations/anyOf[subschema #1]/items/webhook_events/anyOf[subschema #1]/items/
  request-property-enum-value-added
- ○
  added the new sheets.error enum value to the request property webhook_configurations/anyOf[subschema #1]/items/webhook_events/anyOf[subschema #1]/items/
  request-property-enum-value-added
- ○
  added the new sheets.partial_success enum value to the request property webhook_configurations/anyOf[subschema #1]/items/webhook_events/anyOf[subschema #1]/items/
  request-property-enum-value-added
- ○
  added the new sheets.pending enum value to the request property webhook_configurations/anyOf[subschema #1]/items/webhook_events/anyOf[subschema #1]/items/
  request-property-enum-value-added
- ○
  added the new sheets.success enum value to the request property webhook_configurations/anyOf[subschema #1]/items/webhook_events/anyOf[subschema #1]/items/
  request-property-enum-value-added
Apr 24, 20261bbc901f8c0d22See the full diff
- ▲
  removed the enum value gemini-1.5-flash of the request property config/parse_model/anyOf[subschema #1: PublicModelName]/
  request-property-enum-value-removed
- ▲
  removed the enum value gemini-1.5-pro of the request property config/parse_model/anyOf[subschema #1: PublicModelName]/
  request-property-enum-value-removed
- ○
  removed the gemini-1.5-flash enum value from the extraction_agent/config/parse_model/anyOf[subschema #1: PublicModelName]/ response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the gemini-1.5-pro enum value from the extraction_agent/config/parse_model/anyOf[subschema #1: PublicModelName]/ response property for the response status 200
  response-property-enum-value-removed
This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history