TikTok

Remove the agent from a TikTok account

Remove the agent from one of the project's TikTok accounts, stopping automatic AI replies on that account. The agent keeps answering on its other accounts with their settings unchanged. The response is an object confirming the operation.

DELETE

https://api.nabrah.ai/api/ext/omni_v2/tiktok/unassign_chatbot

curl --request DELETE \
  --url 'https://api.nabrah.ai/api/ext/omni_v2/tiktok/unassign_chatbot' \
  --header 'X-API-Key: <your-api-key>'

Effect

After unassigning, incoming TikTok direct messages on that account are no longer answered automatically by an AI agent.

Check the current assignment first with GET /api/ext/omni_v2/tiktok/get_chatbot, and re-attach later with POST /api/ext/omni_v2/tiktok/assign_chatbot.

Choosing the TikTok account

A project can connect more than one TikTok account. inbox_id selects the account this call works on.

One account

inbox_id is optional; the project's only TikTok account is used.

More than one account

inbox_id is required and the call returns 400 without it. An id that is not one of the project's TikTok accounts returns 404.

inbox_id

List the accounts and their ids with GET /api/ext/omni_v2/tiktok/inboxes.

Errors

409 Conflict

Another change to the same account's agent is still being saved. Wait a moment, then try again; GET /api/ext/omni_v2/tiktok/get_chatbot shows the result once it is saved.

Authorization

X-API-Keystringheaderrequired

Your workspace API key. Create one in the dashboard under API keys.

Query parameters

inbox_idstring

The id of the TikTok account to use, from GET /api/ext/omni_v2/tiktok/inboxes.

Use inboxes[].id (a UUID), not the numeric inboxes[].inbox_id. Optional while the project has one TikTok account; required once it has more than one.

Response

200

Successful Response

application/json

422

Validation Error

application/json