The first thing you do is establish an interactive session. Sign in with email and password, get a short-lived JWT back, and confirm which workspace it applies to. If you belong to more than one workspace, switch it now — the Personal Access Token you’ll mint in the next step inherits the workspace active on this session.
Sign in
Save the access token — it’s what you’ll authenticate the next couple of requests with:
Confirm your workspace
Check which workspace (tenant) your session is scoped into, plus every other workspace you have access to:
currentTenantId is the workspace the next actions apply to.
Switch workspace (only if you need to)
If you have more than one membership and need a different active workspace before minting the PAT:
The response returns a new JWT pair scoped to the chosen workspace. Update $JWT with the new access token and re-run /v1/auth/me to confirm.
A JWT lasts one hour by default. Long enough to follow this walkthrough; for anything long-lived, use the Personal Access Token you’re about to mint.
Next: Create a Personal Access Token →