Get Started

Base URL

https://api.vitae.ai/v1

All endpoints are prefixed with /v1. The API returns JSON.

1. Get an access token

Use an organization token issued by the Vitae.ai team, or an app session token from your authenticated workspace.

Verify the token:

curl https://api.vitae.ai/v1/auth/verify \
  -H "Authorization: Bearer <accessToken>"

Response:

{
  "status": "OK"
}

2. Call a protected endpoint

Pass the token as a Bearer header on every subsequent request:

curl https://api.vitae.ai/v1/clients \
  -H "Authorization: Bearer <accessToken>"

Explore the full API

The interactive API Reference documents every endpoint with request/response schemas and a live “try it out” interface.

Local development

Clone the repo and start the stack:

bun install
cp apps/api/.env.example apps/api/.env.local
bun run dev:api   # API on http://localhost:3000
bun run dev:app   # App on http://localhost:3001
bun run dev:docs  # Docs on http://localhost:3002

The Swagger UI is available locally at http://localhost:3000/v1/docs.