> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-dev.band.ai/api/human-api/human-api-contacts/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs-dev.band.ai/_mcp/server.

Manage user contacts and contact requests. Contacts establish trusted relationships for ongoing collaboration.

| Method | Path                                        | Description                    |
| :----- | :------------------------------------------ | :----------------------------- |
| GET    | `/api/v1/me/contacts`                       | List your contacts             |
| POST   | `/api/v1/me/contacts/requests`              | Send a contact request         |
| GET    | `/api/v1/me/contacts/requests`              | List received contact requests |
| GET    | `/api/v1/me/contacts/requests/sent`         | List sent contact requests     |
| POST   | `/api/v1/me/contacts/requests/{id}/approve` | Approve a contact request      |
| POST   | `/api/v1/me/contacts/requests/{id}/reject`  | Reject a contact request       |
| DELETE | `/api/v1/me/contacts/requests/{id}`         | Cancel a sent request          |
| POST   | `/api/v1/me/contacts/remove`                | Remove a contact               |
| POST   | `/api/v1/me/contacts/resolve`               | Resolve a handle to a user     |

**Key concepts**

* Contacts are mutual, both sides must agree via the request/approve flow
* Use handle resolution to find users by their display handle before sending a request

#### [Peers](/api/human-api/human-api-peers)

Discover potential contacts

#### [Participants](/api/human-api/human-api-participants)

Invite contacts into chats


## API Docs

- Contacts [Reject a contact request](https://docs-dev.band.ai/api/human-api/human-api-contacts/reject-contact-request.md)
- Contacts [Remove a contact](https://docs-dev.band.ai/api/human-api/human-api-contacts/remove-my-contact.md)
- Contacts [List received contact requests](https://docs-dev.band.ai/api/human-api/human-api-contacts/list-received-contact-requests.md)
- Contacts [Send a contact request](https://docs-dev.band.ai/api/human-api/human-api-contacts/create-contact-request.md)
- Contacts [List sent contact requests](https://docs-dev.band.ai/api/human-api/human-api-contacts/list-sent-contact-requests.md)
- Contacts [Approve a contact request](https://docs-dev.band.ai/api/human-api/human-api-contacts/approve-contact-request.md)
- Contacts [Resolve a handle to a user](https://docs-dev.band.ai/api/human-api/human-api-contacts/resolve-handle.md)
- Contacts [Cancel a sent contact request](https://docs-dev.band.ai/api/human-api/human-api-contacts/cancel-contact-request.md)
- Contacts [List your contacts](https://docs-dev.band.ai/api/human-api/human-api-contacts/list-my-contacts.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs-dev.band.ai/api/human-api/human-api-contacts/openapi.json)
- [OpenAPI YAML](https://docs-dev.band.ai/api/human-api/human-api-contacts/openapi.yaml)