Integrating with Our Platform API

indigo.ai's platform exposes a GraphQL API for full programmatic access to your AI Agents and a small set of REST endpoints for operational integrations. Whether you're looking to automate workflows, extract data for analysis, or enhance integrations across your tech stack, our APIs provide all the tools you need to extend your virtual assistant's capabilities.

The two surfaces complement each other:

• GraphQL API — flexible, schema-driven access to conversations, messages, users, and configuration. Best for custom integrations, data extraction, and bulk operations.

• REST endpoints — purpose-built for specific operational use cases:

  • Non-Conversational Triggers to start sessions from external events.

  • Analytics REST API for daily, pre-aggregated KPIs to feed dashboards and BI tools.

For a primer on how indigo.ai groups messages into chats and conversations, see Sessions.

🔧 What You Can Do with the API

Our APIs support a wide range of use cases, including:

• Data Extraction: Retrieve detailed records of conversations, agent responses, and user feedback to integrate with internal systems.

• Bulk Updates: Automate large-scale updates to your AI Agents data sources, like knowledge base articles and user profiles.

• Custom Analytics: Build personalized dashboards using real-time chat, agent, and user data.

📘 API Documentation & Endpoint

🔗 Documentation

You can find the latest technical details and schema definitions here: Indigo.ai API docs.

The core API is GraphQL. You can access it via a dedicated GraphQL client or any standard HTTP client by following the appropriate format. Specific REST endpoints are documented in their own pages — see Non-Conversational Triggers and the Analytics REST API.

🌐 API Endpoint

All API requests should be directed to: https://platform.indigo.ai/graphql

Use the POST HTTP method for all calls.

🔐 Authentication

Authentication is handled via personal access tokens. All requests must include an Authorization header in the following format:

Authorization: Bearer pat-*your_pat_value*

If you're interested in getting access to our API, please contact us!

Note that API access is a premium feature and incurs an additional cost.

Pagination Model

The API implements the Relay-style cursor-based pagination model. Each query response includes endCursor and hasNextPage fields within the pageInfo object, enabling efficient traversal of large datasets through sequential requests.

Example Use Cases

Here are practical examples of how you can leverage our APIs.

📤 Get All Chats from a Workspace

Use the conversations query to retrieve all chat sessions:

query Conversations(
    $projectId: Int_ID!
    $order: SortType
    $cursor: String
  ) {
    conversations(
      projectId: $projectId
      env: PRODUCTION
      order: $order
      first: 50
      after: $cursor
    ) {
      edges {
        node {
          conversationId
        }
      }
      pageInfo {
        endCursor
        hasNextPage
      }
      totalCount
    }
  }

Output structure

Once the query is executed with the required parameters, the API returns a response structured as follows:

{
    "data": {
        "conversations": {
            "edges": [
                {
                    "node": {
                        "conversationId": "1734638990"
                    }
                },
                {
                    "node": {
                        "conversationId": "1732637760"
                    }
                },
                {
                    "node": {
                        "conversationId": "1736755112"
                    }
                },
								(...)
            ],
            "pageInfo": {
                "endCursor": "dmVyc2VtY3Vyc20yOjE3MzQyNzA0LFBST0RVE1RJT04=",
                "hasNextPage": true
            },
            "totalCount": 1017
        }
    }
}

💬 Get All Messages from a Chat

Once you have a conversationId, use the messages query to extract every message:

query Messages(
    $conversationId: Int_ID!
    $before: String
    $last: Int
  ) {
    messages(
      conversationId: $conversationId
      env: PRODUCTION
      showFeedback: true
      last: $last
      before: $before
    ) {
      edges {
        node {
          id
			    content
			    sender {
			      id
			    }
			    insertedAt
			    conversationId
			    feedback
			    read
        }
      }
      pageInfo {
        endCursor
        hasNextPage
      }
      totalCount
    }
  }

Output structure

{
    "data": {
        "messages": {
            "edges": [
                {
                    "node": {
                        "content": {
                            "hidden": false,
                            "sender": "642981ee976e2w9fba60hf17",
                            "text": "OK THANKS",
                            "timestamp": 1680181239415,
                            "type": "text"
                        },
                        "conversationId": "17536399072",
                        "feedback": null,
                        "id": "37029883512",
                        "insertedAt": "2023-03-30T13:01:16",
                        "read": null,
                        "sender": {
                            "id": "17356397290"
                        }
                    }
                },
                {
                    "node": {
                        "content": {
                            "messages": [
                                {
                                    "input": {
                                        "type": "text"
                                    },
                                    "messages": [
                                        {
                                            "data": {
                                                "text": "For further information, please contact our office"
                                            },
                                            "type": "text"
                                        }
                                    ]
                                }
                            ]
                        },
                        "conversationId": "12363590",
                        "feedback": null,
                        "id": "378200345",
                        "insertedAt": "2023-03-30T13:00:43",
                        "read": "2023-03-30T13:00:07",
                        "sender": null
                    }
                }
                (...)
            ],
            "pageInfo": {
                "endCursor": "dmVyc2VfY3Vyc00yOjM3MDI4jHM1",
                "hasNextPage": false
            },
            "totalCount": 12
        }
    }
}

Messages are returned in reverse chronological order (newest first). To navigate through paginated results, use the before argument in the same way you would use after.

Within each message object:

• The sender field indicates the origin of the message. If the value is null, the message was sent by the virtual assistant; otherwise, it contains an object representing the user (bot_user.id).

• The actual message content is located in the content field.

👥 Get All Users in a Workspace

Use the userRoles query to retrieve users and their roles:

query {
    userRoles(
      projectId: 39
      first: 100
    ) {
      edges {
        node {
	        role {
	          label
	        }
	        user {
            id
            email
          }
        }
      }
      pageInfo {
        endCursor
        hasNextPage
      }
      totalCount
    }
  }

Output structure

{
    "data": {
        "users": {
            "edges": [
                {
                    "node": {
                        "role": {
                            "label": "admin"
                        },
                        "user": {
                            "id": "1734638990",
                            "email": "[e-mail]"
                        }
                    }
                },
								(...)
            ],
            "pageInfo": {
                "endCursor": "dmVyc2VtY3Vyc20yOjE3MzQyNzA0LFBST0RVE1RJT04=",
                "hasNextPage": true
            },
            "totalCount": 20
        }
    }
}