How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

LlamaParse Beta API

The Beta API from LlamaParse — 32 operation(s) for beta.

LlamaParse Beta API is one of 36 APIs that LlamaParse publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Beta. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

This API exposes 50 operations across 32 paths, and defines 126 schemas. It is described by OpenAPI 3.2.0, at version 0.1.0.

Requests are made against a single base URL, https://api.cloud.llamaindex.ai.

50 operations 32 paths 126 schemas 6 DELETE24 GET2 PATCH16 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.1.0
Base URL
https://api.cloud.llamaindex.ai
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

LlamaParse Beta API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (HTTPBearer).

Paths & Operations 50

Across 32 paths, the API surfaces 50 operations — 6 DELETE, 24 GET, 2 PATCH, 16 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Beta 50
POST
/api/v1/classifier/jobs
Create Classify Job
create_classify_job_api_v1_classifier_jobs_post 3 params body → 200422
GET
/api/v1/classifier/jobs
List Classify Jobs
list_classify_jobs_api_v1_classifier_jobs_get 5 params → 200422
GET
/api/v1/classifier/jobs/{classify_job_id}
Get Classify Job
get_classify_job_api_v1_classifier_jobs__classify_job_id__get 4 params → 200422
GET
/api/v1/classifier/jobs/{classify_job_id}/results
Get Classification Job Results
get_classification_job_results_api_v1_classifier_jobs__classify_job_id__results_get 4 params → 200422
GET
/api/v1/beta/usage-metrics
List Usage Metrics
list_usage_metrics_api_v1_beta_usage_metrics_get 13 params → 200422
GET
/api/v1/beta/agent-data/{item_id}
Get Agent Data
get_agent_data_api_v1_beta_agent_data__item_id__get 4 params → 200422
PUT
/api/v1/beta/agent-data/{item_id}
Update Agent Data
update_agent_data_api_v1_beta_agent_data__item_id__put 4 params body → 200422
DELETE
/api/v1/beta/agent-data/{item_id}
Delete Agent Data
delete_agent_data_api_v1_beta_agent_data__item_id__delete 4 params → 200422
POST
/api/v1/beta/agent-data
Create Agent Data
create_agent_data_api_v1_beta_agent_data_post 3 params body → 200422
POST
/api/v1/beta/agent-data/:search
Search Agent Data
search_agent_data_api_v1_beta_agent_data__search_post 3 params body → 200422
POST
/api/v1/beta/agent-data/:aggregate
Aggregate Agent Data
aggregate_agent_data_api_v1_beta_agent_data__aggregate_post 3 params body → 200422
POST
/api/v1/beta/agent-data/:delete
Delete Agent Data By Query
delete_agent_data_by_query_api_v1_beta_agent_data__delete_post 3 params body → 200422
GET
/api/v1/beta/files
List Files
list_files_api_v1_beta_files_get 10 params → 200422
POST
/api/v1/beta/files
Upload File
upload_file_api_v1_beta_files_post 3 params body → 201422
POST
/api/v1/beta/files/querydeprecated
Query Files
query_files_api_v1_beta_files_query_post 3 params body → 200422
GET
/api/v1/beta/files/{file_id}
Get File
get_file_api_v1_beta_files__file_id__get 5 params → 200422
DELETE
/api/v1/beta/files/{file_id}
Delete File
delete_file_api_v1_beta_files__file_id__delete 4 params → 204422
GET
/api/v1/beta/files/{file_id}/content
Read File Content
read_file_content_api_v1_beta_files__file_id__content_get 5 params → 200422
POST
/api/v1/beta/sheets/jobs
Create Spreadsheet Job
create_spreadsheet_job_api_v1_beta_sheets_jobs_post 3 params body → 200422
GET
/api/v1/beta/sheets/jobs
List Spreadsheet Jobs
list_spreadsheet_jobs_api_v1_beta_sheets_jobs_get 11 params → 200422
GET
/api/v1/beta/sheets/jobs/{spreadsheet_job_id}
Get Spreadsheet Job
get_spreadsheet_job_api_v1_beta_sheets_jobs__spreadsheet_job_id__get 6 params → 200422
DELETE
/api/v1/beta/sheets/jobs/{spreadsheet_job_id}
Delete Spreadsheet Job
delete_spreadsheet_job_api_v1_beta_sheets_jobs__spreadsheet_job_id__delete 4 params → 200422
GET
/api/v1/beta/sheets/jobs/{spreadsheet_job_id}/regions/{region_id}/result/{region_type}
Get Result Region
get_result_region_api_v1_beta_sheets_jobs__spreadsheet_job_id__regions__region_id__result__region_type__get 7 params → 200422
POST
/api/v1/beta/directories
Create Directory
create_directory_api_v1_beta_directories_post 3 params body → 201422
GET
/api/v1/beta/directories
List Directories
list_directories_api_v1_beta_directories_get 8 params → 200422
GET
/api/v1/beta/directories/{directory_id}
Get Directory
get_directory_api_v1_beta_directories__directory_id__get 4 params → 200422
PATCH
/api/v1/beta/directories/{directory_id}
Update Directory
update_directory_api_v1_beta_directories__directory_id__patch 4 params body → 200422
DELETE
/api/v1/beta/directories/{directory_id}
Delete Directory
delete_directory_api_v1_beta_directories__directory_id__delete 4 params → 204422
POST
/api/v1/beta/directories/{directory_id}/files
Add Directory File
add_directory_file_api_v1_beta_directories__directory_id__files_post 4 params body → 201422
GET
/api/v1/beta/directories/{directory_id}/files
List Directory Files
list_directory_files_api_v1_beta_directories__directory_id__files_get 14 params body → 200422
POST
/api/v1/beta/directories/{directory_id}/files/upload
Upload File To Directory
upload_file_to_directory_api_v1_beta_directories__directory_id__files_upload_post 4 params body → 201422
GET
/api/v1/beta/directories/{directory_id}/files/{directory_file_id}
Get Directory File
get_directory_file_api_v1_beta_directories__directory_id__files__directory_file_id__get 6 params → 200422
PATCH
/api/v1/beta/directories/{directory_id}/files/{directory_file_id}
Update Directory File
update_directory_file_api_v1_beta_directories__directory_id__files__directory_file_id__patch 5 params body → 200422
DELETE
/api/v1/beta/directories/{directory_id}/files/{directory_file_id}
Delete Directory File
delete_directory_file_api_v1_beta_directories__directory_id__files__directory_file_id__delete 5 params → 204422
POST
/api/v1/beta/directories/{directory_id}/files/bulk-delete
Bulk Delete Directory Files
bulk_delete_directory_files_api_v1_beta_directories__directory_id__files_bulk_delete_post 4 params body → 204422
POST
/api/v1/beta/configurations
Create Configuration
create_configuration_api_v1_beta_configurations_post 3 params body → 201422
GET
/api/v1/beta/configurations
List Configurations
list_configurations_api_v1_beta_configurations_get 8 params → 200422
GET
/api/v1/beta/configurations/{config_id}
Get Configuration
get_configuration_api_v1_beta_configurations__config_id__get 4 params → 200422
PUT
/api/v1/beta/configurations/{config_id}
Update Configuration
update_configuration_api_v1_beta_configurations__config_id__put 4 params body → 200422
DELETE
/api/v1/beta/configurations/{config_id}
Delete Configuration
delete_configuration_api_v1_beta_configurations__config_id__delete 4 params → 204422
POST
/api/v1/beta/split/jobs
Create Split Job
create_split_job_api_v1_beta_split_jobs_post 3 params body → 201422
GET
/api/v1/beta/split/jobs
List Split Jobs
list_split_jobs_api_v1_beta_split_jobs_get 9 params → 200422
GET
/api/v1/beta/split/jobs/{split_job_id}
Get Split Job
get_split_job_api_v1_beta_split_jobs__split_job_id__get 4 params → 200422
POST
/api/v1/beta/batch-processing
Create Batch Job
create_batch_job_api_v1_beta_batch_processing_post 4 params body → 201422
GET
/api/v1/beta/batch-processing
List Batch Jobs
list_batch_jobs_api_v1_beta_batch_processing_get 8 params → 200422
GET
/api/v1/beta/batch-processing/{job_id}
Get Batch Job Status
get_batch_job_status_api_v1_beta_batch_processing__job_id__get 4 params → 200422
GET
/api/v1/beta/batch-processing/{job_id}/items
List Batch Job Items
list_batch_job_items_api_v1_beta_batch_processing__job_id__items_get 7 params → 200422
POST
/api/v1/beta/batch-processing/{job_id}/cancel
Cancel Batch Job
cancel_batch_job_api_v1_beta_batch_processing__job_id__cancel_post 5 params body → 200422
GET
/api/v1/beta/batch-processing/items/{item_id}/processing-results
Get Item Processing Results
get_item_processing_results_api_v1_beta_batch_processing_items__item_id__processing_results_get 5 params → 200422
GET
/api/v1/beta/pipelines/{pipeline_id}/files
List Pipeline Files
list_pipeline_files_api_v1_beta_pipelines__pipeline_id__files_get 9 params → 200422

