# Instagram API

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

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