> For the complete documentation index, see [llms.txt](https://help.blotato.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.blotato.com/api/openapi-reference/inbox.md).

# Inbox

Endpoints related to the unified inbox: chats that merge direct messages and post comments per participant.

## List chats

> Lists the current user's unified chats. Each chat merges a single participant's direct messages and post comments on one connected account, ordered by most recent activity. Supports cursor-based pagination and filtering by platform and account.

```json
{"openapi":"3.0.3","info":{"title":"Blotato API","version":"2.0.0"},"tags":[{"name":"inbox","description":"Endpoints related to the unified inbox: chats that merge direct messages and post comments per participant."}],"servers":[{"url":"https://backend.blotato.com","description":"Blotato API Server"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","name":"blotato-api-key","in":"header"}}},"paths":{"/v2/inbox/chats":{"get":{"summary":"List chats","tags":["inbox"],"description":"Lists the current user's unified chats. Each chat merges a single participant's direct messages and post comments on one connected account, ordered by most recent activity. Supports cursor-based pagination and filtering by platform and account.","parameters":[{"schema":{"minimum":1,"maximum":250,"default":50,"type":"integer"},"in":"query","name":"limit","required":false,"description":"Maximum number of chats to return. Defaults to 50."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor returned by a previous call. Pass it to fetch the next page."},{"schema":{"type":"array","items":{"type":"string","enum":["bluesky","facebook","instagram","twitter"]}},"in":"query","name":"platform","required":false,"description":"Filter chats by platform. Pass multiple values to include any of them."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"description":"List of chats.","type":"array","items":{"type":"object","properties":{"id":{"description":"Opaque chat id encoding the platform, account, and participant.","type":"string"},"platform":{"type":"string","enum":["bluesky","facebook","instagram","twitter"]},"accountId":{"description":"ID of the social account this chat belongs to.","type":"string"},"participantId":{"description":"Platform-native id of the participant.","type":"string"},"lastActivityAt":{"type":"string"},"lastItem":{"type":"object","properties":{"kind":{"type":"string","enum":["message","comment"]},"text":{"type":"string"},"createdAt":{"type":"string"}},"required":["kind","text","createdAt"]}},"required":["id","platform","accountId","participantId","lastActivityAt","lastItem"]}},"cursor":{"description":"Cursor for the next page. Absent when there are no more chats.","type":"string"}},"required":["items"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"description":"Not found","type":"object","properties":{"code":{"type":"number"},"reqId":{"description":"Request ID for tracking","type":"string"},"message":{"description":"Resource not found","type":"string"}},"required":["message"]}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"description":"Validation error","type":"object","properties":{"code":{"type":"number"},"reqId":{"description":"Request ID for tracking","type":"string"},"message":{"description":"Validation error","type":"string"}},"required":["message"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"description":"Server error","type":"object","properties":{"code":{"type":"number"},"reqId":{"description":"Request ID for tracking","type":"string"},"message":{"description":"An error occurred","type":"string"}},"required":["message"]}}}}}}}}}
```

## List chat items

> Lists the merged timeline of direct messages and post comments for a single chat, ordered by creation time (most recent first). Supports cursor-based pagination.

```json
{"openapi":"3.0.3","info":{"title":"Blotato API","version":"2.0.0"},"tags":[{"name":"inbox","description":"Endpoints related to the unified inbox: chats that merge direct messages and post comments per participant."}],"servers":[{"url":"https://backend.blotato.com","description":"Blotato API Server"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","name":"blotato-api-key","in":"header"}}},"paths":{"/v2/inbox/chats/{chatId}/items":{"get":{"summary":"List chat items","tags":["inbox"],"description":"Lists the merged timeline of direct messages and post comments for a single chat, ordered by creation time (most recent first). Supports cursor-based pagination.","parameters":[{"schema":{"minimum":1,"maximum":250,"default":50,"type":"integer"},"in":"query","name":"limit","required":false,"description":"Maximum number of chat items to return. Defaults to 50."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor returned by a previous call. Pass it to fetch the next page."},{"schema":{"type":"string"},"in":"path","name":"chatId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"description":"Merged list of messages and comments.","type":"array","items":{"type":"object","discriminator":{"propertyName":"kind"},"oneOf":[{"type":"object","properties":{"conversationId":{"description":"Parent Blotato conversation id.","type":"string","nullable":true},"createdAt":{"type":"string"},"errorCode":{"description":"Set only when status is `failed`.","type":"integer","nullable":true},"errorMessage":{"description":"Set only when status is `failed`.","type":"string","nullable":true},"id":{"type":"string"},"platform":{"type":"string","enum":["bluesky","facebook","instagram","twitter"]},"recipientId":{"type":"string"},"senderId":{"type":"string","nullable":true},"status":{"type":"string","enum":["delivered","failed","processing","queued","sent"]},"text":{"type":"string"},"kind":{"type":"string","enum":["message"]},"direction":{"type":"string","enum":["inbound","outbound"]}},"required":["conversationId","createdAt","errorCode","errorMessage","id","platform","recipientId","senderId","status","text","kind","direction"]},{"type":"object","properties":{"accountId":{"description":"ID of the social account this comment belongs to.","type":"string"},"authorId":{"description":"Platform-native id of the comment author.","type":"string","nullable":true},"createdAt":{"type":"string"},"errorCode":{"description":"Set only when status is `failed`.","type":"integer","nullable":true},"errorMessage":{"description":"Set only when status is `failed`.","type":"string","nullable":true},"id":{"type":"string"},"platform":{"type":"string","enum":["facebook","instagram","twitter"]},"platformCommentId":{"description":"Platform-native id of the comment.","type":"string","nullable":true},"platformPostId":{"description":"Platform-native id of the parent post being commented on.","type":"string"},"postId":{"description":"Blotato ID of the post (if published through Blotato).","type":"string","nullable":true},"status":{"type":"string","enum":["deleted","failed","posted","processing","queued"]},"text":{"type":"string"},"kind":{"type":"string","enum":["comment"]}},"required":["accountId","authorId","createdAt","errorCode","errorMessage","id","platform","platformCommentId","platformPostId","postId","status","text","kind"]}]}},"cursor":{"description":"Cursor for the next page. Absent when there are no more items.","type":"string"}},"required":["items"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"description":"Not found","type":"object","properties":{"code":{"type":"number"},"reqId":{"description":"Request ID for tracking","type":"string"},"message":{"description":"Resource not found","type":"string"}},"required":["message"]}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"description":"Validation error","type":"object","properties":{"code":{"type":"number"},"reqId":{"description":"Request ID for tracking","type":"string"},"message":{"description":"Validation error","type":"string"}},"required":["message"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"description":"Server error","type":"object","properties":{"code":{"type":"number"},"reqId":{"description":"Request ID for tracking","type":"string"},"message":{"description":"An error occurred","type":"string"}},"required":["message"]}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.blotato.com/api/openapi-reference/inbox.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.