Generated from the API's OpenAPI spec, so it always matches what the API serves.
Chat channels, conversations and their messages, and chat contacts.
Generated from the API's OpenAPI spec: 12 operations. Request and response bodies for each are in the API reference. The MCP tool column names the tool in Finn's MCP server that makes the same call.
Chat
| Endpoint | What it does | Scope | MCP tool | Notes |
|---|---|---|---|---|
GET /chat/channels | List chat channels | chat:read | send_message_to_contact | |
GET /chat/conversations | List conversations | chat:read | list_conversations | cursor pages |
POST /chat/conversations | Start a conversation | chat:write | send_message_to_contact | Idempotency-Key; can be held: 202 pending_approval |
GET /chat/conversations/{id} | Get a conversation | chat:read | read_conversation | |
GET /chat/conversations/{id}/messages | List messages | chat:read | read_conversation | cursor pages |
POST /chat/conversations/{id}/messages | Send a message | chat:write | send_message_to_contact | Idempotency-Key; can be held: 202 pending_approval |
GET /chat/contacts | List chat contacts | chat:read | list_chat_contacts | cursor pages |
GET /chat/contacts/{id} | Get a chat contact | chat:read | get_chat_contact | |
PATCH /chat/contacts/{id} | Update a chat contact | chat:write | update_chat_contact | can be held: 202 pending_approval |
GET /chat/agents/{agent_id} | Get a chat agent's settings | chat:read | chat_get_agent | |
PATCH /chat/agents/{agent_id} | Change a chat agent's settings | chat:write | chat_update_agent | Idempotency-Key; can be held: 202 pending_approval |
POST /chat/agents/{agent_id}/test_turn | Test a chat agent | chat:write | chat_test_agent | Idempotency-Key |