Skip to main content

Usage

Access this class through the composio.experimental property:

Properties

Methods

updateAcl() (deprecated)

DeprecatedUse composio.connectedAccounts.updateAcl(...) instead — ACL updates graduated onto the connectedAccounts mount. This experimental alias is kept only for backwards compatibility and will be removed once the API graduates. Prefer the connectedAccounts mount; do not generate new code against this alias.
Compatibility alias for composio.connectedAccounts.updateAcl(...). Update the per-user ACL on a SHARED connected account. Experimental — shape may change in future releases. Only meaningful for SHARED connections — calling this on a PRIVATE connection raises ComposioAclOnlyForSharedError (400). ACL writes require the connection’s creator or an API key. PATCH semantics: omit a field to leave it unchanged; pass an empty array to clear an allow/deny list. At least one field must be provided. Resolution rule (deny wins):
  1. requesting userId in notAllowedUserIds → DENY
  2. allowAllUsers === true → ALLOW
  3. requesting userId in allowedUserIds → ALLOW
  4. otherwise → DENY
Parameters Returns Promise<ConnectedAccountPatchResponse> — The PATCH response (\{ id, status, success \}). To read the updated ACL block, call composio.connectedAccounts.get(nanoid) after the promise resolves and inspect account.experimental?.aclConfigForShared. Example
Empty-array semantics — read carefully. Passing [] for either list replaces the list, it does not extend it:
  • allowedUserIds: [] → revoke all previously-granted user IDs (state reverts to deny-by-default unless allowAllUsers is true).
  • notAllowedUserIds: [] → clears the deny list, which silently re-grants access to users you previously blocked. Always pair an empty deny list with a deliberate audit of the allow side.