API introduction

The Embedded API lets you integrate Querio's agentic data analysis directly into your own product.

The current API version is v2. It is built around conversations, multi-turn follow-ups, and asset-backed charts and tables.

v2 supports both testing and production environments, so you can validate your integration before sending production traffic through it.

Quick start

1. Create an API token in Querio under Embedded API token management
2. Make your first request:

curl -X POST https://app.querio.ai/api/v2/embed/{customer_slug}/conversations \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "How many shipments happened in the last 30 days",
    "datasourceId": "your_dataset_id",
    "model": "claude-sonnet-4-6",
    "scope": {
      "customer_id": "your_customer_id"
    },
    "environment": "production",
    "tags": {
      "user_id": "your_user_id"
    }
  }'

API v2: conversations

v2 introduces conversations as the top-level entity.

A conversation stores the full message history. Each user-assistant pair is a turn. This enables multi-turn follow-ups, tagging for filtering and organization, and structured assets for tables and charts returned in assistant message parts.

• POST /v2/embed/{customer_slug}/conversations - Start a new conversation
• POST /v2/embed/{customer_slug}/conversations/{conversationId}/turns - Add a follow-up turn
• GET /v2/embed/{customer_slug}/conversations - List conversations with filtering and pagination
• GET /v2/embed/{customer_slug}/conversations/{conversationId} - Get a conversation and its full message history
• GET /v2/embed/{customer_slug}/conversations/{conversationId}/assets/{cellId} - Fetch table data or Vega-Lite chart assets referenced by message parts

Message parts and assets

Assistant messages can include structured parts in addition to plain text:

• text - plain text content to render directly
• data-table - a reference to a paginated table asset
• data-chart - a reference to a Vega-Lite chart asset

For data-table and data-chart parts, use the returned url to fetch the full asset payload.

Each endpoint page includes interactive examples and detailed request and response schemas.

Authentication

All v2 endpoints require a Bearer token in the Authorization header:

Authorization: Bearer <your_token>

Create API tokens in Querio under Embedded API token management. No client ID or client secret is involved in the auth header.

Additional resources

Run in Postman

Import the collection directly into your Postman workspace with one click:

OpenAPI spec

Use the OpenAPI file with other API clients like Insomnia:

• openapi-v2.yml