# Parallel Tasks API

**Canonical:** https://apis.io/apis/parallel/parallel-tasks-api/  
**Provider:** Parallel — https://apis.io/providers/parallel/  
**Base URL:** https://api.parallel.ai  
**Documentation:** https://docs.parallel.ai/getting-started/overview

Parallel Tasks API is one of 8 APIs that [Parallel](https://apis.io/providers/parallel/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Task. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and authentication docs.

The Task API executes web research and extraction tasks. Clients submit a natural-language objective with an optional input schema; the service plans retrieval, fetches relevant URLs, and returns outputs that conform to a provided or inferred JSON schema. Supports deep research style queries and can return rich structured JSON outputs. Processors trade-off between cost, latency, and quality. Each processor supports calibrated confidences. - Output metadata: citations, excerpts, reasoning, and confidence per field Task Groups enable batch execution of many independent Task runs with group-level monitoring and failure handling. - Submit hundreds or thousands of Tasks as a single group - Observe group progress and receive results as they complete - Real-time updates via Server-Sent Events (SSE) - Add tasks to an existing group while it is running - Group-level retry and error aggregation

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/tasks/groups` | Create Task Group |
| GET | `/v1/tasks/groups/{taskgroup_id}` | Retrieve Task Group |
| GET | `/v1/tasks/groups/{taskgroup_id}/events` | Stream Task Group Events |
| POST | `/v1/tasks/groups/{taskgroup_id}/runs` | Add Runs to Task Group |
| GET | `/v1/tasks/groups/{taskgroup_id}/runs` | Fetch Task Group Runs |
| GET | `/v1/tasks/groups/{taskgroup_id}/runs/{run_id}` | Retrieve Task Group Run |
| POST | `/v1/tasks/runs` | Create Task Run |
| GET | `/v1/tasks/runs/{run_id}` | Retrieve Task Run |
| GET | `/v1/tasks/runs/{run_id}/events` | Stream Task Run Events |
| GET | `/v1/tasks/runs/{run_id}/input` | Retrieve Task Run Input |
| GET | `/v1/tasks/runs/{run_id}/result` | Retrieve Task Run Result |
| GET | `/v1beta/tasks/runs/{run_id}/events` | Stream Task Run Events |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/parallel/refs/heads/main/openapi/parallel-tasks-api-openapi.yml
- **Documentation** — https://docs.parallel.ai/home
- **APIReference** — https://docs.parallel.ai/api-reference
- **GettingStarted** — https://docs.parallel.ai/getting-started/overview
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/parallel/refs/heads/main/authentication/parallel-authentication.yml

## Other Parallel APIs (7)

- [Parallel Chat API (Beta) API](https://apis.io/apis/parallel/parallel-chat-api-beta-api/)
- [Parallel Extract API](https://apis.io/apis/parallel/parallel-extract-api/)
- [Parallel FindAll API](https://apis.io/apis/parallel/parallel-findall-api/)
- [Parallel Monitor API](https://apis.io/apis/parallel/parallel-monitor-api/)
- [Parallel Search API](https://apis.io/apis/parallel/parallel-search-api/)
- [Parallel Memory API](https://apis.io/apis/parallel/parallel-memory-api/)
- [Parallel Responses API](https://apis.io/apis/parallel/parallel-responses-api-api/)

## Tags

Task

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/parallel/parallel-tasks-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/parallel/.