# Roe AI API

**Canonical:** https://apis.io/apis/roe-ai/roe-ai-api/  
**Provider:** Roe AI — https://apis.io/providers/roe-ai/  
**Base URL:** https://api.roe-ai.com  
**Documentation:** https://docs.roe-ai.com/api-reference/agents/run

Roe AI API is one of 2 APIs that [Roe AI](https://apis.io/providers/roe-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Roe AI API as documented publicly: 45 operations. Contract generated from the documentation by API Evangelist (2026-10-29); not the provider's own document.

## Operations (45)

| Method | Path | Summary |
|---|---|---|
| GET | `/policies/` | Retrieve a paginated list of all policies in your organization. |
| POST | `/policies/` | Create a new policy with an initial version. |
| GET | `/v1/agents` | GET /v1/agents |
| POST | `/v1/agents` | POST /v1/agents |
| GET | `/v1/agents/` | Retrieve a list of agents or create a new agent. |
| POST | `/v1/agents/` | Create a new base agent. |
| GET | `/v1/agents/jobs/{agentJobId}/artifacts/result` | Get agent job result data. |
| GET | `/v1/agents/jobs/{jobid}/result` | GET /v1/agents/jobs/{jobId}/result |
| GET | `/v1/agents/jobs/{jobid}/status` | GET /v1/agents/jobs/{jobId}/status |
| POST | `/v1/agents/run/{agentid}` | POST /v1/agents/run/{agentId} |
| POST | `/v1/agents/run/{agentid}/async` | POST /v1/agents/run/{agentId}/async |
| DELETE | `/v1/agents/{agentid}` | DELETE /v1/agents/{agentId} |
| GET | `/v1/agents/{agentid}` | GET /v1/agents/{agentId} |
| PUT | `/v1/agents/{agentid}` | PUT /v1/agents/{agentId} |
| POST | `/v1/agents/{agentid}/duplicate` | POST /v1/agents/{agentId}/duplicate |
| GET | `/v1/agents/{agentid}/jobs` | GET /v1/agents/{agentId}/jobs |
| GET | `/v1/agents/{agentid}/versions` | GET /v1/agents/{agentId}/versions |
| POST | `/v1/agents/{agentid}/versions` | POST /v1/agents/{agentId}/versions |
| POST | `/v1/database/query` | POST /v1/database/query |
| POST | `/v1/database/query/` | Execute a query synchronously and return results. |
| POST | `/v1/database/query/async` | POST /v1/database/query/async |
| POST | `/v1/database/query/async/` | Execute a query asynchronously and return query object. |
| GET | `/v1/database/query/{queryid}/result` | GET /v1/database/query/{queryId}/result |
| GET | `/v1/database/query/{queryid}/status` | GET /v1/database/query/{queryId}/status |
| GET | `/v1/datasets` | GET /v1/datasets |
| POST | `/v1/datasets` | POST /v1/datasets |
| GET | `/v1/datasets/` | Retrieve a list of datasets or create a new dataset. |
| POST | `/v1/datasets/` | Create a new dataset. |
| POST | `/v1/datasets/files/upload` | POST /v1/datasets/files/upload |
| POST | `/v1/datasets/files/upload/` | Upload a file to a dataset. |
| GET | `/v1/datasets/files/{fileid}/download` | GET /v1/datasets/files/{fileId}/download |
| DELETE | `/v1/datasets/{datasetid}` | DELETE /v1/datasets/{datasetId} |
| DELETE | `/v1/datasets/{datasetid}/files/{fileid}` | DELETE /v1/datasets/{datasetId}/files/{fileId} |
| GET | `/v1/policies` | GET /v1/policies |
| POST | `/v1/policies` | POST /v1/policies |
| DELETE | `/v1/policies/{policyid}` | DELETE /v1/policies/{policyId} |
| GET | `/v1/policies/{policyid}` | GET /v1/policies/{policyId} |
| PATCH | `/v1/policies/{policyid}` | PATCH /v1/policies/{policyId} |
| PUT | `/v1/policies/{policyid}` | PUT /v1/policies/{policyId} |
| GET | `/webhooks` | GET /webhooks |
| POST | `/webhooks` | POST /webhooks |
| GET | `/webhooks/` | Fetch the list of all webhooks for an organization. |
| POST | `/webhooks/` | Mixin for organization access validation. |
| PATCH | `/webhooks/{webhookid}` | PATCH /webhooks/{webhookId} |
| GET | `/webhooks/{webhookid}/agents/{agentwebhookid}` | GET /webhooks/{webhookId}/agents/{agentWebhookId} |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/roe-ai/openapi/_ae-authored/roe-ai-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/roe-ai/json-schema/roe-ai-post-v1-agents-agentid-duplicate-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/roe-ai/json-schema/roe-ai-get-v1-agents-agentid-jobs-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/roe-ai/json-schema/roe-ai-get-v1-agents-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/roe-ai/json-schema/roe-ai-post-v1-agents-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/roe-ai/json-schema/roe-ai-put-v1-agents-agentid-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/roe-ai/json-schema/roe-ai-get-v1-database-query-queryid-result-response-schema.json

## Other Roe AI APIs (1)

- [Roe API](https://apis.io/apis/roe-ai/roe-api/)

---

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