Data Talks
    Docs

    API Reference

    Every endpoint, every webhook, every tool call. The complete reference for the Data Talks REST API.

    Get StartedGitHub README
    Authentication

    Two ways to authenticate

    JWT Bearer Token

    Use email/password to get a JWT token via /auth/login. Pass it as a Bearer token in the Authorization header for all subsequent requests.

    API Key (X-API-Key)

    Generate API keys (dtk_ prefix) per agent. Pass via X-API-Key header. Ideal for programmatic access and integrations.

    Authentication

    POST/auth/register
    POST/auth/login
    GET/auth/me

    Agents

    GET/agents
    POST/agents
    PATCH/agents/{id}
    DELETE/agents/{id}
    GET/agents/{id}/sources

    Question API

    POST/ask
    POST/v1/ask

    Data Sources

    GET/sources
    POST/sources
    POST/sources/upload
    DELETE/sources/{id}
    GET/sources/{id}/preview

    Reports

    GET/reports
    POST/reports
    POST/reports/{id}/run

    Webhooks

    GET/webhooks
    POST/webhooks
    DELETE/webhooks/{id}

    Alerts

    GET/alerts
    POST/alerts
    POST/alerts/{id}/test
    GET/alerts/{id}/history

    API Keys

    GET/api-keys
    POST/api-keys
    DELETE/api-keys/{id}

    LLM Configuration

    GET/llm/configs
    POST/llm/configs
    GET/llm/health
    Webhooks

    Outgoing webhook events

    Configure outgoing webhooks per agent. Each event is signed with HMAC-SHA256 for verification. Custom headers supported.

    Supported events

    alert.executedreport.generated

    Signature verification

    HMAC-SHA256(secret, payload_body) → X-Webhook-Signature