---
title: "Create Acp Run"
method: POST
path: "/acp/v0/runs"
---

# Create Acp Run

`POST /acp/v0/runs`

## Request

- Base URL: `http://127.0.0.1:8052`
- URL: `http://127.0.0.1:8052/acp/v0/runs`
- Auth: none declared

Create an ACP run - creates a Bernstein task and links it.

Editors call this when the user submits a goal via the ACP sidebar.

## Request body

- ACPRunCreateRequest: Body for POST /acp/v0/runs.
  - `input` string, required
  - `agent_id` string
  - `role` string

## Response `201`

Successful Response

- ACPRunResponse: ACP run in responses.
  - `run_id` string, required
  - `bernstein_task_id` string, nullable
  - `input` string, required
  - `role` string, required
  - `status` string, required
  - `created_at` number, required
  - `updated_at` number, required

## Other responses

- `400`: Unknown ACP agent
- `422`: Validation Error

---

[API](https://skmtc.dev/bernstein/apis/bernstein-task-server.md) · [All operations](https://skmtc.dev/bernstein/apis/bernstein-task-server/llms.txt) · [OpenAPI document](https://skmtc.dev/bernstein/apis/bernstein-task-server/revisions/2a20a34ad2eb?raw)