---
title: "Run an agent"
method: POST
path: "/api/v1/agents/{id}/run"
tags: ["agents"]
---

# Run an agent

`POST /api/v1/agents/{id}/run`

## Request

- Base URL: `https://api.agenticcontrolplane.com`
- URL: `https://api.agenticcontrolplane.com/api/v1/agents/{id}/run`
- Auth: HTTP bearer

Triggers a governed run of the profile. The run executes under the profile's limits (budget, tool rounds, duration) and every tool call is policy-checked and audited.

## Path parameters

- `id` string, required

## Request body

- object

## Response `200`

Run result / run reference.

- object
  - `ok` boolean

## Other responses

- `401`: Missing, malformed, invalid, or revoked gsk_ API key.
- `404`: Not found.
- `500`: Server error.

---

[API](https://skmtc.dev/agenticcontrolplane/apis/agentic-control-plane-gateway-api.md) · [All operations](https://skmtc.dev/agenticcontrolplane/apis/agentic-control-plane-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agenticcontrolplane/apis/agentic-control-plane-gateway-api/revisions/161819f3df00?raw)