# usewire-io API

**Canonical:** https://apis.io/apis/usewire-io/usewire-io-api/  
**Provider:** usewire-io — https://apis.io/providers/usewire-io/  
**Base URL:** https://YOUR_ORG_SLUG.api.usewire.io  
**Documentation:** https://docs.usewire.io/reference/tools

usewire-io API is one of 2 APIs that [usewire-io](https://apis.io/providers/usewire-io/) 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.

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

## Operations (31)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/agent/provision/containers` | GET /api/v1/agent/provision/containers |
| POST | `/api/v1/agent/provision/containers` | POST /api/v1/agent/provision/containers |
| DELETE | `/api/v1/agent/provision/containers/GvryOTHdfQKkjCTW` | DELETE /api/v1/agent/provision/containers/GvryOTHdfQKkjCTW |
| PATCH | `/api/v1/agent/provision/containers/GvryOTHdfQKkjCTW` | PATCH /api/v1/agent/provision/containers/GvryOTHdfQKkjCTW |
| GET | `/api/v1/agent/provision/whoami` | GET /api/v1/agent/provision/whoami |
| PATCH | `/api/v1/agents/someday` | Registers or updates the webhook URL and events for an agent. |
| POST | `/api/v1/agents/someday/publisher-keys` | POST /api/v1/agents/someday/publisher-keys |
| DELETE | `/api/v1/agents/{agentid}/publisher-keys/{keyid}` | Revokes a publisher key registered for an agent. |
| GET | `/api/v1/sdk/poll` | Returns installId and agentUserId as install_id and agent_user_id from the device flow. |
| GET | `/api/v1/sdk/status` | Returns connection details including installId and agentUserId under the connection field. |
| DELETE | `/container/{id}/files/{fileid}` | Delete a file and all entries derived from it. |
| GET | `/container/{containerId}/claim` | Generate a claim link for an ephemeral container. |
| GET | `/container/{containerId}/tools/delete` | Remove an entry by its ID. |
| GET | `/container/{containerId}/tools/explore` | Browse the container: what shape it has, and the entries in it. |
| GET | `/container/{containerId}/tools/navigate` | Traverse from an entry: relationships (filterable by type), siblings, source. |
| GET | `/container/{containerId}/tools/search` | Fuzzy hybrid retrieval over raw content in the container. |
| GET | `/container/{containerId}/tools/write` | Save an entry to the container. |
| POST | `/container/{containerid}/claim` | POST /container/{containerId}/claim |
| POST | `/container/{containerid}/tools/delete` | POST /container/{containerId}/tools/delete |
| POST | `/container/{containerid}/tools/explore` | POST /container/{containerId}/tools/explore |
| POST | `/container/{containerid}/tools/navigate` | POST /container/{containerId}/tools/navigate |
| POST | `/container/{containerid}/tools/query` | POST /container/{containerId}/tools/query |
| POST | `/container/{containerid}/tools/search` | POST /container/{containerId}/tools/search |
| POST | `/container/{containerid}/tools/write` | POST /container/{containerId}/tools/write |
| DELETE | `/installs/{installid}` | Uninstalls your agent from that install's container, then returns the install as it now reads. |
| GET | `/installs/{installid}` | Returns one install. |
| POST | `/installs/{installid}/export` | Asks Wire to export the install's container for the person who connected it. |
| GET | `/installs/{installid}/exports/{exportid}` | Returns the status of that export. |
| GET | `/tools` | GET /tools |
| POST | `/tools/{name}` | Calls one tool, with the tool's input as the JSON body. |
| GET | `/users/{agentuserid}/installs` | Returns every install that user has with your agent, newest first, as { "installs": [ … ] }. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/usewire-io/openapi/_ae-authored/usewire-io-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/usewire-io/json-schema/usewire-io-post-container-containerid-tools-explore-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/usewire-io/json-schema/usewire-io-get-installs-installid-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/usewire-io/json-schema/usewire-io-post-container-containerid-tools-query-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/usewire-io/json-schema/usewire-io-post-installs-installid-export-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/usewire-io/json-schema/usewire-io-get-installs-installid-exports-exportid-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/usewire-io/json-schema/usewire-io-get-api-v1-sdk-poll-response-schema.json

## Other usewire-io APIs (1)

- [Wire API](https://apis.io/apis/usewire-io/wire-api/)

---

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