Schemas 126

The contract defines 126 schemas that model the data the API accepts and returns. The most detailed are BatchParseJobConfig (125 properties), AutoModeConfigurationEntry (36 properties), BatchJobResponse (17 properties), PipelineFileResponse (17 properties). Each schema is shown below with its type and property counts.

BatchJobStatus
string
Status of a batch processing job.
SplitCategory
object
Category definition for document splitting.
2 properties 1 required
FileFilter
object
Filter parameters for file queries.
6 properties
UntypedParameters
object
Catch-all for configurations without a dedicated typed schema. Accepts arbitrary JSON fields alongside producttype.
1 property 1 required
SplitConfiguration
object
Split configuration with categories and splitting strategy.
2 properties 1 required
DirectoryFileQueryResponse
object
API query response schema for directory files.
3 properties 1 required
LlamaParseOutputOptions
object
Output formatting and content extraction options. Controls how parsed content is formatted and what additional data is extracted.
7 properties
BatchJobQueryResponse
object
Response schema for paginated batch job queries.
3 properties 1 required
PaginatedResponse_AgentData_
object
3 properties 1 required
AggregateRequest
object
API request body for aggregating agent data
10 properties 1 required
DirectoryFileCreateRequest
object
API request schema for creating a directory file.
4 properties 1 required
FileClassification
object
A file classification.
6 properties 2 required
LlamaParseSpatialTextOptions
object
Spatial text output options for preserving document layout. Spatial text maintains the visual positioning of text elements, useful for documents where layout c…
3 properties
FileQueryRequest
object
Request schema for querying files with pagination and filtering.
4 properties
BatchJobResponse
object
Response schema for a batch processing job.
17 properties 5 required
SpreadsheetResultType
string
BatchJobCreateRequest
object
Request to create a batch processing job. Supports two modes: 1. Directory mode: Process all files in a directory (use directoryid) 2. Item list mode: Process…
5 properties 1 required
DirectoryResponse
object
API response schema for a directory.
10 properties 3 required
StatusEnum
string
Enum for representing the status of a job
ExtractedRegionSummary
object
A summary of a single extracted region from a spreadsheet
6 properties 3 required
SplitStrategy
object
Configuration for how to split the document.
1 property
File
object
Schema for a file.
14 properties 3 required
LlamaParsePdfOptions
object
ClassifyMode
string
Supported classification execution modes.
AgentDataUpdate
object
API request model for updating agent data
1 property 1 required
ItemProcessingResultsResponse
object
Response containing all processing results for an item.
3 properties 2 required
ConfigurationUpdateRequest
object
Request body for updating a product configuration.
2 properties
ProcessingResultMetadata
object
Metadata about processing output. Currently empty - will be populated with job-type-specific metadata fields in the future.
LlamaParsePresentationOptions
object
Presentation (PowerPoint, Keynote, ODP) parsing options.
2 properties
MetadataScalarValue
SearchRequest
object
API request body for searching agent data
8 properties 1 required
ProcessingResult
object
A processing result with lineage information.
8 properties 7 required
SplitJobQueryResponse
object
Beta paginated list of split jobs.
3 properties 1 required
BatchJobCancelRequest
object
Request to cancel a running batch job.
1 property
LlamaParsePageRanges
object
Page selection options for processing specific pages or limiting page count.
2 properties
AgentDataCreate
object
API request model for creating agent data
3 properties 2 required
MetadataListValue
array
LlamaParseWebhookConfiguration
object
Webhook configuration for receiving parsing job notifications. Webhooks are called when specified events occur during job processing. Configure multiple webhoo…
4 properties
SpreadsheetJobParameters
object
Job-time parameters returned on a spreadsheet job response.
1 property
ExtractV2Parameters
object
Typed parameters for an extract v2 product configuration.
12 properties 2 required
LlamaParseTables
object
Table formatting options for markdown output.
4 properties
DirectoryQueryResponse
object
API query response schema for directories.
3 properties 1 required
ParsingMode
string
Enum for representing the mode of parsing to be used.
LlamaParseHtmlOptions
object
HTML/web page parsing options.
3 properties
ClassifyV2Rule
object
A rule for classifying documents.
2 properties 2 required
ClassifyV2ParsingConfiguration
object
Parsing configuration for classify jobs.
3 properties
ClassifyParsingConfiguration
object
Parsing configuration for a classify job.
3 properties
LlamaParseInputOptions
object
Input format-specific parsing options. These options only apply when parsing documents of the corresponding format. LlamaParse automatically detects the input…
4 properties
BatchParseJobConfig
object
Generic parse job configuration for batch processing. This model contains the parsing configuration that applies to all files in a batch, but excludes file-spe…
125 properties
DirectoryFileUpdateRequest
object
API request schema for updating a directory file.
4 properties
PartitionNames
string
Enum for dataset partition names.
WebhookConfiguration
object
Configuration for a single outbound webhook endpoint.
4 properties
DirectoryFileResponse
object
API response schema for a directory file.
11 properties 5 required
DirectoryCreateRequest
object
API request schema for creating a directory.
5 properties 1 required
ParserLanguages
string
Enum for representing the languages supported by the parser.
LlamaParseOcrParameters
object
OCR (Optical Character Recognition) configuration parameters.
1 property
FileQueryResponseV2
object
Paginated list of files.
3 properties 1 required
ParseV2Parameters
object
Configuration for LlamaParse v2 document parsing. Includes tier selection, processing options, output formatting, page targeting, and webhook delivery. Refer t…
14 properties 3 required
AutoModeCropBox
object
Crop box options for auto mode parsing configuration.
4 properties
SpreadsheetJobCreate
object
Request to create a spreadsheet parsing job. Provide at most one of configuration (inline) or configurationid (saved preset). If neither is provided, a default…
5 properties 1 required
BatchFileStatus
string
Status of an individual file in a batch job.
ClassifyJob
object
A classify job.
12 properties 5 required
LlamaParseIgnoreOptions
object
Options for ignoring specific types of text during extraction.
3 properties
SpreadsheetV1Parameters
object
Typed parameters for a spreadsheet v1 product configuration.
9 properties 1 required
PresignedUrl
object
Schema for a presigned URL.
3 properties 2 required
AutoModeConfigurationEntry
object
A single auto mode rule with trigger conditions and parsing configuration. Auto mode allows conditional parsing where different configurations are applied base…
36 properties 1 required
UsageMetric
object
API boundary representation of a usage metric.
11 properties 9 required
PipelineFileResponse
object
Beta API response schema for a pipeline file.
17 properties 2 required
PaginatedResponse_ClassifyJob_
object
3 properties 1 required
ClassificationResult
object
Result of classifying a single file.
3 properties 3 required
ClassifyJobCreate
object
A classify job.
5 properties 2 required
DeleteRequest
object
API request body for bulk deleting agent data by query
3 properties 1 required
PaginatedResponse_SpreadsheetJob_
object
3 properties 1 required
DirectoryFileBulkDeleteRequest
object
API request schema for bulk deleting directory files.
1 property 1 required
MetadataDict
object
SplitSegmentResponse
object
A segment of the split document.
3 properties 3 required
AutoModeIgnoreOptions
object
Ignore options for auto mode parsing configuration.
2 properties
LlamaParseCropBox
object
Crop box boundaries for processing only a portion of each page. All values are ratios from 0 to 1, where (0,0) is the top-left corner and (1,1) is the bottom-r…
4 properties
LlamaParseCostOptimizerParameters
object
Cost optimizer configuration for reducing parsing costs on simpler pages. When enabled, the parser analyzes each page and routes simpler pages to faster, cheap…
1 property
SplitDocumentInput
object
Document input specification for beta API.
2 properties 2 required
BatchItemListResponse
object
Paginated response containing batch job item details.
3 properties
LlamaParseAgenticOptions
object
Options for AI-powered parsing tiers (costeffective, agentic, agenticplus). These options customize how the AI processes and interprets document content. Only…
1 property
LlamaParseTablesAsSpreadsheetOptions
object
Options for exporting extracted tables as XLSX spreadsheet files.
2 properties
DeleteResponse
object
API response for bulk delete operation
1 property 1 required
HTTPValidationError
object
1 property
Body_upload_file_api_v1_beta_files_post
object
3 properties 2 required
LlamaParseSpreadsheetOptions
object
Spreadsheet (Excel, CSV, ODS) parsing options.
3 properties
ConfigurationQueryResponse
object
Paginated list of product configurations.
3 properties 1 required
ConfigurationCreateRequest
object
Request body for creating a product configuration.
2 properties 2 required
AgentData
object
API Result for a single agent data item
7 properties 2 required
SplitJobResponse
object
Beta response — uses nested documentinput object.
11 properties 6 required
FailPageMode
string
Enum for representing the different available page error handling modes.
ConfigurationResponse
object
Response schema for a single product configuration.
7 properties 5 required
UsageMetricQueryResponse
object
Paginated response containing usage metrics.
3 properties 1 required
LlamaParseTimeouts
object
Job timeout configuration. Total timeout = baseinseconds + (extratimeperpageinseconds × pagecount). Use these settings for large documents or complex parsing t…
2 properties
FilterOperation
object
API request model for a filter comparison operation.
8 properties
AutoModePresentationOptions
object
Presentation-specific options for auto mode parsing configuration.
2 properties
BatchItemDetail
object
Detailed information about an item in a batch job.
10 properties 3 required
BatchJobCancelResponse
object
Response after cancelling a batch job.
4 properties 4 required
FileV2
object
An uploaded file.
9 properties 3 required
SplitV1Parameters
object
Typed parameters for a split v1 product configuration.
3 properties 2 required
AggregateGroup
object
API Result for a single group in the aggregate response
3 properties 1 required
PipelineFileListResponse
object
Beta API query response schema for pipeline files.
3 properties 1 required
LlamaParseProcessingOptions
object
Processing options shared across all parsing tiers. These options control how documents are analyzed and processed regardless of the selected tier. Some option…
7 properties
Body_upload_file_to_directory_api_v1_beta_directories__directory_id__files_upload_post
object
5 properties 1 required
SpreadsheetJob
object
A spreadsheet parsing job.
17 properties 8 required
ClassifyJobResults
object
Response model for the classify endpoint following AIP-132 pagination standard.
3 properties 1 required
SplitCreateRequest
object
Beta create request — accepts legacy documentinput and flat formats.
3 properties 1 required
BatchJobStatusResponse
object
Detailed status response for a batch processing job.
2 properties 2 required
MetadataValue
AutoModeParsingConf
object
Parsing configuration applied when auto mode triggers match. These settings override the base configuration for pages where trigger conditions are satisfied. O…
14 properties
ClassifyV2Parameters
object
Typed parameters for a classify v2 product configuration.
4 properties 2 required
WorksheetMetadata
object
Metadata about a worksheet in a spreadsheet
3 properties 1 required
LlamaParseFastOptions
object
Options for fast tier parsing (rule-based, no AI). Fast tier uses deterministic algorithms for text extraction without AI enhancement. It's the fastest and mos…
LlamaParseJobFailureConditions
object
Conditions that determine when a parsing job should fail vs complete with partial results. By default, jobs complete successfully even if some pages fail to pa…
5 properties
DirectoryUpdateRequest
object
API request schema for updating a directory.
2 properties
SpreadsheetParsingConfig
object
Configuration for spreadsheet parsing and region extraction
8 properties
ClassifierRule
object
A rule for classifying documents - v0 simplified version. This represents a single classification rule that will be applied to documents. All rules are content…
2 properties 2 required
LlamaParseProcessingControl
object
Job processing controls for timeouts and failure handling.
2 properties
BatchJobType
string
Type of batch processing operation.
PaginatedResponse_AggregateGroup_
object
3 properties 1 required
LlamaParseMarkdownOptions
object
Markdown output formatting options.
3 properties
BatchParseJobRecordCreate
object
Batch-specific parse job record for batch processing. This model contains the metadata and configuration for a batch parse job, but excludes file-specific info…
9 properties
ValidationError
object
5 properties 3 required
AutoModeSpatialTextOptions
object
Spatial text options for auto mode parsing configuration.
3 properties
SplitResultResponse
object
Result of a completed split job.
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

llamaparse-beta-api-openapi.yml Raw ↑

Other APIs LlamaParse publishes across the network.

LlamaParse Extract API
LlamaParse Classify API
LlamaCloud Index API
LlamaParse Agent Data API
LlamaParse Batch Processing API
LlamaParse Batches API
LlamaParse Chat API
LlamaParse Classifier API
LlamaParse Classify API
LlamaParse Configurations API
LlamaParse Data Sinks API
LlamaParse Data Sources API
Where this information came from

This is an independent, third-party profile of LlamaParse Beta API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.