---
title: "POST /v1/agents/{agent_id}/runs"
method: POST
path: "/v1/agents/{agent_id}/runs"
tags: ["runs"]
---

# POST /v1/agents/{agent_id}/runs

`POST /v1/agents/{agent_id}/runs`

## Path parameters

- `agent_id` string, uuid, required

## Request body

- StartRunBody
  - `run_mode` string, nullable
  - `user_message` string, nullable

## Response `201`

- StartRunResponse
  - `run` Run, required
    - `agent_id` string, required
    - `event_bytes` integer, required
    - `event_count` integer, required
    - `goal` string, nullable
    - `is_finished` boolean, required
    - `last_event_at` string, required
    - `policy_model` string, nullable
    - `policy_type` string, nullable
    - `run_id` string, required
    - `run_kind` string, nullable
    - `run_number` integer, required
    - `schedule_agent_id` string, nullable
    - `started_at` string, required
    - `status` string, nullable
    - `step_count` integer, required
    - `user_email` string, nullable
    - `user_id` string, nullable
    - `webhook_subscription_id` string, nullable
    - `wrote_instructions` boolean, nullable

## Other responses

- `400`

---

[API](https://skmtc.net/twin/apis/twin-api.md) · [All operations](https://skmtc.net/twin/apis/twin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twin/twin-api/revisions/a674e57c2ec4/schema)