# Airtop Agents API

**Canonical:** https://apis.io/apis/airtop/airtop-agents-api/  
**Provider:** Airtop — https://apis.io/providers/airtop/  
**Base URL:** https://api.airtop.ai/api/v1  
**Documentation:** https://docs.airtop.ai/api-reference/airtop-api

Airtop Agents API is one of 16 APIs that [Airtop](https://apis.io/providers/airtop/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

The Agents API from Airtop — 61 operation(s) for agents.

## Operations (60 of 78)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/agents/{id}/pre-share-summary` | Preview what sharing an agent would copy |
| GET | `/v1/agents/{id}/profile` | Resolve the caller's browser-profile name for an agent |
| POST | `/v1/agents/{id}/profile-setup-session` | Open an interactive session to populate the per-user agent profile |
| POST | `/v1/agents/{id}/profile-setup-session/complete` | Record the user's Done signal for a profile-setup session |
| POST | `/v1/agents/{id}/share` | Toggle agent sharing |
| GET | `/v1/agents/{id}/versions/{version}/requirements` | Get pre-flight requirements for an agent version |
| GET | `/v1/agents/{id}/vibe-coding/current-user-attachable-session` | Get the current user's attachable VICE session for an agent |
| GET | `/v2/agent-deploy-limit-status` | Get deploy limit status |
| GET | `/v2/agent-templates/{id}/knowledge-base` | List template knowledge base documents |
| GET | `/v2/agent-templates/{id}/knowledge-base/{documentId}` | Get template knowledge base document |
| PUT | `/v2/agent-templates/{id}/knowledge-base/{documentId}` | Update template knowledge base document |
| DELETE | `/v2/agents` | Delete agents |
| GET | `/v2/agents` | Get agents |
| POST | `/v2/agents` | Create an agent |
| POST | `/v2/agents/profile-agents` | Resolve the agent and owner for each browser profile |
| POST | `/v2/agents/triggers/count` | Count enabled agents using a trigger type |
| POST | `/v2/agents/triggers/disable` | Disable enabled agents using a trigger type |
| GET | `/v2/agents/{id}` | Get an agent |
| PATCH | `/v2/agents/{id}` | Update an agent |
| GET | `/v2/agents/{id}/attached-sensitive-value-fields` | Get attached sensitive value fields for the current draft |
| PUT | `/v2/agents/{id}/attached-sensitive-value-fields` | Replace attached sensitive value fields for the current draft |
| POST | `/v2/agents/{id}/avarice-runs` | Create Avarice run |
| GET | `/v2/agents/{id}/avarice-runs/latest` | Get latest Avarice run |
| GET | `/v2/agents/{id}/avarice-runs/{runId}` | Get Avarice run |
| PATCH | `/v2/agents/{id}/avarice-runs/{runId}` | Update Avarice run |
| POST | `/v2/agents/{id}/duplicate` | Duplicate an agent |
| GET | `/v2/agents/{id}/events` | Get an agent event stream |
| GET | `/v2/agents/{id}/invocations` | Get agent invocations |
| POST | `/v2/agents/{id}/invocations` | Create an agent invocation |
| DELETE | `/v2/agents/{id}/invocations/{invocationId}` | Cancel agent invocation |
| GET | `/v2/agents/{id}/invocations/{invocationId}` | Get an agent invocation |
| POST | `/v2/agents/{id}/invocations/{invocationId}` | Update an agent invocation |
| POST | `/v2/agents/{id}/invocations/{invocationId}/append-log` | Append log chunk to an agent invocation |
| POST | `/v2/agents/{id}/invocations/{invocationId}/publish-message` | Send a message from an agent invocation |
| POST | `/v2/agents/{id}/invocations/{invocationId}/telemetry` | Append telemetry for an agent invocation |
| PATCH | `/v2/agents/{id}/parameters` | Update published agent parameters |
| GET | `/v2/agents/{id}/published` | Get published agent template |
| PUT | `/v2/agents/{id}/rename` | Rename an agent |
| DELETE | `/v2/agents/{id}/repl/{sessionId}` | Destroy REPL session |
| GET | `/v2/agents/{id}/repl/{sessionId}` | Get REPL session status |
| POST | `/v2/agents/{id}/repl/{sessionId}` | Evaluate code in REPL session |
| GET | `/v2/agents/{id}/schedule` | Get agent schedule |
| PATCH | `/v2/agents/{id}/schedule` | Update agent schedule |
| GET | `/v2/agents/{id}/self-healing-repair` | Get the current automatic repair |
| POST | `/v2/agents/{id}/self-healing-repair` | Start a new Director repair |
| POST | `/v2/agents/{id}/sensitive-value-bindings/repair` | Replace an agent's vault credential bindings |
| GET | `/v2/agents/{id}/sensitive-value-catalog` | List the user's sensitive value catalog for an agent |
| POST | `/v2/agents/{id}/sensitive-value-entries` | Create a user sensitive value entry |
| POST | `/v2/agents/{id}/sensitive-value-field-tombstones/lookup` | Look up deleted Vault fields by handle |
| POST | `/v2/agents/{id}/transfer-ownership` | Transfer an agent to another org member |
| GET | `/v2/agents/{id}/transfer-preflight` | Preview what transferring an agent would move |
| DELETE | `/v2/agents/{id}/trigger` | Delete agent trigger (clear schedule) |
| POST | `/v2/agents/{id}/triggers/fire` | Fire an agent trigger now |
| GET | `/v2/agents/{id}/version/{version}/template` | Get agent template by version |
| POST | `/v2/agents/{id}/version/{version}/template/diagram/regenerate` | Regenerate agent template diagram |
| GET | `/v2/agents/{id}/versions` | List agent versions |
| GET | `/v2/agents/{id}/versions/current` | Get current agent version data |
| POST | `/v2/agents/{id}/versions/draft` | Get or create agent draft |
| POST | `/v2/agents/{id}/versions/publish` | Publish agent draft |
| DELETE | `/v2/agents/{id}/versions/{version}` | Delete an agent draft version |

…and 18 more operations. They are listed in full on the page.

## Machine-readable artifacts (11)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/airtop/refs/heads/main/openapi/airtop-agents-api-openapi.yml
- **Documentation** — https://docs.airtop.ai/guides/how-to/creating-a-session
- **APIReference** — https://docs.airtop.ai/api-reference/airtop-api/sessions/create
- **Postman** — https://raw.githubusercontent.com/api-evangelist/airtop/refs/heads/main/collections/airtop.postman_collection.json
- **Documentation** — https://docs.airtop.ai/api-reference/airtop-api/windows/create
- **APIReference** — https://docs.airtop.ai/api-reference/airtop-api
- **Documentation** — https://docs.airtop.ai/guides/how-to/ai/page-interactions
- **APIReference** — https://docs.airtop.ai/api-reference/airtop-api/windows/click
- **Documentation** — https://docs.airtop.ai/api-reference/airtop-api/windows/page-query
- **APIReference** — https://docs.airtop.ai/api-reference/airtop-api/windows/paginated-extraction
- **Documentation** — https://docs.airtop.ai/api-reference/airtop-api

## Other Airtop APIs (12)

- [Airtop Profiles API](https://apis.io/apis/airtop/airtop-profiles-api/)
- [Airtop Sessions API](https://apis.io/apis/airtop/airtop-sessions-api/)
- [Airtop Windows API](https://apis.io/apis/airtop/airtop-windows-api/)
- [Airtop Agent Director API](https://apis.io/apis/airtop/airtop-agent-director-api/)
- [Airtop Agent Folders API](https://apis.io/apis/airtop/airtop-agent-folders-api/)
- [Airtop Automations API](https://apis.io/apis/airtop/airtop-automations-api/)
- [Airtop Beta API](https://apis.io/apis/airtop/airtop-beta-api/)
- [Airtop Files API](https://apis.io/apis/airtop/airtop-files-api/)
- [Airtop GTM Engineer API](https://apis.io/apis/airtop/airtop-gtm-engineer-api/)
- [Airtop Knowledge Base API](https://apis.io/apis/airtop/airtop-knowledge-base-api/)
- [Airtop Requests API](https://apis.io/apis/airtop/airtop-requests-api/)
- [Airtop Sensitive Values API](https://apis.io/apis/airtop/airtop-sensitive-values-api/)

## Tags

Agents

---

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