# Derive Agents API

**Canonical:** https://apis.io/apis/derive-to/derive-to-agents-api/  
**Provider:** Derive — https://apis.io/providers/derive-to/  
**Documentation:** https://docs.derive.to/reference/api/

Derive Agents API is one of 28 APIs that [Derive](https://apis.io/providers/derive-to/) 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 and 6 JSON Schemas.

Agents: named workers with instructions, a machine, and what they can reach. Also the OAuth agents a user has authorized.

## Operations (22)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/agents/{id}/artifacts` | Readable documents pinned to an agent, at their latest version |
| PUT | `/v1/agents/{id}/artifacts/{ref}` | Pin a document to an agent |
| DELETE | `/v1/agents/{id}/artifacts/{ref}` | Unpin an agent document |
| GET | `/v1/agents/{id}/members` | The people an agent is shared with, its creator first |
| PUT | `/v1/agents/{id}/members` | Share an agent with a workspace member, or change their role |
| DELETE | `/v1/agents/{id}/members/{userId}` | Stop sharing an agent with someone |
| GET | `/v1/agents/runtime` | Cloud runtime available to this workspace |
| GET | `/v1/agents` | List the workspace's agents. Every member sees them, like the work they do |
| POST | `/v1/agents` | Create an agent and mint its key (returned once) |
| GET | `/v1/agents/{id}` | One agent, with its schedules. Any member of its workspace can read it |
| PATCH | `/v1/agents/{id}` | Edit an agent (its creator or a workspace owner) |
| DELETE | `/v1/agents/{id}` | Delete an agent (its creator or a workspace owner) |
| POST | `/v1/agents/{id}/triggers` | Add a schedule, or a GitHub event that starts the agent, to an agent |
| PATCH | `/v1/triggers/{id}` | Change or pause a schedule or event trigger |
| DELETE | `/v1/triggers/{id}` | Remove a schedule or event trigger |
| POST | `/v1/agents/{id}/rotate` | Replace an agent's key (its creator or a workspace owner); the old one dies at… |
| GET | `/v1/me/connected-agents` | List the OAuth agents the signed-in user authorized to act on their behalf |
| DELETE | `/v1/me/connected-agents/{clientId}` | Revoke a connected agent's authorization |
| GET | `/v1/runtime/connection` | The workspace's sandbox connection |
| PUT | `/v1/runtime/connection` | Verify and connect the workspace's sandbox API key |
| PATCH | `/v1/runtime/connection` | Choose the workspace's Boat snapshot for new agent sandboxes |
| DELETE | `/v1/runtime/connection` | Disconnect workspace compute and stop its active work |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/derive-to/openapi/derive-to-agents-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/derive-to/json-schema/derive-to-artifact-schema.json
- **JSONSchema** — https://artifacts.apis.io/derive-to/json-schema/derive-to-job-schema.json
- **JSONSchema** — https://artifacts.apis.io/derive-to/json-schema/derive-to-context-analysis-info-schema.json
- **JSONSchema** — https://artifacts.apis.io/derive-to/json-schema/derive-to-agent-schema.json
- **JSONSchema** — https://artifacts.apis.io/derive-to/json-schema/derive-to-comment-schema.json
- **JSONSchema** — https://artifacts.apis.io/derive-to/json-schema/derive-to-collection-schema.json

## Other Derive APIs (12)

- [Derive Accounts API](https://apis.io/apis/derive-to/derive-to-accounts-api/)
- [Derive Activity API](https://apis.io/apis/derive-to/derive-to-activity-api/)
- [Derive Analytics API](https://apis.io/apis/derive-to/derive-to-analytics-api/)
- [Derive Artifacts API](https://apis.io/apis/derive-to/derive-to-artifacts-api/)
- [Derive Assets API](https://apis.io/apis/derive-to/derive-to-assets-api/)
- [Derive Collections API](https://apis.io/apis/derive-to/derive-to-collections-api/)
- [Derive Comments API](https://apis.io/apis/derive-to/derive-to-comments-api/)
- [Derive Contexts API](https://apis.io/apis/derive-to/derive-to-contexts-api/)
- [Derive Domains API](https://apis.io/apis/derive-to/derive-to-domains-api/)
- [Derive Exports API](https://apis.io/apis/derive-to/derive-to-exports-api/)
- [Derive Favorites API](https://apis.io/apis/derive-to/derive-to-favorites-api/)
- [Derive Folders API](https://apis.io/apis/derive-to/derive-to-folders-api/)

## Tags

Agents

---

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