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

# Run V2 chat agent

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

Manually dispatches a V2 agent as if one of its triggers fired. Cron triggers run immediately; webhook and workflow triggers use the supplied `payload`. Channel/message triggers are not supported. Requires a token with write access.

## Path parameters

- `id` string, required — Agent id.

## Query parameters

- `workspace_id` string — Optional workspace override. If omitted, Conduit resolves the agent's workspace automatically.

## Request body

- object — Request body for manually dispatching a V2 chat agent.
  - `trigger_id` string — Which trigger to run. Required only when the agent has more than one trigger. Cron runs immediately; webhook and workflow runs use `payload`.
  - `payload` unknown

## Response `200`

Agent dispatched

- object — Result of a manual agent dispatch.
  - `data` object, required
    - `dispatched` boolean, required
    - `trigger_id` string, required
    - `trigger_type` 'cron' | 'webhook' | 'event', required

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `422` — Trigger cannot be dispatched
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/conduit/apis/conduit-api.md) · [All operations](https://skmtc.dev/conduit/apis/conduit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conduit/conduit-api/revisions/3ad7e17f96ad/schema)