Introduction

The v3 API is the supported, public interface to Assistable. Every endpoint lives under /v3 so it’s clear which version you’re calling.

https://api.assistable.ai/v3

What’s new in v3

Scoped API keys — a key is bound to a workspace and one or more subaccounts, with fine-grained resource:action scopes.
Predictable rate limits — per-subaccount burst and daily limits, with X-RateLimit-* headers on every response.
Interactive reference — try any endpoint from the browser using the API Reference tab.

Create an API key

In the dashboard, open Settings → API Keys and create a key. Copy it — the secret (ask_live_…) is shown only once.

Call an endpoint

Pass the key as a Bearer token and select the target subaccount with the X-Subaccount-Id header.

curl https://api.assistable.ai/v3/assistants \
  -H "Authorization: Bearer ask_live_xxx" \
  -H "X-Subaccount-Id: sub_123"

Explore

Browse the API Reference tab and run requests directly in the playground.

All responses use the envelope { "data": ..., "error": ..., "request_id": ... }.
Timestamps are ISO-8601 UTC.
subaccount_id in a request body is accepted as an alias for the X-Subaccount-Id header (and for the legacy location_id).