# AgentDrive API

**Canonical:** https://apis.io/apis/agentdrive-sh/agentdrive-sh-api/  
**Provider:** AgentDrive — https://apis.io/providers/agentdrive-sh/  
**Base URL:** https://app.agentdrive.sh  
**Documentation:** https://agentdrive.sh/docs/rest-api

AgentDrive API is one of 2 APIs that [AgentDrive](https://apis.io/providers/agentdrive-sh/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

AgentDrive API as documented publicly: 25 operations. Contract generated from the documentation by API Evangelist (2026-10-31); not the provider's own document.

## Operations (25)

| Method | Path | Summary |
|---|---|---|
| GET | `/` | GET / |
| GET | `/install` | GET /install |
| POST | `/v1/auth/send-code` | Send a magic-link code to an email |
| POST | `/v1/auth/verify-code` | Exchange code for a session |
| GET | `/v1/org` | Read org metadata, plan, usage, and quotas. |
| POST | `/v1/org/invites` | Invite a human or agent. |
| POST | `/v1/register` | Bootstrap a new org and agent, returns API key. |
| POST | `/v1/runs` | Log an agent run |
| GET | `/v1/workspaces` | List workspaces for the principal. |
| POST | `/v1/workspaces` | Create a workspace. |
| DELETE | `/v1/workspaces/{wid}` | Delete a workspace. |
| GET | `/v1/workspaces/{wid}` | Read a workspace. |
| GET | `/v1/workspaces/{wid}/activity` | Activity stream |
| POST | `/v1/workspaces/{wid}/context` | Top-N relevant artifacts for a task |
| POST | `/v1/workspaces/{wid}/feedback` | Capture feedback |
| GET | `/v1/workspaces/{wid}/files` | List files (paginated). |
| POST | `/v1/workspaces/{wid}/files` | Write a file (creates or new version). |
| DELETE | `/v1/workspaces/{wid}/files/{fid}` | Delete a file. |
| GET | `/v1/workspaces/{wid}/files/{fid}` | Read a file, optionally with ?content=true. |
| PUT | `/v1/workspaces/{wid}/files/{fid}` | Update a file. |
| POST | `/v1/workspaces/{wid}/files/{fid}/comments` | Comments on a file |
| GET | `/v1/workspaces/{wid}/files/{fid}/versions` | Version history |
| POST | `/v1/workspaces/{wid}/recall` | Memory query |
| POST | `/v1/workspaces/{wid}/search` | Semantic search |
| POST | `/v1/workspaces/{wid}/share` | Mint a share token |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/agentdrive-sh/openapi/_ae-authored/agentdrive-sh-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/agentdrive-sh/json-schema/agentdrive-sh-get-install-response-schema.json

## Other AgentDrive APIs (1)

- [AgentDrive MCP API](https://apis.io/apis/agentdrive-sh/agentdrive-mcp-api/)

---

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