v1

latestOpenAPI 3.1.02026-07-2617125852.3 KB

OAuth

Get oauth session status

Poll this endpoint to check the OAuth session result. Works for both Google and Microsoft OAuth sessions. Returns pending while waiting, success with account details when complete, or error if something went wrong. Sessions expire after 10 minutes.

get/api/v2/oauth/session/status/{sessionId}

Path parameters

sessionIdstring required

Example:abc123def456

Session ID from init response

Response

Default Response

status'pending' | 'success' | 'error' | 'expired'

Current status of the OAuth session

emailstring

Email of the connected account (on success)

namestring

Name of the account owner (on success)

errorstring

Error code (on error)

error_descriptionstring

Human-readable error description (on error)

Example response

{
  "status": "success",
  "email": "user@example.com",
  "name": "John Doe",
  "error": "access_denied",
  "error_description": "User denied access to the application"
}