integrations

Change a connected account's sharing scope

Switches a connected account between PERSONAL (private to the person who connected it) and TEAM (usable by the whole company). Requires account-edit authority; the service enforces the per-account fence (only the owner can share their own account; a team account can only be made private when it has a single coherent owner) and never discloses another member's private account (a foreign/unknown id 404s). expected_current is a compare-and-set guard: a concurrent flip 409s.

patch/v1/integrations/accounts/{account_id}/visibility

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/accounts/{account_id}/visibility
  • Auth: HTTP bearer

Path parameters

account_idstring uuid required

Headers

X-Tenant-Idstring nullable

Request body

expected_current'team' | 'personal' required

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).

target'team' | 'personal' required

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).

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.