Nexvio API

The Nexvio REST API lets you programmatically manage every aspect of your AI-powered customer service platform — bots, conversations, knowledge sources, and third-party integrations. All requests use HTTPS and return JSON.

Base URL

https://api.nexvio.ai/v1

Authentication

All API requests require a bearer token. Generate an API key from your Nexvio dashboard under Settings → API Keys, then pass it in every request:

Authorization: Bearer <YOUR_API_KEY>

Keep your API key private. Rotate it immediately from the dashboard if it is ever exposed.

Core resources

Bots

Create and configure AI chatbot agents. Set the system prompt, choose the underlying model, attach knowledge sources, and control deployment channels.

Method	Path	Description
`GET`	`/bots`	List all bots
`POST`	`/bots`	Create a bot
`GET`	`/bots/:id`	Retrieve a bot
`PATCH`	`/bots/:id`	Update a bot
`DELETE`	`/bots/:id`	Delete a bot

Conversations

Access full conversation history, individual messages, and metadata for every chat session handled by your bots.

Method	Path	Description
`GET`	`/conversations`	List conversations
`GET`	`/conversations/:id`	Retrieve a conversation
`GET`	`/conversations/:id/messages`	List messages in a conversation

Knowledge sources

Upload documents, sync URLs, or connect data integrations that your bots use to answer questions accurately.

Method	Path	Description
`GET`	`/knowledge`	List knowledge sources
`POST`	`/knowledge`	Add a knowledge source
`DELETE`	`/knowledge/:id`	Remove a knowledge source

Integrations

Connect Nexvio to external platforms (Slack, Zoom, Zapier, and more) and manage those connections programmatically.

Method	Path	Description
`GET`	`/integrations`	List active integrations
`POST`	`/integrations`	Enable an integration
`DELETE`	`/integrations/:id`	Disable an integration

Errors

The API uses standard HTTP status codes. Error responses include a JSON body with a message field describing the problem.

Status	Meaning
`400`	Bad request — invalid parameters
`401`	Unauthorized — missing or invalid API key
`403`	Forbidden — insufficient permissions
`404`	Not found
`429`	Rate limit exceeded — retry after the indicated delay
`500`	Internal server error

Rate limits

Requests are rate-limited per API key. The current limits are returned in response headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 998
X-RateLimit-Reset: 1714900800

Getting started

Sign in to your Nexvio dashboard and navigate to Settings → API Keys.
Click Generate new key and copy the token — it will only be shown once.

Make your first request:

curl https://api.nexvio.ai/v1/bots \
  -H "Authorization: Bearer YOUR_API_KEY"

Explore the resource sections above to build your integration.

Support

If you run into issues or have questions about the API, reach out to us at support@nexvio.ai or visit our contact page.