chunkr-ai 0.1.0a4__tar.gz → 0.1.0a6__tar.gz

{chunkr_ai-0.1.0a4 → chunkr_ai-0.1.0a6}/.gitignore

@@ -13,5 +13,3 @@ dist
 .envrc
 codegen.log
 Brewfile.lock.json
-
-.lh

chunkr_ai-0.1.0a6/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0-alpha.6"
+}

{chunkr_ai-0.1.0a4 → chunkr_ai-0.1.0a6}/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 0.1.0-alpha.6 (2025-08-12)
+
+Full Changelog: [v0.1.0-alpha.5...v0.1.0-alpha.6](https://github.com/lumina-ai-inc/chunkr-python/compare/v0.1.0-alpha.5...v0.1.0-alpha.6)
+
+### Features
+
+* **api:** api update ([5be70ea](https://github.com/lumina-ai-inc/chunkr-python/commit/5be70ea879606227d056d3dfc9b7b67add2871cd))
+
+
+### Chores
+
+* **internal:** codegen related update ([ba667c4](https://github.com/lumina-ai-inc/chunkr-python/commit/ba667c468ec6af4fb059196e6cf9b7da8ad0b524))
+
+## 0.1.0-alpha.5 (2025-08-12)
+
+Full Changelog: [v0.1.0-alpha.4...v0.1.0-alpha.5](https://github.com/lumina-ai-inc/chunkr-python/compare/v0.1.0-alpha.4...v0.1.0-alpha.5)
+
+### Features
+
+* **api:** added default timeouts ([d8fe4d0](https://github.com/lumina-ai-inc/chunkr-python/commit/d8fe4d089ea7024e90ab01941d7eeb616d0e7034))
+* **api:** api update ([c925f82](https://github.com/lumina-ai-inc/chunkr-python/commit/c925f825bd9071616aeb45fc7c0853acbfb14797))
+* **api:** manual updates ([6ac936b](https://github.com/lumina-ai-inc/chunkr-python/commit/6ac936b3ed6623edf21a9a6e7fc1e721398f35ab))
+* **api:** manual updates ([5af3de5](https://github.com/lumina-ai-inc/chunkr-python/commit/5af3de5c2758931d7ac68e66c09cb2fe7f82f626))
+* **api:** manual updates ([e768758](https://github.com/lumina-ai-inc/chunkr-python/commit/e768758ce2e2c9fc894be36f1ca08144c48e878e))
+* **api:** manual updates ([a2ea967](https://github.com/lumina-ai-inc/chunkr-python/commit/a2ea967860af97eaead44ab74f8fb0b54577f3a9))
+
 ## 0.1.0-alpha.4 (2025-08-09)
 
 Full Changelog: [v0.1.0-alpha.3...v0.1.0-alpha.4](https://github.com/lumina-ai-inc/chunkr-python/compare/v0.1.0-alpha.3...v0.1.0-alpha.4)

{chunkr_ai-0.1.0a4 → chunkr_ai-0.1.0a6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: chunkr-ai
-Version: 0.1.0a4
+Version: 0.1.0a6
 Summary: The official Python library for the chunkr API
 Project-URL: Homepage, https://github.com/lumina-ai-inc/chunkr-python
 Project-URL: Repository, https://github.com/lumina-ai-inc/chunkr-python
@@ -299,7 +299,7 @@ Error codes are as follows:
 
 ### Retries
 
-Certain errors are automatically retried 2 times by default, with a short exponential backoff.
+Certain errors are automatically retried 50 times by default, with a short exponential backoff.
 Connection errors (for example, due to a network connectivity problem), 408 Request Timeout, 409 Conflict,
 429 Rate Limit, and >=500 Internal errors are all retried by default.
 
@@ -322,7 +322,7 @@ client.with_options(max_retries=5).tasks.parse.create(
 
 ### Timeouts
 
-By default requests time out after 1 minute. You can configure this with a `timeout` option,
+By default requests time out after 30 seconds. You can configure this with a `timeout` option,
 which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/timeouts/#fine-tuning-the-configuration) object:
 
 ```python
@@ -330,7 +330,7 @@ from chunkr_ai import Chunkr
 
 # Configure the default for all requests:
 client = Chunkr(
-    # 20 seconds (default is 1 minute)
+    # 20 seconds (default is 30 seconds)
     timeout=20.0,
 )
 

{chunkr_ai-0.1.0a4 → chunkr_ai-0.1.0a6}/README.md

@@ -264,7 +264,7 @@ Error codes are as follows:
 
 ### Retries
 
-Certain errors are automatically retried 2 times by default, with a short exponential backoff.
+Certain errors are automatically retried 50 times by default, with a short exponential backoff.
 Connection errors (for example, due to a network connectivity problem), 408 Request Timeout, 409 Conflict,
 429 Rate Limit, and >=500 Internal errors are all retried by default.
 
@@ -287,7 +287,7 @@ client.with_options(max_retries=5).tasks.parse.create(
 
 ### Timeouts
 
-By default requests time out after 1 minute. You can configure this with a `timeout` option,
+By default requests time out after 30 seconds. You can configure this with a `timeout` option,
 which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/timeouts/#fine-tuning-the-configuration) object:
 
 ```python
@@ -295,7 +295,7 @@ from chunkr_ai import Chunkr
 
 # Configure the default for all requests:
 client = Chunkr(
-    # 20 seconds (default is 1 minute)
+    # 20 seconds (default is 30 seconds)
     timeout=20.0,
 )
 

{chunkr_ai-0.1.0a4 → chunkr_ai-0.1.0a6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "chunkr-ai"
-version = "0.1.0-alpha.4"
+version = "0.1.0-alpha.6"
 description = "The official Python library for the chunkr API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{chunkr_ai-0.1.0a4 → chunkr_ai-0.1.0a6}/src/chunkr_ai/__init__.py

@@ -72,9 +72,6 @@ __all__ = [
 ]
 
 if not _t.TYPE_CHECKING:
-    # Load custom helpers that monkey-patch generated types.
-    # This keeps custom code separate from generated files, per Stainless guidance.
-    from .lib import tasks_poll as _tasks_poll  # noqa: F401
     from ._utils._resources_proxy import resources as resources
 
 _setup_logging()

{chunkr_ai-0.1.0a4 → chunkr_ai-0.1.0a6}/src/chunkr_ai/_client.py

@@ -95,6 +95,8 @@ class Chunkr(SyncAPIClient):
             _strict_response_validation=_strict_response_validation,
         )
 
+        self._idempotency_header = "Idempotency-Key"
+
         self.tasks = tasks.TasksResource(self)
         self.files = files.FilesResource(self)
         self.health = health.HealthResource(self)
@@ -267,6 +269,8 @@ class AsyncChunkr(AsyncAPIClient):
             _strict_response_validation=_strict_response_validation,
         )
 
+        self._idempotency_header = "Idempotency-Key"
+
         self.tasks = tasks.AsyncTasksResource(self)
         self.files = files.AsyncFilesResource(self)
         self.health = health.AsyncHealthResource(self)

{chunkr_ai-0.1.0a4 → chunkr_ai-0.1.0a6}/src/chunkr_ai/_constants.py

@@ -5,10 +5,10 @@ import httpx
 RAW_RESPONSE_HEADER = "X-Stainless-Raw-Response"
 OVERRIDE_CAST_TO_HEADER = "____stainless_override_cast_to"
 
-# default timeout is 1 minute
-DEFAULT_TIMEOUT = httpx.Timeout(timeout=60, connect=5.0)
-DEFAULT_MAX_RETRIES = 2
+# default timeout is 30 seconds
+DEFAULT_TIMEOUT = httpx.Timeout(timeout=30, connect=5.0)
+DEFAULT_MAX_RETRIES = 50
 DEFAULT_CONNECTION_LIMITS = httpx.Limits(max_connections=100, max_keepalive_connections=20)
 
-INITIAL_RETRY_DELAY = 0.5
-MAX_RETRY_DELAY = 8.0
+INITIAL_RETRY_DELAY = 1.0
+MAX_RETRY_DELAY = 10.0

{chunkr_ai-0.1.0a4 → chunkr_ai-0.1.0a6}/src/chunkr_ai/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "chunkr_ai"
-__version__ = "0.1.0-alpha.4"  # x-release-please-version
+__version__ = "0.1.0-alpha.6"  # x-release-please-version

{chunkr_ai-0.1.0a4 → chunkr_ai-0.1.0a6}/src/chunkr_ai/resources/files.py

@@ -59,6 +59,7 @@ class FilesResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        idempotency_key: str | None = None,
     ) -> File:
         """
         Accepts multipart/form-data with fields:
@@ -78,6 +79,8 @@ class FilesResource(SyncAPIResource):
           extra_body: Add additional JSON properties to the request
 
           timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
         """
         body = deepcopy_minimal(
             {
@@ -95,7 +98,11 @@ class FilesResource(SyncAPIResource):
             body=maybe_transform(body, file_create_params.FileCreateParams),
             files=files,
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
             ),
             cast_to=File,
         )
@@ -170,6 +177,7 @@ class FilesResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        idempotency_key: str | None = None,
     ) -> Delete:
         """Delete file contents and scrub sensitive metadata.
 
@@ -184,13 +192,19 @@ class FilesResource(SyncAPIResource):
           extra_body: Add additional JSON properties to the request
 
           timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
         """
         if not file_id:
             raise ValueError(f"Expected a non-empty value for `file_id` but received {file_id!r}")
         return self._delete(
             f"/files/{file_id}",
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
             ),
             cast_to=Delete,
         )
@@ -353,6 +367,7 @@ class AsyncFilesResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        idempotency_key: str | None = None,
     ) -> File:
         """
         Accepts multipart/form-data with fields:
@@ -372,6 +387,8 @@ class AsyncFilesResource(AsyncAPIResource):
           extra_body: Add additional JSON properties to the request
 
           timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
         """
         body = deepcopy_minimal(
             {
@@ -389,7 +406,11 @@ class AsyncFilesResource(AsyncAPIResource):
             body=await async_maybe_transform(body, file_create_params.FileCreateParams),
             files=files,
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
             ),
             cast_to=File,
         )
@@ -464,6 +485,7 @@ class AsyncFilesResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        idempotency_key: str | None = None,
     ) -> Delete:
         """Delete file contents and scrub sensitive metadata.
 
@@ -478,13 +500,19 @@ class AsyncFilesResource(AsyncAPIResource):
           extra_body: Add additional JSON properties to the request
 
           timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
         """
         if not file_id:
             raise ValueError(f"Expected a non-empty value for `file_id` but received {file_id!r}")
         return await self._delete(
             f"/files/{file_id}",
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
             ),
             cast_to=Delete,
         )

{chunkr_ai-0.1.0a4 → chunkr_ai-0.1.0a6}/src/chunkr_ai/resources/tasks/parse.py

@@ -63,26 +63,21 @@ class ParseResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        idempotency_key: str | None = None,
     ) -> Task:
         """
-        Queues a document for processing and returns a TaskResponse containing:
+        Queues a document for processing and returns a `TaskResponse` with the assigned
+        `task_id`, initial configuration, file metadata, and timestamps. The initial
+        status is `Starting`.
 
-        - Task ID for status polling
-        - Initial configuration
-        - File metadata
-        - Processing status
-        - Creation timestamp
-        - Presigned URLs for file access
-
-        The returned task will typically be in a `Starting` or `Processing` state. Use
-        the `GET /tasks/{task_id}` endpoint to poll for completion.
+        Creates a task and returns its metadata immediately.
 
         Args:
           file:
               The file to be uploaded. Supported inputs:
 
-              - `ch://files/{file_id}`: References a previously uploaded file you own
-                (authorization enforced)
+              - `ch://files/{file_id}`: Reference to an existing file. Upload via the Files
+                API
               - `http(s)://...`: Remote URL to fetch
               - `data:*;base64,...` or raw base64 string
 
@@ -114,22 +109,29 @@ class ParseResource(SyncAPIResource):
 
           segment_processing: Defines how each segment type is handled when generating the final output.
 
-              Each segment uses one of three strategies. The chosen strategy controls: •
-              Whether the segment is kept (`Auto`, `LLM`) or skipped (`Ignore`). • How the
-              content is produced (rule-based vs. LLM). • The output format (`Html` or
-              `Markdown`).
+              Each segment uses one of three strategies. The chosen strategy controls:
+
+              - Whether the segment is kept (`Auto`, `LLM`) or skipped (`Ignore`).
+              - How the content is produced (rule-based vs. LLM).
+              - The output format (`Html` or `Markdown`).
 
               Optional flags such as image **cropping**, **extended context**, and
               **descriptions** further refine behaviour.
 
-              **Default strategy per segment** • `Title`, `SectionHeader`, `Text`, `ListItem`,
-              `Caption`, `Footnote` → **Auto** (Markdown, description off) • `Table` → **LLM**
-              (HTML, description on) • `Picture` → **LLM** (Markdown, description off,
-              cropping _All_) • `Formula`, `Page` → **LLM** (Markdown, description off) •
-              `PageHeader`, `PageFooter` → **Ignore** (removed from output)
+              **Default strategy per segment**
+
+              - `Title`, `SectionHeader`, `Text`, `ListItem`, `Caption`, `Footnote` → **Auto**
+                (Markdown, description off)
+              - `Table` → **LLM** (HTML, description on)
+              - `Picture` → **LLM** (Markdown, description off, cropping _All_)
+              - `Formula`, `Page` → **LLM** (Markdown, description off)
+              - `PageHeader`, `PageFooter` → **Ignore** (removed from output)
 
-              **Strategy reference** • **Auto** – rule-based content generation. • **LLM** –
-              generate content with an LLM. • **Ignore** – exclude the segment entirely.
+              **Strategy reference**
+
+              - **Auto** – rule-based content generation.
+              - **LLM** – generate content with an LLM.
+              - **Ignore** – exclude the segment entirely.
 
           segmentation_strategy:
               Controls the segmentation strategy:
@@ -147,6 +149,8 @@ class ParseResource(SyncAPIResource):
           extra_body: Add additional JSON properties to the request
 
           timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
         """
         return self._post(
             "/tasks/parse",
@@ -166,7 +170,11 @@ class ParseResource(SyncAPIResource):
                 parse_create_params.ParseCreateParams,
             ),
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
             ),
             cast_to=Task,
         )
@@ -190,20 +198,19 @@ class ParseResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        idempotency_key: str | None = None,
     ) -> Task:
         """Updates an existing task's configuration and reprocesses the document.
 
         The
-        original configuration will be used for all values that are not provided in the
-        update.
+        current configuration is used as the base; only provided fields are changed.
 
         Requirements:
 
-        - Task must have status `Succeeded` or `Failed`
-        - New configuration must be different from the current one
+        - Task must be in a terminal state (`Succeeded` or `Failed`).
+        - The new configuration must differ from the current configuration.
 
-        The returned task will typically be in a `Starting` or `Processing` state. Use
-        the `GET /tasks/{task_id}` endpoint to poll for completion.
+        Updates a task and returns its new metadata immediately.
 
         Args:
           chunk_processing: Controls the setting for the chunking and post-processing of each chunk.
@@ -235,22 +242,29 @@ class ParseResource(SyncAPIResource):
 
           segment_processing: Defines how each segment type is handled when generating the final output.
 
-              Each segment uses one of three strategies. The chosen strategy controls: •
-              Whether the segment is kept (`Auto`, `LLM`) or skipped (`Ignore`). • How the
-              content is produced (rule-based vs. LLM). • The output format (`Html` or
-              `Markdown`).
+              Each segment uses one of three strategies. The chosen strategy controls:
+
+              - Whether the segment is kept (`Auto`, `LLM`) or skipped (`Ignore`).
+              - How the content is produced (rule-based vs. LLM).
+              - The output format (`Html` or `Markdown`).
 
               Optional flags such as image **cropping**, **extended context**, and
               **descriptions** further refine behaviour.
 
-              **Default strategy per segment** • `Title`, `SectionHeader`, `Text`, `ListItem`,
-              `Caption`, `Footnote` → **Auto** (Markdown, description off) • `Table` → **LLM**
-              (HTML, description on) • `Picture` → **LLM** (Markdown, description off,
-              cropping _All_) • `Formula`, `Page` → **LLM** (Markdown, description off) •
-              `PageHeader`, `PageFooter` → **Ignore** (removed from output)
+              **Default strategy per segment**
+
+              - `Title`, `SectionHeader`, `Text`, `ListItem`, `Caption`, `Footnote` → **Auto**
+                (Markdown, description off)
+              - `Table` → **LLM** (HTML, description on)
+              - `Picture` → **LLM** (Markdown, description off, cropping _All_)
+              - `Formula`, `Page` → **LLM** (Markdown, description off)
+              - `PageHeader`, `PageFooter` → **Ignore** (removed from output)
 
-              **Strategy reference** • **Auto** – rule-based content generation. • **LLM** –
-              generate content with an LLM. • **Ignore** – exclude the segment entirely.
+              **Strategy reference**
+
+              - **Auto** – rule-based content generation.
+              - **LLM** – generate content with an LLM.
+              - **Ignore** – exclude the segment entirely.
 
           segmentation_strategy:
               Controls the segmentation strategy:
@@ -268,6 +282,8 @@ class ParseResource(SyncAPIResource):
           extra_body: Add additional JSON properties to the request
 
           timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
         """
         if not task_id:
             raise ValueError(f"Expected a non-empty value for `task_id` but received {task_id!r}")
@@ -288,7 +304,11 @@ class ParseResource(SyncAPIResource):
                 parse_update_params.ParseUpdateParams,
             ),
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
             ),
             cast_to=Task,
         )
@@ -333,26 +353,21 @@ class AsyncParseResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        idempotency_key: str | None = None,
     ) -> Task:
         """
-        Queues a document for processing and returns a TaskResponse containing:
+        Queues a document for processing and returns a `TaskResponse` with the assigned
+        `task_id`, initial configuration, file metadata, and timestamps. The initial
+        status is `Starting`.
 
-        - Task ID for status polling
-        - Initial configuration
-        - File metadata
-        - Processing status
-        - Creation timestamp
-        - Presigned URLs for file access
-
-        The returned task will typically be in a `Starting` or `Processing` state. Use
-        the `GET /tasks/{task_id}` endpoint to poll for completion.
+        Creates a task and returns its metadata immediately.
 
         Args:
           file:
               The file to be uploaded. Supported inputs:
 
-              - `ch://files/{file_id}`: References a previously uploaded file you own
-                (authorization enforced)
+              - `ch://files/{file_id}`: Reference to an existing file. Upload via the Files
+                API
               - `http(s)://...`: Remote URL to fetch
               - `data:*;base64,...` or raw base64 string
 
@@ -384,22 +399,29 @@ class AsyncParseResource(AsyncAPIResource):
 
           segment_processing: Defines how each segment type is handled when generating the final output.
 
-              Each segment uses one of three strategies. The chosen strategy controls: •
-              Whether the segment is kept (`Auto`, `LLM`) or skipped (`Ignore`). • How the
-              content is produced (rule-based vs. LLM). • The output format (`Html` or
-              `Markdown`).
+              Each segment uses one of three strategies. The chosen strategy controls:
+
+              - Whether the segment is kept (`Auto`, `LLM`) or skipped (`Ignore`).
+              - How the content is produced (rule-based vs. LLM).
+              - The output format (`Html` or `Markdown`).
 
               Optional flags such as image **cropping**, **extended context**, and
               **descriptions** further refine behaviour.
 
-              **Default strategy per segment** • `Title`, `SectionHeader`, `Text`, `ListItem`,
-              `Caption`, `Footnote` → **Auto** (Markdown, description off) • `Table` → **LLM**
-              (HTML, description on) • `Picture` → **LLM** (Markdown, description off,
-              cropping _All_) • `Formula`, `Page` → **LLM** (Markdown, description off) •
-              `PageHeader`, `PageFooter` → **Ignore** (removed from output)
+              **Default strategy per segment**
+
+              - `Title`, `SectionHeader`, `Text`, `ListItem`, `Caption`, `Footnote` → **Auto**
+                (Markdown, description off)
+              - `Table` → **LLM** (HTML, description on)
+              - `Picture` → **LLM** (Markdown, description off, cropping _All_)
+              - `Formula`, `Page` → **LLM** (Markdown, description off)
+              - `PageHeader`, `PageFooter` → **Ignore** (removed from output)
 
-              **Strategy reference** • **Auto** – rule-based content generation. • **LLM** –
-              generate content with an LLM. • **Ignore** – exclude the segment entirely.
+              **Strategy reference**
+
+              - **Auto** – rule-based content generation.
+              - **LLM** – generate content with an LLM.
+              - **Ignore** – exclude the segment entirely.
 
           segmentation_strategy:
               Controls the segmentation strategy:
@@ -417,6 +439,8 @@ class AsyncParseResource(AsyncAPIResource):
           extra_body: Add additional JSON properties to the request
 
           timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
         """
         return await self._post(
             "/tasks/parse",
@@ -436,7 +460,11 @@ class AsyncParseResource(AsyncAPIResource):
                 parse_create_params.ParseCreateParams,
             ),
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
             ),
             cast_to=Task,
         )
@@ -460,20 +488,19 @@ class AsyncParseResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        idempotency_key: str | None = None,
     ) -> Task:
         """Updates an existing task's configuration and reprocesses the document.
 
         The
-        original configuration will be used for all values that are not provided in the
-        update.
+        current configuration is used as the base; only provided fields are changed.
 
         Requirements:
 
-        - Task must have status `Succeeded` or `Failed`
-        - New configuration must be different from the current one
+        - Task must be in a terminal state (`Succeeded` or `Failed`).
+        - The new configuration must differ from the current configuration.
 
-        The returned task will typically be in a `Starting` or `Processing` state. Use
-        the `GET /tasks/{task_id}` endpoint to poll for completion.
+        Updates a task and returns its new metadata immediately.
 
         Args:
           chunk_processing: Controls the setting for the chunking and post-processing of each chunk.
@@ -505,22 +532,29 @@ class AsyncParseResource(AsyncAPIResource):
 
           segment_processing: Defines how each segment type is handled when generating the final output.
 
-              Each segment uses one of three strategies. The chosen strategy controls: •
-              Whether the segment is kept (`Auto`, `LLM`) or skipped (`Ignore`). • How the
-              content is produced (rule-based vs. LLM). • The output format (`Html` or
-              `Markdown`).
+              Each segment uses one of three strategies. The chosen strategy controls:
+
+              - Whether the segment is kept (`Auto`, `LLM`) or skipped (`Ignore`).
+              - How the content is produced (rule-based vs. LLM).
+              - The output format (`Html` or `Markdown`).
 
               Optional flags such as image **cropping**, **extended context**, and
               **descriptions** further refine behaviour.
 
-              **Default strategy per segment** • `Title`, `SectionHeader`, `Text`, `ListItem`,
-              `Caption`, `Footnote` → **Auto** (Markdown, description off) • `Table` → **LLM**
-              (HTML, description on) • `Picture` → **LLM** (Markdown, description off,
-              cropping _All_) • `Formula`, `Page` → **LLM** (Markdown, description off) •
-              `PageHeader`, `PageFooter` → **Ignore** (removed from output)
+              **Default strategy per segment**
+
+              - `Title`, `SectionHeader`, `Text`, `ListItem`, `Caption`, `Footnote` → **Auto**
+                (Markdown, description off)
+              - `Table` → **LLM** (HTML, description on)
+              - `Picture` → **LLM** (Markdown, description off, cropping _All_)
+              - `Formula`, `Page` → **LLM** (Markdown, description off)
+              - `PageHeader`, `PageFooter` → **Ignore** (removed from output)
 
-              **Strategy reference** • **Auto** – rule-based content generation. • **LLM** –
-              generate content with an LLM. • **Ignore** – exclude the segment entirely.
+              **Strategy reference**
+
+              - **Auto** – rule-based content generation.
+              - **LLM** – generate content with an LLM.
+              - **Ignore** – exclude the segment entirely.
 
           segmentation_strategy:
               Controls the segmentation strategy:
@@ -538,6 +572,8 @@ class AsyncParseResource(AsyncAPIResource):
           extra_body: Add additional JSON properties to the request
 
           timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
         """
         if not task_id:
             raise ValueError(f"Expected a non-empty value for `task_id` but received {task_id!r}")
@@ -558,7 +594,11 @@ class AsyncParseResource(AsyncAPIResource):
                 parse_update_params.ParseUpdateParams,
             ),
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
             ),
             cast_to=Task,
         )