# Conversations

HTML: https://www.app2email.com/docs/api/conversations · Index: https://www.app2email.com/docs/api/llms.txt

One thread per contact: the 24 hour window, its messages and its owner (handoff).

| Method | Path | Summary | Scope | Sandbox key |
| --- | --- | --- | --- | --- |
| GET | `/v1/{number}/conversations` | [The contacts, most recent activity first](https://www.app2email.com/docs/api/conversations/list-conversations.md) | `messages:read` | reads |
| GET | `/v1/{number}/conversations/{phone}/messages` | [One contact's messages, both directions](https://www.app2email.com/docs/api/conversations/list-conversation-messages.md) | `messages:read` | reads |
| GET | `/v1/{number}/conversations/{contact}` | [One contact: window state, last messages, owner](https://www.app2email.com/docs/api/conversations/get-conversation.md) | `messages:read` | reads |
| PUT | `/v1/{number}/conversations/{contact}/owner` | [Hand a contact over: human, agent, paused, or back to normal](https://www.app2email.com/docs/api/conversations/set-conversation-owner.md) | `messages:send` | real change |
