Api referenceAuth
Auth
Auth API endpoints
Auth API
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/auth/accept-invite | AcceptInvitation accepts a team invitation and sets up the user account |
POST | /v1/auth/authenticate | Authenticate exchanges an OAuth code for a session (Cloud only) |
POST | /v1/auth/invite | InviteTeamMember sends an invitation to join the team (checks seat limit) |
DELETE | /v1/auth/invite/{invitationId} | RevokeInvitation revokes a pending invitation |
POST | /v1/auth/login | Login authenticates with email and password - Self-hosted only |
POST | /v1/auth/magic-link | RequestMagicLink sends a magic link email for passwordless login - Self-hosted only |
GET | /v1/auth/mode | GetAuthMode returns the authentication mode (cloud vs self-hosted) |
POST | /v1/auth/refresh | RefreshSession extends the current session |
POST | /v1/auth/register | Register creates the first admin user (becomes instance owner) - Self-hosted only |
GET | /v1/auth/session | GetSession returns the current user session if authenticated |
POST | /v1/auth/signout | SignOut invalidates the current session |
POST | /v1/auth/sso-url | GetAuthURL returns the SSO provider URL for sign-in redirect (Cloud only) |
GET | /v1/auth/team | ListTeamMembers returns all team members and pending invitations |
DELETE | /v1/auth/team/{userId} | RemoveTeamMember removes a user from the team |
POST | /v1/auth/verify-magic-link | VerifyMagicLink verifies a magic link token and creates a session - Self-hosted only |