#4509·composio

Clarify deprecated user_id in connected-account responses

Author: brennanbutler01Created Sep 17, 2026Updated Sep 17, 2026
Labelsdocs

This replaces #4508, which I closed because it was filed from the wrong GitHub account. Reposting here from my personal account.

The connected-account response contract is unclear about whether applications can rely on receiving the account owner's user_id.

At next commit 0dae2623c26ec4cb2c523fb4cfa0536ced932348:

Deprecation can reasonably precede removal, so this may be intentional. The missing piece is a clear statement of the supported behavior and migration path.

Why this matters

A project-level reconciliation job needs to distinguish untracked accounts owned by existing application users from potentially orphaned accounts. Without returned ownership, it needs a second paginated listing filtered by existing user identifiers. We want to confirm that this is the supported approach before proposing any SDK change.

Requested clarification

  1. Is returning user_id still supported during deprecation? Does visibility vary by account origin or caller permissions?
  2. Is the TypeScript SDK intentionally excluding this field?
  3. Is listing with user_ids the recommended way to establish ownership for reconciliation?

Could the connected-accounts documentation explain this policy and align the schema/example where appropriate? Happy to contribute a documentation change once the intended behavior is confirmed.

This report is based on public source and API contracts, not live response testing. It does not assert a runtime defect or request disclosure of restricted owner identities.