auth

Initiate OAuth Authentication

Changed on Apr 16, 2026

Initiates OAuth authentication flow. Returns OAuth authorization URL for unauthenticated users or home page URL for already authenticated users.

post/bodhi/v1/auth/initiate

Request

Base URL: http://localhost:1135
URL: http://localhost:1135/bodhi/v1/auth/initiate
Auth: one of:
- none
- HTTP bearer
- HTTP bearer
- OAuth 2 (authorization code, authorization URL /bodhi/v1/auth/initiate, token URL /bodhi/v1/auth/callback)

Request body

client_idstring required

The OAuth client_id of the tenant to authenticate with

Example request

{
  "client_id": "my-client-id"
}

Response

User already authenticated, home page URL provided

locationstring required

The URL to redirect to (OAuth authorization URL or application home page)

Example response

{
  "location": "https://oauth.example.com/auth?client_id=test&redirect_uri=..."
}

Changes

Apr 16, 202611825ee4b44d Revision changes
- breaking
  removed 'propertyNames' constraint from the / response property for the status
- breaking
  removed 'propertyNames' constraint from the / response property for the status
- breaking
  removed 'propertyNames' constraint from the / response property for the status
- breaking
  removed 'propertyNames' constraint from the / response property for the status
- breaking
  the / response's property type changed from object null to string null for status
- breaking
  the / response's property type changed from object null to string null for status
- breaking
  the / response's property type changed from object null to string null for status
- breaking
  the / response's property type changed from object null to string null for status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status

Operation history