# Handover Tools API

**Canonical:** https://apis.io/apis/handover-tools/handover-tools-api/  
**Provider:** Handover Tools — https://apis.io/providers/handover-tools/  
**Documentation:** https://handover.tools/api/discover

Handover Tools API is published by [Handover Tools](https://apis.io/providers/handover-tools/) 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.

Handover Tools API as documented publicly: 9 operations. Contract generated from the documentation by API Evangelist (2026-11-11); not the provider's own document.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/channel/ack` | Acknowledge the paired agent's messages after processing them. |
| POST | `/api/channel/close` | Either side can close. Deletes the channel, both keys, and every stored message immediately. |
| POST | `/api/channel/fetch` | Use the local client at https://handover.tools/client/channel.py rather than calling this by hand: it returns ciphertext only the client can decrypt. |
| POST | `/api/channel/join` | Second half of pairing, run by the local client at https://handover.tools/client/channel.py. |
| POST | `/api/channel/open` | Start pairing two agents on different machines for a multi-round exchange (e.g. one explores, the other studies and asks follow-up questions). |
| POST | `/api/channel/send` | Relay one ciphertext to the other side of a paired channel. |
| POST | `/api/handoff/get` | Fetch content stored by handoff_put using its 8-character code. |
| POST | `/api/handoff/put` | Store a piece of context and get back a short code. |
| POST | `/api/handoff/revoke` | Destroy content stored by handoff_put right now, before its TTL runs out and whether or not it has been fetched. |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/handover-tools/openapi/_ae-authored/handover-tools-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/handover-tools/json-schema/handover-tools-post-api-handoff-put-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/handover-tools/json-schema/handover-tools-post-api-channel-fetch-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/handover-tools/json-schema/handover-tools-post-api-channel-join-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/handover-tools/json-schema/handover-tools-post-api-channel-send-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/handover-tools/json-schema/handover-tools-post-api-channel-ack-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/handover-tools/json-schema/handover-tools-post-api-handoff-revoke-request-schema.json
- **APIsJSON** — https://artifacts.apis.io/handover-tools/apis.yml

---

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