Skip to content

Fix misleading documentation for List Connections config field#77

Closed
runleonarun wants to merge 1 commit intomasterfrom
fix-list-connections-config-docs
Closed

Fix misleading documentation for List Connections config field#77
runleonarun wants to merge 1 commit intomasterfrom
fix-list-connections-config-docs

Conversation

@runleonarun
Copy link
Contributor

The config field in the List Account Connections endpoint was documented as "(only included when annotated)" which was confusing and misleading. In reality, this field is always null in list responses for performance reasons.

Updated the description to:

  • Clarify that config is always null in list responses
  • Direct users to the Retrieve Account Connection endpoint to get config
  • Added nullable: true to properly indicate the field will be null

This resolves confusion reported by customers (e.g., Fivetran/Dexcom) who expected the config field to be returned when using query params like include_related or adapter_version.

The config field in the List Account Connections endpoint was documented
as "(only included when annotated)" which was confusing and misleading.
In reality, this field is always null in list responses for performance
reasons.

Updated the description to:
- Clarify that config is always null in list responses
- Direct users to the Retrieve Account Connection endpoint to get config
- Added nullable: true to properly indicate the field will be null

This resolves confusion reported by customers (e.g., Fivetran/Dexcom)
who expected the config field to be returned when using query params
like include_related or adapter_version.

Refs: ZD-114337
@runleonarun runleonarun requested a review from a team as a code owner February 3, 2026 22:18
@runleonarun runleonarun requested review from joaodaher and removed request for a team February 3, 2026 22:18
@runleonarun
Copy link
Contributor Author

Closing in favor of opening an PR in code source!

@runleonarun runleonarun closed this Feb 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant