release: 1.0.1 (#28)

Automated Release PR
---


## 1.0.1 (2026-06-03)

Full Changelog:
[v1.0.0...v1.0.1](v1.0.0...v1.0.1)

### Chores

* remove undocumented backwards-compat alias shims
([e5a2ad8](e5a2ad8))
* **types:** drop redundant NotRequired on task_spec input_schema
([b356c22](b356c22))


### Documentation

* regenerate api.md from spec (drop hand-maintained patch)
([05d2897](05d2897))
* regenerate README from spec (drop hand-maintained patch)
([c7ed169](c7ed169))

---
This pull request is managed by Stainless's [GitHub
App](https://github.com/apps/stainless-app).

The [semver version
number](https://semver.org/#semantic-versioning-specification-semver) is
based on included [commit
messages](https://www.conventionalcommits.org/en/v1.0.0/).
Alternatively, you can manually set the version number in the title of
this pull request.

For a better experience, it is recommended to use either rebase-merge or
squash-merge when merging this pull request.

🔗 Stainless [website](https://www.stainlessapi.com)
📚 Read the [docs](https://app.stainlessapi.com/docs)
🙋 [Reach out](mailto:support@stainlessapi.com) for help or questions

---------

Co-authored-by: Matt Harris <mharris@parallel.ai>
Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.0.0"
+  ".": "1.0.1"
 }

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 1.0.1 (2026-06-03)
+
+Full Changelog: [v1.0.0...v1.0.1](https://github.com/parallel-web/parallel-sdk-python/compare/v1.0.0...v1.0.1)
+
+### Chores
+
+* remove undocumented backwards-compat alias shims ([e5a2ad8](https://github.com/parallel-web/parallel-sdk-python/commit/e5a2ad80cdd6e4f708c3ec05c9df8b8ede79a772))
+* **types:** drop redundant NotRequired on task_spec input_schema ([b356c22](https://github.com/parallel-web/parallel-sdk-python/commit/b356c22e718ab1a95a40b6b37917a5b8bcbb091a))
+
+
+### Documentation
+
+* regenerate api.md from spec (drop hand-maintained patch) ([05d2897](https://github.com/parallel-web/parallel-sdk-python/commit/05d28970ff8b3efc77b1c4ef60beecc654a52385))
+* regenerate README from spec (drop hand-maintained patch) ([c7ed169](https://github.com/parallel-web/parallel-sdk-python/commit/c7ed169c66a60485b309147fb7aa1b6d2e551766))
+
 ## 1.0.0 (2026-06-02)
 
 Full Changelog: [v0.6.0...v1.0.0](https://github.com/parallel-web/parallel-sdk-python/compare/v0.6.0...v1.0.0)

README.md

@@ -6,14 +6,12 @@
 The Parallel Python library provides convenient access to the Parallel REST API from any Python 3.9+
 application. The library includes type definitions for all request params and response fields,
 and offers both synchronous and asynchronous clients powered by [httpx](https://github.com/encode/httpx).
-It is strongly encouraged to use the asynchronous client for best performance.
 
 It is generated with [Stainless](https://www.stainless.com/).
 
 ## Documentation
 
-The REST API documentation can be found in our [docs](https://docs.parallel.ai).
-The full API of this Python library can be found in [api.md](api.md).
+The REST API documentation can be found on [docs.parallel.ai](https://docs.parallel.ai). The full API of this library can be found in [api.md](api.md).
 
 ## Installation
 
@@ -35,23 +33,17 @@ client = Parallel(
 )
 
 task_run = client.task_run.create(
-    input="France (2023)",
-    processor="core",
+    input="What was the GDP of France in 2023?",
+    processor="base",
 )
-task_run_result = client.task_run.result(run_id=task_run.run_id)
-print(task_run_result.output)
+print(task_run.interaction_id)
 ```
 
 While you can provide an `api_key` keyword argument,
 we recommend using [python-dotenv](https://pypi.org/project/python-dotenv/)
 to add `PARALLEL_API_KEY="My API Key"` to your `.env` file
 so that your API Key is not stored in source control.
 
-The API also supports typed inputs and outputs via Pydantic objects. See the relevant
-section on [convenience methods](#convenience-methods).
-
-For information on what tasks are and how to specify them, see [our docs](https://docs.parallel.ai/task-api/core-concepts/specify-a-task).
-
 ## Async usage
 
 Simply import `AsyncParallel` instead of `Parallel` and use `await` with each API call:
@@ -67,102 +59,79 @@ client = AsyncParallel(
 
 
 async def main() -> None:
-    task_run = await client.task_run.create(input="France (2023)", processor="core")
-    run_result = await client.task_run.result(run_id=task_run.run_id)
-    print(run_result.output.content)
+    task_run = await client.task_run.create(
+        input="What was the GDP of France in 2023?",
+        processor="base",
+    )
+    print(task_run.interaction_id)
 
 
-if __name__ == "__main__":
-    asyncio.run(main())
+asyncio.run(main())
 ```
 
-To get the best performance out of Parallel's API, we recommend
-using the asynchronous client, especially for executing multiple Task Runs concurrently.
-Functionality between the synchronous and asynchronous clients is identical, including
-the convenience methods.
+Functionality between the synchronous and asynchronous clients is otherwise identical.
 
-## Frequently Asked Questions
+### With aiohttp
 
-**Does the Task API accept prompts or objectives?**
+By default, the async client uses `httpx` for HTTP requests. However, for improved concurrency performance you may also use `aiohttp` as the HTTP backend.
 
-No, there are no `objective` or `prompt` parameters that can be specified for calls to
-the Task API. Instead, provide any directives or instructions via the schemas. For
-more information, check [our docs](https://docs.parallel.ai/task-api/core-concepts/specify-a-task).
+You can enable this by installing `aiohttp`:
 
-**Can I access beta parameters or endpoints via the SDK?**
+```sh
+# install from PyPI
+pip install parallel-web[aiohttp]
+```
 
-Yes, the SDK supports both beta endpoints and beta header parameters for the Task API.
-All beta parameters are accessible via the `client.beta` namespace in the SDK.
+Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
 
-**Can I specify a timeout for API calls?**
+```python
+import os
+import asyncio
+from parallel import DefaultAioHttpClient
+from parallel import AsyncParallel
 
-Yes, all methods support a timeout. For more information, see [Timeouts](#timeouts).
 
+async def main() -> None:
+    async with AsyncParallel(
+        api_key=os.environ.get("PARALLEL_API_KEY"),  # This is the default and can be omitted
+        http_client=DefaultAioHttpClient(),
+    ) as client:
+        task_run = await client.task_run.create(
+            input="What was the GDP of France in 2023?",
+            processor="base",
+        )
+        print(task_run.interaction_id)
+
+
+asyncio.run(main())
+```
+
+## Using types
 
-**Can I specify retries via the SDK?**
+Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typing.html#typing.TypedDict). Responses are [Pydantic models](https://docs.pydantic.dev) which also provide helper methods for things like:
 
-Yes, errors can be retried via the SDK — the default retry count is 2. The maximum number
-of retries can be configured at the client level. For information on which errors
-are automatically retried and how to configure retry settings, see [Retries](#retries).
+- Serializing back into JSON, `model.to_json()`
+- Converting to a dictionary, `model.to_dict()`
 
-## Low‑level API access
+Typed requests and responses provide autocomplete and documentation within your editor. If you would like to see type errors in VS Code to help catch bugs earlier, set `python.analysis.typeCheckingMode` to `basic`.
 
-The library also provides low‑level access to the Parallel API.
+## Nested params
+
+Nested parameters are dictionaries, typed using `TypedDict`, for example:
 
 ```python
 from parallel import Parallel
-from parallel.types import TaskSpecParam
 
 client = Parallel()
 
 task_run = client.task_run.create(
-    input={"country": "France", "year": 2023},
-    processor="core",
-    task_spec={
-        "output_schema": {
-            "json_schema": {
-                "additionalProperties": False,
-                "properties": {
-                    "gdp": {
-                        "description": "GDP in USD for the year",
-                        "type": "string",
-                    }
-                },
-                "required": ["gdp"],
-                "type": "object",
-            },
-            "type": "json",
-        },
-        "input_schema": {
-            "json_schema": {
-                "additionalProperties": False,
-                "properties": {
-                    "country": {
-                        "description": "Name of the country to research",
-                        "type": "string",
-                    },
-                    "year": {
-                        "description": "Year for which to retrieve information",
-                        "type": "integer",
-                    },
-                },
-                "required": ["country", "year"],
-                "type": "object",
-            },
-            "type": "json",
-        },
-    },
+    input="What was the GDP of France in 2023?",
+    processor="base",
+    advanced_settings={},
 )
-
-run_result = client.task_run.result(task_run.run_id)
-print(run_result.output.content)
+print(task_run.advanced_settings)
 ```
 
-For more information, please check out the relevant section in our docs:
-
-- [Task Spec](https://docs.parallel.ai/task-api/core-concepts/specify-a-task)
-- [Task Runs](https://docs.parallel.ai/task-api/core-concepts/execute-task-run)
-
 ## Handling errors
 
 When the library is unable to connect to the API (for example, due to network connection problems or a timeout), a subclass of `parallel.APIConnectionError` is raised.
@@ -179,7 +148,10 @@ from parallel import Parallel
 client = Parallel()
 
 try:
-    client.task_run.create(input="France (2023)", processor="core")
+    client.task_run.create(
+        input="What was the GDP of France in 2023?",
+        processor="base",
+    )
 except parallel.APIConnectionError as e:
     print("The server could not be reached")
     print(e.__cause__)  # an underlying Exception, likely raised within httpx.
@@ -222,7 +194,10 @@ client = Parallel(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).task_run.create(input="France (2023)", processor="core")
+client.with_options(max_retries=5).task_run.create(
+    input="What was the GDP of France in 2023?",
+    processor="base",
+)
 ```
 
 ### Timeouts
@@ -245,7 +220,10 @@ client = Parallel(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).task_run.create(input="France (2023)", processor="core")
+client.with_options(timeout=5.0).task_run.create(
+    input="What was the GDP of France in 2023?",
+    processor="base",
+)
 ```
 
 On timeout, an `APITimeoutError` is thrown.
@@ -287,12 +265,12 @@ from parallel import Parallel
 
 client = Parallel()
 response = client.task_run.with_raw_response.create(
-    input="France (2023)",
-    processor="core",
+    input="What was the GDP of France in 2023?",
+    processor="base",
 )
 print(response.headers.get('X-My-Header'))
 
-task_run = response.parse()
+task_run = response.parse()  # get the object that `task_run.create()` would have returned
 print(task_run.interaction_id)
 ```
 
@@ -308,7 +286,8 @@ To stream the response body, use `.with_streaming_response` instead, which requi
 
 ```python
 with client.task_run.with_streaming_response.create(
-    input="France (2023)", processor="core"
+    input="What was the GDP of France in 2023?",
+    processor="base",
 ) as response:
     print(response.headers.get("X-My-Header"))
 

api.md

@@ -37,12 +37,15 @@ Types:
 from parallel.types import (
     AutoSchema,
     Citation,
+    ErrorEvent,
     FieldBasis,
     JsonSchema,
-    ParsedTaskRunResult,
+    McpServer,
+    McpToolCall,
     RunInput,
     TaskAdvancedSettings,
     TaskRun,
+    TaskRunEvent,
     TaskRunJsonOutput,
     TaskRunProgressMessageEvent,
     TaskRunProgressStatsEvent,
@@ -51,20 +54,19 @@ from parallel.types import (
     TaskRunTextOutput,
     TaskSpec,
     TextSchema,
+    Webhook,
+    TaskRunEventsResponse,
 )
 ```
 
 Methods:
 
 - <code title="post /v1/tasks/runs">client.task_run.<a href="./src/parallel/resources/task_run.py">create</a>(\*\*<a href="src/parallel/types/task_run_create_params.py">params</a>) -> <a href="./src/parallel/types/task_run.py">TaskRun</a></code>
 - <code title="get /v1/tasks/runs/{run_id}">client.task_run.<a href="./src/parallel/resources/task_run.py">retrieve</a>(run_id) -> <a href="./src/parallel/types/task_run.py">TaskRun</a></code>
+- <code title="get /v1/tasks/runs/{run_id}/events">client.task_run.<a href="./src/parallel/resources/task_run.py">events</a>(run_id) -> <a href="./src/parallel/types/task_run_events_response.py">TaskRunEventsResponse</a></code>
 - <code title="get /v1/tasks/runs/{run_id}/result">client.task_run.<a href="./src/parallel/resources/task_run.py">result</a>(run_id, \*\*<a href="src/parallel/types/task_run_result_params.py">params</a>) -> <a href="./src/parallel/types/task_run_result.py">TaskRunResult</a></code>
 - <code title="get /v1/tasks/runs/{run_id}/input">client.task_run.<a href="./src/parallel/resources/task_run.py">retrieve_input</a>(run_id) -> <a href="./src/parallel/types/run_input.py">RunInput</a></code>
 
-Convenience methods:
-
-- <code title="post /v1/tasks/runs">client.task_run.<a href="./src/parallel/resources/task_run.py">execute</a>(input, processor, output: <a href="./src/parallel/types/task_spec_param.py">OutputSchema</a>) -> <a href="./src/parallel/types/task_run_result.py">TaskRunResult</a></code>
-- <code title="post /v1/tasks/runs">client.task_run.<a href="./src/parallel/resources/task_run.py">execute</a>(input, processor, output: Type[OutputT]) -> <a href="./src/parallel/types/parsed_task_run_result.py">ParsedTaskRunResult[OutputT]</a></code>
 # TaskGroup
 
 Types:

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "parallel-web"
-version = "1.0.0"
+version = "1.0.1"
 description = "The official Python library for the Parallel API"
 dynamic = ["readme"]
 license = "MIT"
@@ -158,11 +158,6 @@ reportOverlappingOverload = false
 
 reportImportCycles = false
 reportPrivateUsage = false
-# Deprecation is a runtime concern; type-check warnings produce noise when the
-# breaking-change detector compares against pre-deprecation baseline tests.
-# Newly-generated tests already add a per-file `# pyright: reportDeprecated=false`
-# marker for deprecated resources, so this just promotes that to project-level.
-reportDeprecated = false
 
 [tool.mypy]
 pretty = true