Initiate Service Authorization

Initiate the OAuth 2.0 authorization flow for a specified third-party service. The frontend provides requested_scopes and a redirect_url for post-auth callback.

Initiate the OAuth 2.0 authorization flow for a specified third-party service.

• Method: POST
• Path: /api/v1/services/authorize/{service_name}

Path Parameter

• service_name (string, required): The name of the service

Request Body

Refer to the ServiceAuthorizationRequest schema in the OpenAPI playground.

Response

Returns a ServiceAuthorizationResponse object on success.

Authorizations

Authorization · string · header · required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

service_name · string · required

Body

application/json

Response

200

application/json

Successful Response

The response is of type object.