# ChiefLab Runs API

**Canonical:** https://apis.io/apis/chieflab-io/chieflab-io-runs-api/  
**Provider:** ChiefLab — https://apis.io/providers/chieflab-io/  
**Base URL:** https://api.chieflab.io  
**Documentation:** https://chieflab.io/docs

ChiefLab Runs API is one of 6 APIs that [ChiefLab](https://apis.io/providers/chieflab-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Runs. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Marketing runs and approval surface.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/runs` | List recent runs (workspace-scoped) |
| GET | `/api/runs/{id}` | Get a run with assets + actions |
| POST | `/api/runs/{id}/approve` | Approve a run (or a specific action via /api/actions/{id}/approve) |
| POST | `/api/runs/{id}/reject` | Reject a run with optional feedback (feedback persists as per-tenant voice… |
| GET | `/api/actions` | List proposed actions across runs |
| POST | `/api/actions/{id}/approve` | Approve a single action (transitions awaiting_approval → approved) |
| POST | `/api/actions/{id}/reject` | Reject a single action with optional feedback |
| POST | `/api/actions/{id}/execute` | Execute an approved action (e.g. fire Zernio publish, Resend send) |
| GET | `/api/assets` | List generated assets (creatives, briefs, images) |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/chieflab-io/openapi/chieflab-io-runs-api-openapi.yml
- **Documentation** — https://chieflab.io/docs
- **APIReference** — https://chieflab.io/docs/mcp-reference

## Other ChiefLab APIs (5)

- [ChiefLab Connectors API](https://apis.io/apis/chieflab-io/chieflab-io-connectors-api/)
- [ChiefLab GTM API](https://apis.io/apis/chieflab-io/chieflab-io-gtm-api/)
- [ChiefLab MCP API](https://apis.io/apis/chieflab-io/chieflab-io-mcp-api/)
- [ChiefLab Public API](https://apis.io/apis/chieflab-io/chieflab-io-public-api/)
- [ChiefLab Workspace API](https://apis.io/apis/chieflab-io/chieflab-io-workspace-api/)

## Tags

Runs

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/chieflab-io/chieflab-io-runs-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/chieflab-io/.