---
title: "Atomically submit up to 100 independent or dependent tasks"
method: POST
path: "/v1/agent-groups/{id}/runs"
tags: ["Managed agents"]
---

# Atomically submit up to 100 independent or dependent tasks

`POST /v1/agent-groups/{id}/runs`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/agent-groups/{id}/runs`
- Auth: HTTP bearer

Requires authentication and a group owned by the authenticated tenant. A missing or foreign-owned group returns 404. The whole request is limited to 1 MiB. Duplicate task keys, missing dependencies and cycles are rejected atomically. A task key with changed input, dependencies or deadline conflicts. Retrying the same batch key returns its original ordered receipt even after cancellation or admission disablement. Separate tasks have independent sessions and writable state.

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string, required

## Request body

- ManagedAgentGroupBatchRequest
  - `tasks` ManagedAgentGroupTask[], required
    - `task_key` string, required: Immutable identity within this group. Reuse with identical content to recover the same run.
    - `input` unknown, required
    - `depends_on` string[]: Prerequisite task keys from this group or the same batch. All prerequisites must commit success before dispatch. Results are not automatically copied into this input.
    - `deadline` string, date-time: A new task deadline must be in the future. Accepted task retries preserve the original deadline.

## Response `202`

Accepted

- ManagedAgentGroupBatch
  - `group_id` string, required
  - `runs` ManagedAgentGroupTaskReceipt[], required: Stable task and run identities in request order.
    - `task_key` string, required
    - `run_id` string, required

## Other responses

- `404`: Group or definition is missing or belongs to another tenant
- `default`: Operation refused with a diagnostic and next action

## Changes

- **2026-10-01** `ba84c74aeec8`: 1 info
  - endpoint added
- **2026-10-01** `544fef290a54`: 1 breaking
  - api path removed without deprecation
- **2026-09-27** `3116341c21c1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/changes/v1/agent-groups/:id/runs/post.md)

---

[API](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api.md) - [All operations](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/revisions/a59210899d95?raw)