Skip to content

API Endpoints

https://auth.beshoy.ai
MethodPathAuthDescription
GET/oauth/authorizeNoneAuthorization page (renders login UI)
POST/oauth/tokenClient credentialsExchange code or refresh token
POST/oauth/revokeNoneRevoke a refresh token
MethodPathAuthDescription
POST/auth/loginNonePassword login (JSON)
POST/auth/login-formNonePassword login (form)
POST/auth/pinNonePIN login (JSON)
POST/auth/pin-formNonePIN login (form)
POST/auth/signupNoneCreate account (JSON)
POST/auth/signup-formNoneCreate account (form)
POST/auth/magic-link/sendNoneSend magic link email
GET/auth/magic-link/verifyNoneVerify magic link token
MethodPathAuthDescription
GET/.well-known/openid-configurationNoneOIDC discovery
GET/.well-known/jwks.jsonNonePublic keys (ES256)
GET/oidc/authorizeNoneOIDC authorization
POST/oidc/tokenBasic / bodyOIDC token exchange

All admin endpoints require Authorization: Bearer <token> with admin role.

MethodPathAuthDescription
GET/admin/projectsSuper-adminList all projects
POST/admin/projectsSuper-adminCreate project
GET/admin/projects/:idAdminGet project details
PATCH/admin/projects/:idAdminUpdate project
MethodPathAuthDescription
GET/admin/projects/:id/usersAdminList project users
PATCH/admin/projects/:id/users/:userIdAdminUpdate user role/status
DELETE/admin/projects/:id/users/:userIdAdminRemove user from project
MethodPathAuthDescription
GET/admin/projects/:id/sessionsAdminList active sessions
DELETE/admin/projects/:id/sessions/:tokenIdAdminRevoke session
POST/admin/projects/:id/sessions/revoke-allAdminRevoke all sessions
POST/admin/projects/:id/sessions/revoke-manyAdminBulk revoke (up to 100)
MethodPathAuthDescription
GET/admin/projects/:id/pinsAdminList PINs
POST/admin/projects/:id/pinsAdminCreate PIN
PATCH/admin/projects/:id/pins/:pinIdAdminRevoke PIN
MethodPathAuthDescription
POST/admin/projects/:id/rate-limits/resetAdminClear rate limit counters
MethodPathAuthDescription
GET/healthNoneService health check