TaadDocs
Help CenterAPIPolicies

Account

GET
/v1/me

What the key is, where it reaches and what it may do. Handy as a first call, and in a test that checks it holds the key it thinks it holds.

Authorization

apiKey
AuthorizationBearer <token>

Authorization: Bearer taad_… (or taadtest_… for the sandbox). Never in a URL, never in a web page.

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/me"
{  "object": "key",  "id": "string",  "name": "string",  "livemode": true,  "kind": "personal",  "workspace": {    "id": "string",    "object": "workspace",    "name": "string",    "kind": "personal"  },  "scopes": [    "recordings:read"  ],  "read_only": true,  "spend_from": "plan_then_wallet",  "weekly_cap_usd": 0,  "expires_at": "string",  "created_at": "string",  "owner": {    "name": "string",    "email": "string"  }}
GET
/v1/workspaces

A personal key reaches its maker's Personal workspace; an organization's key reaches that organization. One item either way.

Authorization

apiKey
AuthorizationBearer <token>

Authorization: Bearer taad_… (or taadtest_… for the sandbox). Never in a URL, never in a web page.

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/workspaces"
{  "object": "list",  "data": [    {      "id": "string",      "object": "workspace",      "name": "string",      "kind": "personal"    }  ],  "has_more": false,  "next_cursor": null}