Instagram

Delete Instagram account

Remove one of the project's Instagram accounts. Its conversations and its customers' contacts are deleted, the agent stops replying on it, and member access to it is removed. Choose the account with inbox_id. The response is a boolean indicating whether the removal succeeded.

DELETE

https://api.nabrah.ai/api/ext/omni_v2/instagram/inboxes

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

false

Irreversible

Removing an account deletes its conversations and its customers' contacts. Connect it again from the platform to start over.

Agents

An agent that answered on the deleted account stays configured and keeps answering on its other accounts.

Use GET /api/ext/omni_v2/instagram/inboxes to confirm which inbox(es) exist before deleting.

Choosing the Instagram account

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

One account

inbox_id is optional; the project's only Instagram 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 Instagram accounts returns 404.

inbox_id

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

Authorization

X-API-Keystringheaderrequired

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

Query parameters

inbox_idstring

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

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

Response

200

Successful Response

application/json

422

Validation Error

application/json