integrations

Connect a non-OAuth app with user-supplied credentials

Connects a non-OAuth app with user-supplied credentials. Brokered providers receive their credentials in a provider vault; Patricia seals validated native credential bundles with its account. The account is recorded with its sharing scope and its tools sync after the database commit. Returns the recorded account.

post/v1/integrations/connect-key

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-key
  • Auth: HTTP bearer

Headers

X-Tenant-Idstring nullable

Request body

app_slugstring required
credentialsobject 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).

reconnect_account_idstring uuid nullable
attempt_idstring uuid nullable

Response

Successful Response

idstring uuid required
providerstring required
app_slugstring nullable
status_codestring required
visibility_code'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).

sync_enqueuedboolean nullable

Changes

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