# Roark Agent API

**Canonical:** https://apis.io/apis/roark/roark-agent-api/  
**Provider:** Roark — https://apis.io/providers/roark/  
**Base URL:** https://api.roark.ai  
**Documentation:** https://docs.roark.ai/api-reference/introduction

Roark Agent API is one of 36 APIs that [Roark](https://apis.io/providers/roark/) 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 Agent. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The Agent API from Roark — 10 operation(s) for agent.

## Operations (17)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/agent/{agentId}/prompts` | List an agent's prompts |
| PUT | `/v1/agent/{agentId}/prompts` | Set an agent's prompt |
| GET | `/v1/agent/{agentId}/prompts/{promptId}/versions` | List a prompt's versions |
| GET | `/v1/agent/{agentId}/versions` | List an agent's versions |
| GET | `/v1/agent/{agentId}/versions/{versionId}` | Get an agent version |
| POST | `/v1/agent/{agentId}/versions/{versionId}/rollback` | Roll an agent back to a version |
| GET | `/v1/agent/{agentId}/draft` | Get an agent's draft |
| POST | `/v1/agent/{agentId}/draft` | Start a draft |
| PUT | `/v1/agent/{agentId}/draft` | Edit the draft |
| DELETE | `/v1/agent/{agentId}/draft` | Discard the draft |
| POST | `/v1/agent/{agentId}/draft/publish` | Publish the draft |
| GET | `/v1/agent` | List agents |
| POST | `/v1/agent` | Create a new agent |
| GET | `/v1/agent/{agentId}` | Get agent by ID |
| PUT | `/v1/agent/{agentId}` | Update an agent |
| DELETE | `/v1/agent/{agentId}` | Delete an agent |
| POST | `/v1/agent/build` | Build a Roark-hosted agent |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/roark/openapi/roark-agent-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/roark/json-schema/roark-metric-collection-job-metric-values-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/roark/json-schema/roark-get-simulation-plan-job-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/roark/json-schema/roark-simulation-job-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/roark/json-schema/roark-dashboard-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/roark/json-schema/roark-dashboard-schema.json
- **JSONSchema** — https://artifacts.apis.io/roark/json-schema/roark-update-dashboard-input-schema.json
- **APIsJSON** — https://artifacts.apis.io/roark/apis.yml

## Other Roark APIs (12)

- [Roark Agent Config API](https://apis.io/apis/roark/roark-agent-config-api/)
- [Roark Agent Endpoint API](https://apis.io/apis/roark/roark-agent-endpoint-api/)
- [Roark Analytics API](https://apis.io/apis/roark/roark-analytics-api/)
- [Roark Autoimprove API](https://apis.io/apis/roark/roark-autoimprove-api/)
- [Roark Benchmark API](https://apis.io/apis/roark/roark-benchmark-api/)
- [Roark Call API](https://apis.io/apis/roark/roark-call-api/)
- [Roark Chat API](https://apis.io/apis/roark/roark-chat-api/)
- [Roark CLI Auth API](https://apis.io/apis/roark/roark-cli-auth-api/)
- [Roark Config API](https://apis.io/apis/roark/roark-config-api/)
- [Roark Customer Flow API](https://apis.io/apis/roark/roark-customer-flow-api/)
- [Roark Customer Flow Edge Case API](https://apis.io/apis/roark/roark-customer-flow-edge-case-api/)
- [Roark Dashboard API](https://apis.io/apis/roark/roark-dashboard-api/)

## Tags

Agent

---

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