List Connection Options

get/v1/graphs/{graph_id}/connections/options

Returns available providers and their requirements. Only enabled providers are included (gated by feature flags). QuickBooks and Mercury require OAuth 2.0; Plaid authorizes through Plaid Link (auth_type link); external connections require no auth.

Authentication

Authenticate in any one of these ways — not all of them:

API key in the X-API-Key header.
Bearer token in the Authorization header.

Path parameters

Name	Type	Description
`graph_id`required	string	Graph Id

Example request

curl

curl -X GET "https://api.robosystems.ai/v1/graphs/{graph_id}/connections/options" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY"

Responses

200 Successful Response

Field Type Description

providersrequired

ConnectionProviderInfo[]

Available connection providers

ConnectionProviderInfo fields

Field	Type	Description
`provider`required	string	Provider identifier One of: `quickbooks`, `external`, `mercury`, `plaid`
`display_name`required	string	Human-readable provider name
`description`required	string	Provider description
`auth_type`required	string	Authentication type One of: `none`, `oauth`, `link`, `api_key`
`auth_flow`optional	string	Description of authentication flow
`required_config`required	string[]	Required configuration fields
`optional_config`optional	string[]	Optional configuration fields
`features`required	string[]	Supported features
`sync_frequency`optional	string	Typical sync frequency
`data_types`required	string[]	Types of data available
`setup_instructions`optional	string	Setup instructions
`documentation_url`optional	string	Link to documentation

total_providersrequired

integer

Total number of providers

Status	Meaning
400	Invalid request
401	Authentication required
403	Access denied
404	Resource not found
422	Validation Error
429	Rate limit exceeded
500	Internal server error