First API Request

Call a workspace-scoped endpoint and verify your auth/session setup.

Example request

Once login and workspace selection are complete, request your customer list.

curl https://localhost:5173/api/customers?status=active \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Workspace-ID: <workspace_id>"

Expected response

A successful response returns customers[] with derived fields like orderLink, aggregates, and status metadata.

Common errors

• 401 INVALID_REFRESH after an expired session
• 403 FORBIDDEN when write permission is not granted
• WORKSPACE_REQUIRED when X-Workspace-ID is missing