Account and sign-in

Who am I

GEThttps://voxa.abhinavyadav.in/api/v1/auth/me

The caller, the current workspace and its permissions. Works with an API key too: then the user is the key (key:<name>) with the developer role.

Authorization

An API key (X-API-Key or Authorization: Bearer), or a session token.

X-API-KeyAuthorization: Bearer

Query parameters

timezonestringdefault: "Asia/Kolkata"

IANA time zone for every timestamp in the response (at, date, timestamp and *_at fields), as ISO 8601 with the offset. The X-Timezone header works too; the zone used comes back in the X-Timezone response header. An unknown zone is a 400.

Response

200Success.

See the 200 example next to the code samples.

401No credentials, or they are invalid or revoked.

detailstring

What went wrong, in plain words.

429Over the per-key rate limit; wait for Retry-After.

detailstring

What went wrong, in plain words.

curl --request GET \
  --url 'https://voxa.abhinavyadav.in/api/v1/auth/me?timezone=Asia/Kolkata' \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://voxa.abhinavyadav.in/api/v1/auth/me"
params = {
    "timezone": "Asia/Kolkata",
}
headers = {
    "X-API-Key": "<api-key>",
}

response = requests.get(url, params=params, headers=headers)
print(response.status_code, response.json())

const response = await fetch("https://voxa.abhinavyadav.in/api/v1/auth/me?timezone=Asia/Kolkata", {
  headers: {
    "X-API-Key": "<api-key>",
  },
})
const data = await response.json()
console.log(response.status, data)

Response

{
  "user": {
    "id": "u_2b7c…",
    "name": "Rohan Mehta",
    "email": "rohan@example.com",
    "is_platform_admin": false
  },
  "workspaces": [
    {
      "id": "ws_8d2e…",
      "name": "City Clinic",
      "status": "active",
      "role": "owner"
    }
  ],
  "workspace": {
    "id": "ws_8d2e…",
    "name": "City Clinic",
    "status": "active",
    "credits_paise": 250000
  },
  "role": "owner",
  "permissions": [
    "agents.edit",
    "agents.view",
    "billing.manage",
    "billing.view",
    "calls.place",
    "calls.view",
    "keys.manage"
  ]
}

{
  "detail": "sign in required"
}

{
  "detail": "rate limit exceeded; slow down"
}