---
title: "Run an agent"
method: POST
path: "/v1/agents/{agent_id}/runs"
tags: ["S20 Agent Platform (beta)"]
---

# Run an agent

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

## Request

- Base URL: `https://api.brainiall.com`
- URL: `https://api.brainiall.com/v1/agents/{agent_id}/runs`
- Auth: HTTP bearer

Executes a governed agent run and returns policy decisions, tool steps and latencies.

## Path parameters

- `agent_id` string, required

## Request body

- object
  - `input` string, required
  - `tools` string[]
  - `context` object
  - `source` string
  - `dry_run` boolean

## Response `200`

OK

- object

## Other responses

- `401`: Invalid or missing API key
- `404`: Agent not found
- `429`: Rate limit or quota exceeded

---

[API](https://skmtc.dev/brainiall/apis/brainiall-specialist-ai-apis.md) · [All operations](https://skmtc.dev/brainiall/apis/brainiall-specialist-ai-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/brainiall/apis/brainiall-specialist-ai-apis/revisions/e44fed29a7b5?raw)