List conversations
Your Otter conversations, most recent first, with title, owner, date and summary.
GET https://cotlet.dev/api/v1/otter/conversations
read
Lists conversations you own, most recent first, the same order as My Conversations. Set include_shared to add conversations shared with you, or pass channel_id to list one Channel, which includes shared ones. The summary is Otter's generated summary and is empty while processing is still running. Pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| include_shared boolean | boolean | Also list conversations shared with you. Default: false. |
| channel_id string | string | Only conversations in this Channel, from list_channels. |
| limit integer | integer | Page size. Default: 20. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/otter/conversations \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("otter", "list_conversations")const result = await cotlet.call('otter', 'list_conversations');cotlet call otter list_conversationsExample response
{
"conversations": [
{
"conversation_id": "cv_7f3a91",
"title": "Pricing review with Acme",
"owner": "you@example.com",
"created_at": "2026-10-13T14:00:00Z",
"summary": "The team compared per-seat and flat-rate pricing and agreed to send a revised quote.",
"shared": true
},
{
"conversation_id": "cv_2b84d0",
"title": "Onboarding kickoff",
"owner": "you@example.com",
"created_at": "2026-10-14T09:30:00Z",
"summary": null,
"shared": false
}
],
"next_cursor": "eyJvZmZzZXQiOjIwfQ"
}