v1

latestOpenAPI 3.1.02026-07-264048103.1 KB

Auth Service (v2)

Oauth Setup Callback

Handle OAuth setup callback redirect from GitHub Apps.

This endpoint handles the "Setup URL" callback from GitHub Apps, which is triggered when a user installs or updates their GitHub App installation.

For "update" actions (user modified repo access via GitHub), we just show a success page since no token exchange is needed.

For new installations with code/state, we process similar to the regular OAuth callback.

get/v2/auth/setup/{provider_id}

provider_idstring required

codestring

Authorization code from OAuth provider

statestring

State parameter containing auth_id

setup_actionstring

Setup action from GitHub App

installation_idinteger

GitHub App installation ID

errorstring

Error code from OAuth provider

error_descriptionstring

Error description from OAuth provider

Successful Response

{"stackTrail":"paths:/v2/auth/setup/{provider_id}:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}