API Reference
Libraries
API Overview
Files
Upload File
POST/api/v1/beta/files
List Files
GET/api/v1/beta/files
Delete File
DELETE/api/v1/beta/files/{file_id}
Read File Content
GET/api/v1/beta/files/{file_id}/content
Parsing
Extract
Create Extract Job
POST/api/v2/extract
List Extract Jobs
GET/api/v2/extract
Get Extract Job
GET/api/v2/extract/{job_id}
Delete Extract Job
DELETE/api/v2/extract/{job_id}
Validate Extraction Schema
POST/api/v2/extract/schema/validation
Generate Extraction Schema
POST/api/v2/extract/schema/generate
Classifier
ClassifierJobs
Batches
Classify
Create Classify Job
POST/api/v2/classify
List Classify Jobs
GET/api/v2/classify
Get Classify Job
GET/api/v2/classify/{job_id}
Configurations
Create Configuration
POST/api/v1/beta/configurations
List Configurations
GET/api/v1/beta/configurations
Get Configuration
GET/api/v1/beta/configurations/{config_id}
Update Configuration
PUT/api/v1/beta/configurations/{config_id}
Delete Configuration
DELETE/api/v1/beta/configurations/{config_id}
Projects
List Projects
GET/api/v1/projects
Get Project
GET/api/v1/projects/{project_id}
Data Sinks
List Data Sinks
GET/api/v1/data-sinks
Create Data Sink
POST/api/v1/data-sinks
Get Data Sink
GET/api/v1/data-sinks/{data_sink_id}
Update Data Sink
PUT/api/v1/data-sinks/{data_sink_id}
Delete Data Sink
DELETE/api/v1/data-sinks/{data_sink_id}
Data Sources
List Data Sources
GET/api/v1/data-sources
Create Data Source
POST/api/v1/data-sources
Get Data Source
GET/api/v1/data-sources/{data_source_id}
Update Data Source
PUT/api/v1/data-sources/{data_source_id}
Delete Data Source
DELETE/api/v1/data-sources/{data_source_id}
Pipelines
PipelinesSync
PipelinesData Sources
Update Pipeline Data Source
Deprecated
PUT/api/v1/pipelines/{pipeline_id}/data-sources/{data_source_id}
Get Pipeline Data Source Status
Deprecated
GET/api/v1/pipelines/{pipeline_id}/data-sources/{data_source_id}/status
Sync Pipeline Data Source
Deprecated
POST/api/v1/pipelines/{pipeline_id}/data-sources/{data_source_id}/sync
PipelinesImages
List File Page Screenshots
GET/api/v1/files/{id}/page_screenshots
Get File Page Screenshot
GET/api/v1/files/{id}/page_screenshots/{page_index}
Get File Page Figure
GET/api/v1/files/{id}/page-figures/{page_index}/{figure_name}
List File Pages Figures
GET/api/v1/files/{id}/page-figures
PipelinesFiles
PipelinesMetadata
PipelinesDocuments
Get Pipeline Document Status
Deprecated
GET/api/v1/pipelines/{pipeline_id}/documents/{document_id}/status
List Pipeline Document Chunks
Deprecated
GET/api/v1/pipelines/{pipeline_id}/documents/{document_id}/chunks
Retrievers
Create Retriever
POST/api/v1/retrievers
Upsert Retriever
PUT/api/v1/retrievers
List Retrievers
GET/api/v1/retrievers
Get Retriever
GET/api/v1/retrievers/{retriever_id}
Update Retriever
PUT/api/v1/retrievers/{retriever_id}
Delete Retriever
DELETE/api/v1/retrievers/{retriever_id}
Direct Retrieve
POST/api/v1/retrievers/retrieve
RetrieversRetriever
Retrieve
POST/api/v1/retrievers/{retriever_id}/retrieve
Beta
BetaIndexes
Get Index
GET/api/v1/indexes/{index_id}
Delete Index
DELETE/api/v1/indexes/{index_id}
Create Index
POST/api/v1/indexes
Sync Index
POST/api/v1/indexes/{index_id}/sync
List Indexes
GET/api/v1/indexes
BetaRetrieval
Retrieve
POST/api/v1/retrieval/retrieve
Find Files
POST/api/v1/retrieval/files/find
Grep File
POST/api/v1/retrieval/files/grep
Read File
POST/api/v1/retrieval/files/read
BetaChat
List Sessions
GET/api/v1/chat
Create Session
POST/api/v1/chat
Get Full Session
GET/api/v1/chat/{session_id}
Delete Session
DELETE/api/v1/chat/{session_id}
Get Session Summary
GET/api/v1/chat/{session_id}/summary
Stream Messages
POST/api/v1/chat/{session_id}/messages/stream
BetaAgent Data
Get Agent Data
GET/api/v1/beta/agent-data/{item_id}
Update Agent Data
PUT/api/v1/beta/agent-data/{item_id}
Delete Agent Data
DELETE/api/v1/beta/agent-data/{item_id}
Create Agent Data
POST/api/v1/beta/agent-data
Search Agent Data
POST/api/v1/beta/agent-data/:search
Aggregate Agent Data
POST/api/v1/beta/agent-data/:aggregate
Delete Agent Data By Query
POST/api/v1/beta/agent-data/:delete
BetaSheets
Get Result Region
Deprecated
GET/api/v1/beta/sheets/jobs/{spreadsheet_job_id}/regions/{region_id}/result/{region_type}
BetaDirectories
Create Directory
POST/api/v1/beta/directories
List Directories
GET/api/v1/beta/directories
Get Directory
GET/api/v1/beta/directories/{directory_id}
Update Directory
PATCH/api/v1/beta/directories/{directory_id}
Delete Directory
DELETE/api/v1/beta/directories/{directory_id}
BetaDirectoriesFiles
Add Directory File
POST/api/v1/beta/directories/{directory_id}/files
List Directory Files
GET/api/v1/beta/directories/{directory_id}/files
Get Directory File
GET/api/v1/beta/directories/{directory_id}/files/{directory_file_id}
Update Directory File
PATCH/api/v1/beta/directories/{directory_id}/files/{directory_file_id}
Delete Directory File
DELETE/api/v1/beta/directories/{directory_id}/files/{directory_file_id}
Upload File To Directory
POST/api/v1/beta/directories/{directory_id}/files/upload
BetaBatch
Create Batch Job
POST/api/v1/beta/batch-processing
List Batch Jobs
GET/api/v1/beta/batch-processing
Get Batch Job Status
GET/api/v1/beta/batch-processing/{job_id}
Cancel Batch Job
POST/api/v1/beta/batch-processing/{job_id}/cancel
BetaBatchJob Items
List Batch Job Items
GET/api/v1/beta/batch-processing/{job_id}/items
Get Item Processing Results
GET/api/v1/beta/batch-processing/items/{item_id}/processing-results
BetaSplit
Create Split Job
POST/api/v1/beta/split/jobs
List Split Jobs
GET/api/v1/beta/split/jobs
Get Split Job
GET/api/v1/beta/split/jobs/{split_job_id}
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/python/shared/mcp/