v1

latestOpenAPI 3.1.02026-07-2617125852.3 KB

OAuth

Initialize microsoft oauth

Creates an OAuth session and returns the Microsoft authorization URL. The user should be redirected to auth_url to complete the OAuth flow. Poll the status endpoint to check for completion.

Special rate limits (stricter than the standard API rate limit) to comply with upstream Microsoft rate limits:

75 requests per minute per workspace
150 requests per minute per IP

If Microsoft's upstream OAuth service is temporarily unavailable, requests may return 503.

post/api/v2/oauth/microsoft/init

Response

Default Response

session_idstring

Session ID for polling status

auth_urlstring

Microsoft authorization URL to redirect user to

expires_atstring date-time

Session expiry time (10 minutes from creation)

Example response

{
  "session_id": "abc123def456",
  "auth_url": "https://login.microsoftonline.com/common/oauth2/v2.0/authorize?...",
  "expires_at": "2026-01-14T12:30:00.000Z"
}