# codai Agents API

**Canonical:** https://apis.io/apis/codai-ro/codai-ro-agents-api/  
**Provider:** codai — https://apis.io/providers/codai-ro/  
**Base URL:** https://ai.codai.ro  
**Documentation:** https://docs.codai.ro/docs/api

codai Agents API is one of 35 APIs that [codai](https://apis.io/providers/codai-ro/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

Task-oriented agent API: submit a goal and the gateway runs the whole agent loop server-side (routing, gateway tools, sub-agents, memory). `POST /v1/agents/run` blocks until the answer; `POST /v1/agents/runs` returns a run id immediately and persists the run so it can be polled, streamed and cancelled. Requires a tier with sub-agents and tools (Pro or above).

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/agents/run` | Run an agent task synchronously |
| POST | `/v1/agents/runs` | Create an asynchronous agent run |
| GET | `/v1/agents/runs/stats` | Aggregate statistics over your agent runs |
| GET | `/v1/agents/runs/{id}` | Poll an agent run |
| GET | `/v1/agents/runs/{id}/steps` | List the persisted steps of a run |
| GET | `/v1/agents/runs/{id}/stream` | Stream a run's progress over SSE |
| POST | `/v1/agents/runs/{id}/cancel` | Cancel a queued or running run |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/codai-ro/openapi/codai-ro-agents-api-openapi.yml
- **Documentation** — https://docs.codai.ro/docs/gateway
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-agent-run-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-agent-run-stats-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-agent-run-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-agent-run-step-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-agent-sync-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-agent-run-accepted-schema.json

## Other codai APIs (12)

- [codai Account API](https://apis.io/apis/codai-ro/codai-ro-account-api/)
- [codai Attestations API](https://apis.io/apis/codai-ro/codai-ro-attestations-api/)
- [codai Authorization API](https://apis.io/apis/codai-ro/codai-ro-authorization-api/)
- [codai Chat & Completions API](https://apis.io/apis/codai-ro/codai-ro-chat-completions-api/)
- [codai Connect API](https://apis.io/apis/codai-ro/codai-ro-connect-api/)
- [codai Devices API](https://apis.io/apis/codai-ro/codai-ro-devices-api/)
- [codai Discovery API](https://apis.io/apis/codai-ro/codai-ro-discovery-api/)
- [codai Embeddings & Audio API](https://apis.io/apis/codai-ro/codai-ro-embeddings-audio-api/)
- [codai Feed API](https://apis.io/apis/codai-ro/codai-ro-feed-api/)
- [codai Guest chat API](https://apis.io/apis/codai-ro/codai-ro-guest-chat-api/)
- [codai Health API](https://apis.io/apis/codai-ro/codai-ro-health-api/)
- [codai Hosts API](https://apis.io/apis/codai-ro/codai-ro-hosts-api/)

## Tags

Agents

---

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