Popup-aware OAuth callback (Plan 209-02)
GET
/api/v1/connectors/{slug}/oauth/callback
const url = 'https://api.ultimateteam.ai/api/v1/connectors/example/oauth/callback?ui=popup';const options = {method: 'GET', headers: {'X-API-Key': '<X-API-Key>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.ultimateteam.ai/api/v1/connectors/example/oauth/callback?ui=popup' \ --header 'X-API-Key: <X-API-Key>'Handles the OAuth provider redirect for both popup and fullpage flows. Performs atomic rollback so a failed token exchange leaves no orphan connector row. Returns popup HTML (for ?ui=popup) or RedirectResponse to /settings/connectors (for ?ui=fullpage).
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”slug
required
Slug
string
Query Parameters
Section titled “Query Parameters”ui
Ui
string
Responses
Section titled “ Responses ”Successful Response
Media typetext/html
string
Validation Error
Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationErrorobject
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{ "detail": [ { "ctx": {}, "input": "example", "loc": [ "example" ], "msg": "example", "type": "example" } ]}