Notrus

Getting Started

The Notrus GraphQL API is a read-only interface to your organization's conversations, messages, and classification catalog. This portal documents every query and lets you try them live from your browser.

Endpoint

All requests are HTTP POST to a single GraphQL endpoint:

endpoint
https://api.hom.notrus.ai/graphql

Make your first request

Authenticate with your API key in the apikey header (see Authentication), then send a GraphQL query:

bash
curl https://api.hom.notrus.ai/graphql \
  -H "Content-Type: application/json" \
  -H "apikey: $NOTRUS_API_KEY" \
  -d '{"query":"{ conversations(first: 5) { edges { node { id conversationId type createdAt } } pageInfo { hasNextPage endCursor } } }"}'

What you can query

  • Conversations — paginated threads with classification metadata.
  • Messages — the messages within a conversation, paginated on demand.
  • Tags & Categories — your organization's classification catalog.

Next steps