Skip to main content

Start the OAuth authorization flow for a tool server.

POST 

/rest/api/v1/tool-servers/:serverId/auth

experimental

Expect changes and instability. Introduced on July 2, 2026. Learn how experimental APIs work.

Initiates the third-party OAuth flow for the specified tool server and returns the authorization URL that the client should navigate the end user to. After the OAuth callback completes, the user's browser is redirected back to returnUrl with query parameters indicating the result.

returnUrl must match the tenant's configured return URL allowlist; otherwise the request is rejected with 400.

Request

Responses

Successful operation