integrations

Start an OAuth connect flow

Returns a provider connect URL/token the dashboard opens to authorize an app.

post/v1/integrations/connect-session

Request

  • Base URL: https://api.patricia.app (the document declares no server; this is the origin it was published from)
  • URL: https://api.patricia.app/v1/integrations/connect-session
  • Auth: HTTP bearer

Headers

X-Tenant-Idstring nullable

Request body

app_slugstring required
visibility'team' | 'personal'

Who, within a tenant, may use a connected account's tools.

TEAM: any actor in the tenant. PERSONAL: only the actor who connected it. Designed to extend to a GROUP scope later (the Groups model is already on main).

environment'sandbox' | 'production' nullable

Response

Successful Response

providerstring required
app_slugstring required
connect_urlstring nullable
connect_tokenstring nullable
flowstring
attempt_idstring uuid nullable

Changes

No recorded changes to this operation across all 1 revision of this API.