Export & Test

The entire v3 API is available as machine-readable files you can import into your favourite API client and start testing in seconds. Pick whichever format your tool prefers — both cover every v3 endpoint.

Download OpenAPI

OpenAPI 3.1 spec. Import into Hoppscotch, Insomnia, Postman, Bruno, or generate client SDKs.

Download Postman Collection

Postman Collection v2.1 with Bearer auth and the X-Subaccount-Id header pre-wired. One-click import into Postman.

If a link opens the JSON in your browser instead of downloading, right-click it and choose Save Link As….

Set two variables, then send any request

Both files use placeholder variables so you only configure auth once. After importing, set:

Variable	What it is	Sent as
`apiKey`	Your v3 key (`ask_live_…`) from Settings → API Keys	`Authorization: Bearer {{apiKey}}`
`subaccountId`	The subaccount you’re targeting	`X-Subaccount-Id: {{subaccountId}}` header

baseUrl defaults to https://api.assistable.ai and rarely needs changing.

Import instructions

Postman
Hoppscotch
Insomnia
curl / SDKs

Download the Postman Collection above.
In Postman, click Import (top-left) and drop in the file.
Open the new Assistable v3 API collection → Variables tab.
Set apiKey and subaccountId, then Save.
Open any request and hit Send.

Prefer the live, always-current spec? You can also import the OpenAPI file in Postman the same way — it auto-generates the same folders.

Download the OpenAPI file above.
In Hoppscotch, open the Collections panel → Import / Export → Import from OpenAPI and select the file.
Open the imported collection’s Headers/Authorization and add your Bearer token plus the X-Subaccount-Id header.
Send any request.

Hoppscotch can also import directly from a URL — paste the link to openapi.json from this page if you’d rather not download it.

Download the OpenAPI file above.
In Insomnia: Create → Import → From File and choose it.
Insomnia builds a request for every endpoint. Add your Bearer token and X-Subaccount-Id header, then send.

The OpenAPI spec also feeds code generators. For example, with openapi-generator:

openapi-generator-cli generate \
  -i https://api.assistable.ai/v3/openapi.json \
  -g typescript-fetch \
  -o ./assistable-client

Or just call an endpoint directly:

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

Getting Started

SDKs & Tools

Guides

Download OpenAPI

Download Postman Collection

Set two variables, then send any request

Import instructions

Download OpenAPI

Download Postman Collection

​Set two variables, then send any request

​Import instructions

Set two variables, then send any request

Import instructions