# TikTok API

Work the conversations of connected TikTok accounts and put an agent on each account.

- [List TikTok accounts](https://www.nabrah.ai/en/docs/api-reference/tiktok/list-tiktok-accounts.md) `GET /api/ext/omni_v2/tiktok/inboxes`: List the TikTok accounts connected to the project, oldest first.
- [Get TikTok account](https://www.nabrah.ai/en/docs/api-reference/tiktok/get-tiktok-account.md) `GET /api/ext/omni_v2/tiktok/inboxes/{inbox_id}`: Retrieve one of the project's TikTok accounts by its id: id, name, username, avatar_url, disconnected, created_at, and the agent answering on it (agent_id and agent_name, null when none).
- [Delete TikTok account](https://www.nabrah.ai/en/docs/api-reference/tiktok/delete-tiktok-account.md) `DELETE /api/ext/omni_v2/tiktok/inboxes`: Remove one of the project's TikTok accounts.
- [List TikTok conversations](https://www.nabrah.ai/en/docs/api-reference/tiktok/list-tiktok-conversations.md) `GET /api/ext/omni_v2/tiktok`: List TikTok conversations (tickets) on one of the project's TikTok accounts, with optional filtering by assignment and status.
- [Filter TikTok conversations](https://www.nabrah.ai/en/docs/api-reference/tiktok/filter-tiktok-conversations.md) `POST /api/ext/omni_v2/tiktok/filter`: List TikTok conversations on one of the project's TikTok accounts using a structured filter payload instead of simple query parameters.
- [List TikTok conversations by contact](https://www.nabrah.ai/en/docs/api-reference/tiktok/list-tiktok-conversations-by-contact.md) `POST /api/ext/omni_v2/tiktok/contact/{contact_id}`: Lists the TikTok conversations of the contact identified by contact_id on one of the project's TikTok accounts, with optional server-side filtering in the request body and pagination via the page query parameter.
- [Assign an agent to a TikTok account](https://www.nabrah.ai/en/docs/api-reference/tiktok/assign-an-agent-to-a-tiktok-account.md) `POST /api/ext/omni_v2/tiktok/assign_chatbot`: Attach an AI agent to one of the project's TikTok accounts so it automatically replies to incoming TikTok direct messages on that account.
- [Get the agent on a TikTok account](https://www.nabrah.ai/en/docs/api-reference/tiktok/get-the-agent-on-a-tiktok-account.md) `GET /api/ext/omni_v2/tiktok/get_chatbot`: Retrieve the agent currently answering on one of the project's TikTok accounts.
- [Remove the agent from a TikTok account](https://www.nabrah.ai/en/docs/api-reference/tiktok/remove-the-agent-from-a-tiktok-account.md) `DELETE /api/ext/omni_v2/tiktok/unassign_chatbot`: Remove the agent from one of the project's TikTok accounts, stopping automatic AI replies on that account.