---
title: "POST /chiefs/{chief_id}/runs"
method: POST
path: "/chiefs/{chief_id}/runs"
tags: ["Chief"]
---

# POST /chiefs/{chief_id}/runs

`POST /chiefs/{chief_id}/runs`

## Request

- Base URL: `https://api.team0.ai/v1`
- URL: `https://api.team0.ai/v1/chiefs/{chief_id}/runs`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://clerk.team0.ai/oauth/authorize`, token URL `https://clerk.team0.ai/oauth/token`)
  - HTTP bearer

## Path parameters

- `chief_id` string, required

## Headers

- `Idempotency-Key` string, required

## Request body

- ChiefRunCreate
  - `input` object[], required
    - `type` 'text', required
    - `text` string, required
  - `mode` 'respond' | 'plan' | 'act', required
  - `execution_policy` 'caller_acts' | 'team0_asks_first' | 'team0_may_act': Maximum or effective action owner. A request may narrow an application's maximum but never widen it.
  - `session_id` string
  - `read_id` string

## Response `202`

Durable Chief run accepted.

- ChiefRun
  - `id` string, required
  - `object` 'chief.run', required
  - `chief_id` string, required
  - `mode` 'respond' | 'plan' | 'act', required
  - `execution_policy` 'caller_acts' | 'team0_asks_first' | 'team0_may_act', required: Maximum or effective action owner. A request may narrow an application's maximum but never widen it.
  - `status` 'queued' | 'running' | 'input_required' | 'approval_required' | 'resolution_required' | 'completed' | 'completed_with_uncertainty' | 'failed' | 'cancelled' | 'expired', required
  - `version` integer, required
  - `result` object, nullable
  - `read_ids` OpaqueId[]
  - `pending_inputs` PendingInput[], required
    - `id` string, required
    - `object` 'chief.input_request', required
    - `version` integer, required
    - `schema` object, required
    - `expires_at` string, date-time, required
    - `run_version` integer, required
    - `submission` string, uri-reference, required
  - `pending_approvals` PendingApproval[], required
    - `id` string, required
    - `object` 'chief.approval', required
    - `summary` string
    - `proposal_digest` string, required
    - `grant_version` integer, required
    - `run_version` integer, required
    - `expires_at` string, date-time, required
    - `decision` string, uri-reference, required
  - `unresolved_effects` UnresolvedEffect[], required
    - `id` string, required
    - `object` 'chief.effect', required
    - `status` 'indeterminate', required
    - `version` integer, required
    - `summary` string
    - `resolution` string, uri-reference, required
  - `links` object, required

## Other responses

- `default`: RFC 9457 problem response. Cross-tenant identity is non-enumerating.

---

[API](https://skmtc.dev/team0/apis/team0-external-api.md) · [All operations](https://skmtc.dev/team0/apis/team0-external-api/llms.txt) · [OpenAPI document](https://skmtc.dev/team0/apis/team0-external-api/revisions/9b838d20a98f?raw)