feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 130
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/llamaindex-Georgehe4%2Fllamacloud-prod-bf5051d1ff1d78eef89a5732bc9186c01a4a9f7a2901045e3869b07c72695f73.yml
-openapi_spec_hash: 4b033b10a94f936ebaedec2856a6e559
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/llamaindex-Georgehe4%2Fllamacloud-prod-7b3ac5ad247b2932e3e116a3a1ae98b35abc648c96142ce3a856c18350a36367.yml
+openapi_spec_hash: 74aa07318c168bf21763224e4d1cb5c3
 config_hash: f1f01aeb558cfa6af9d40d8771514b2d

src/llama_cloud/resources/beta/split.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Union, Iterable, Optional
+from typing import Union, Optional
 from datetime import datetime
 from typing_extensions import Literal
 
@@ -29,7 +29,6 @@
 from ..._base_client import AsyncPaginator, make_request_options
 from ...types.beta.split_get_response import SplitGetResponse
 from ...types.beta.split_list_response import SplitListResponse
-from ...types.beta.split_category_param import SplitCategoryParam
 from ...types.beta.split_create_response import SplitCreateResponse
 from ...types.beta.split_document_input_param import SplitDocumentInputParam
 
@@ -59,11 +58,11 @@ def with_streaming_response(self) -> SplitResourceWithStreamingResponse:
     def create(
         self,
         *,
-        categories: Iterable[SplitCategoryParam],
         document_input: SplitDocumentInputParam,
         organization_id: Optional[str] | Omit = omit,
         project_id: Optional[str] | Omit = omit,
-        splitting_strategy: split_create_params.SplittingStrategy | Omit = omit,
+        configuration: Optional[split_create_params.Configuration] | Omit = omit,
+        configuration_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -77,11 +76,11 @@ def create(
         production use and is subject to change at any time.
 
         Args:
-          categories: Categories to split documents into.
-
           document_input: Document to be split.
 
-          splitting_strategy: Strategy for splitting documents.
+          configuration: Split configuration with categories and splitting strategy.
+
+          configuration_id: Saved split configuration ID.
 
           extra_headers: Send extra headers
 
@@ -95,9 +94,9 @@ def create(
             "/api/v1/beta/split/jobs",
             body=maybe_transform(
                 {
-                    "categories": categories,
                     "document_input": document_input,
-                    "splitting_strategy": splitting_strategy,
+                    "configuration": configuration,
+                    "configuration_id": configuration_id,
                 },
                 split_create_params.SplitCreateParams,
             ),
@@ -487,11 +486,11 @@ def with_streaming_response(self) -> AsyncSplitResourceWithStreamingResponse:
     async def create(
         self,
         *,
-        categories: Iterable[SplitCategoryParam],
         document_input: SplitDocumentInputParam,
         organization_id: Optional[str] | Omit = omit,
         project_id: Optional[str] | Omit = omit,
-        splitting_strategy: split_create_params.SplittingStrategy | Omit = omit,
+        configuration: Optional[split_create_params.Configuration] | Omit = omit,
+        configuration_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -505,11 +504,11 @@ async def create(
         production use and is subject to change at any time.
 
         Args:
-          categories: Categories to split documents into.
-
           document_input: Document to be split.
 
-          splitting_strategy: Strategy for splitting documents.
+          configuration: Split configuration with categories and splitting strategy.
+
+          configuration_id: Saved split configuration ID.
 
           extra_headers: Send extra headers
 
@@ -523,9 +522,9 @@ async def create(
             "/api/v1/beta/split/jobs",
             body=await async_maybe_transform(
                 {
-                    "categories": categories,
                     "document_input": document_input,
-                    "splitting_strategy": splitting_strategy,
+                    "configuration": configuration,
+                    "configuration_id": configuration_id,
                 },
                 split_create_params.SplitCreateParams,
             ),

src/llama_cloud/resources/extract.py

@@ -152,6 +152,7 @@ def list(
         created_at_on_or_before: Union[str, datetime, None] | Omit = omit,
         document_input_type: Optional[str] | Omit = omit,
         document_input_value: Optional[str] | Omit = omit,
+        expand: SequenceNotStr[str] | Omit = omit,
         job_ids: Optional[SequenceNotStr[str]] | Omit = omit,
         organization_id: Optional[str] | Omit = omit,
         page_size: Optional[int] | Omit = omit,
@@ -169,7 +170,9 @@ def list(
         List extraction jobs with optional filtering and pagination.
 
         Filter by `configuration_id`, `status`, `document_input_value`, or creation date
-        range. Results are returned newest-first.
+        range. Results are returned newest-first. Use `expand=configuration` to include
+        the full configuration used, and `expand=extract_metadata` for usage metrics and
+        per-field metadata.
 
         Args:
           configuration_id: Filter by configuration ID
@@ -182,6 +185,8 @@ def list(
 
           document_input_value: Filter by document input value
 
+          expand: Additional fields to include: configuration, extract_metadata
+
           job_ids: Filter by specific job IDs
 
           page_size: Number of items per page
@@ -213,6 +218,7 @@ def list(
                         "created_at_on_or_before": created_at_on_or_before,
                         "document_input_type": document_input_type,
                         "document_input_value": document_input_value,
+                        "expand": expand,
                         "job_ids": job_ids,
                         "organization_id": organization_id,
                         "page_size": page_size,
@@ -352,12 +358,12 @@ def get(
         """
         Get a single extraction job by ID.
 
-        Returns the job status, configuration, and results when complete. Use
-        `expand=extract_metadata` to include usage metrics and per-field metadata
-        (citations, confidence scores).
+        Returns the job status and results when complete. Use `expand=configuration` to
+        include the full configuration used, and `expand=extract_metadata` for usage
+        metrics and per-field metadata.
 
         Args:
-          expand: Additional fields to include: extract_metadata
+          expand: Additional fields to include: configuration, extract_metadata
 
           extra_headers: Send extra headers
 
@@ -739,6 +745,7 @@ def list(
         created_at_on_or_before: Union[str, datetime, None] | Omit = omit,
         document_input_type: Optional[str] | Omit = omit,
         document_input_value: Optional[str] | Omit = omit,
+        expand: SequenceNotStr[str] | Omit = omit,
         job_ids: Optional[SequenceNotStr[str]] | Omit = omit,
         organization_id: Optional[str] | Omit = omit,
         page_size: Optional[int] | Omit = omit,
@@ -756,7 +763,9 @@ def list(
         List extraction jobs with optional filtering and pagination.
 
         Filter by `configuration_id`, `status`, `document_input_value`, or creation date
-        range. Results are returned newest-first.
+        range. Results are returned newest-first. Use `expand=configuration` to include
+        the full configuration used, and `expand=extract_metadata` for usage metrics and
+        per-field metadata.
 
         Args:
           configuration_id: Filter by configuration ID
@@ -769,6 +778,8 @@ def list(
 
           document_input_value: Filter by document input value
 
+          expand: Additional fields to include: configuration, extract_metadata
+
           job_ids: Filter by specific job IDs
 
           page_size: Number of items per page
@@ -800,6 +811,7 @@ def list(
                         "created_at_on_or_before": created_at_on_or_before,
                         "document_input_type": document_input_type,
                         "document_input_value": document_input_value,
+                        "expand": expand,
                         "job_ids": job_ids,
                         "organization_id": organization_id,
                         "page_size": page_size,
@@ -939,12 +951,12 @@ async def get(
         """
         Get a single extraction job by ID.
 
-        Returns the job status, configuration, and results when complete. Use
-        `expand=extract_metadata` to include usage metrics and per-field metadata
-        (citations, confidence scores).
+        Returns the job status and results when complete. Use `expand=configuration` to
+        include the full configuration used, and `expand=extract_metadata` for usage
+        metrics and per-field metadata.
 
         Args:
-          expand: Additional fields to include: extract_metadata
+          expand: Additional fields to include: configuration, extract_metadata
 
           extra_headers: Send extra headers
 

src/llama_cloud/resources/parsing.py

@@ -87,6 +87,7 @@ def create(
                 "2026-03-22",
                 "2026-03-23",
                 "2026-03-24",
+                "2026-03-25",
                 "latest",
             ],
             str,
@@ -782,6 +783,7 @@ async def create(
                 "2026-03-22",
                 "2026-03-23",
                 "2026-03-24",
+                "2026-03-25",
                 "latest",
             ],
             str,

src/llama_cloud/types/beta/split_create_params.py

@@ -8,25 +8,25 @@
 from .split_category_param import SplitCategoryParam
 from .split_document_input_param import SplitDocumentInputParam
 
-__all__ = ["SplitCreateParams", "SplittingStrategy"]
+__all__ = ["SplitCreateParams", "Configuration", "ConfigurationSplittingStrategy"]
 
 
 class SplitCreateParams(TypedDict, total=False):
-    categories: Required[Iterable[SplitCategoryParam]]
-    """Categories to split documents into."""
-
     document_input: Required[SplitDocumentInputParam]
     """Document to be split."""
 
     organization_id: Optional[str]
 
     project_id: Optional[str]
 
-    splitting_strategy: SplittingStrategy
-    """Strategy for splitting documents."""
+    configuration: Optional[Configuration]
+    """Split configuration with categories and splitting strategy."""
+
+    configuration_id: Optional[str]
+    """Saved split configuration ID."""
 
 
-class SplittingStrategy(TypedDict, total=False):
+class ConfigurationSplittingStrategy(TypedDict, total=False):
     """Strategy for splitting documents."""
 
     allow_uncategorized: Literal["include", "forbid", "omit"]
@@ -36,3 +36,13 @@ class SplittingStrategy(TypedDict, total=False):
     'forbid': all pages must be assigned to a defined category. 'omit': pages can be
     classified as 'uncategorized' but are excluded from results.
     """
+
+
+class Configuration(TypedDict, total=False):
+    """Split configuration with categories and splitting strategy."""
+
+    categories: Required[Iterable[SplitCategoryParam]]
+    """Categories to split documents into."""
+
+    splitting_strategy: ConfigurationSplittingStrategy
+    """Strategy for splitting documents."""

src/llama_cloud/types/beta/split_create_response.py

@@ -35,6 +35,9 @@ class SplitCreateResponse(BaseModel):
     user_id: str
     """User ID who created this job."""
 
+    configuration_id: Optional[str] = None
+    """Split configuration ID used for this job."""
+
     created_at: Optional[datetime] = None
     """Creation datetime"""
 

src/llama_cloud/types/beta/split_get_response.py

@@ -35,6 +35,9 @@ class SplitGetResponse(BaseModel):
     user_id: str
     """User ID who created this job."""
 
+    configuration_id: Optional[str] = None
+    """Split configuration ID used for this job."""
+
     created_at: Optional[datetime] = None
     """Creation datetime"""
 

src/llama_cloud/types/beta/split_list_response.py

@@ -35,6 +35,9 @@ class SplitListResponse(BaseModel):
     user_id: str
     """User ID who created this job."""
 
+    configuration_id: Optional[str] = None
+    """Split configuration ID used for this job."""
+
     created_at: Optional[datetime] = None
     """Creation datetime"""
 

src/llama_cloud/types/extract_generate_schema_response.py

@@ -618,6 +618,7 @@ class ParametersParseV2ParametersProcessingOptionsAutoModeConfigurationParsingCo
             "2026-03-22",
             "2026-03-23",
             "2026-03-24",
+            "2026-03-25",
             "latest",
         ],
         str,
@@ -920,6 +921,7 @@ class ParametersParseV2Parameters(BaseModel):
             "2026-03-22",
             "2026-03-23",
             "2026-03-24",
+            "2026-03-25",
             "latest",
         ],
         str,

src/llama_cloud/types/extract_get_params.py

@@ -12,7 +12,7 @@
 
 class ExtractGetParams(TypedDict, total=False):
     expand: SequenceNotStr[str]
-    """Additional fields to include: extract_metadata"""
+    """Additional fields to include: configuration, extract_metadata"""
 
     organization_id: Optional[str]