Initialize OAuth Flow

post/v1/graphs/{graph_id}/connections/oauth/init

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

Request body

Required, application/json.

Field	Type	Description
`connection_id`required	string	Connection ID to link OAuth to
`redirect_uri`optional	string	Override default redirect URI
`additional_params`optional	object	Provider-specific parameters

Example request

curl

curl -X POST "https://api.robosystems.ai/v1/graphs/{graph_id}/connections/oauth/init" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "connection_id": "string"
}'

Responses

200 Successful Response

Field	Type	Description
`auth_url`optional	string	URL to redirect the user to for authorization. Null for providers that authorize in an embedded widget (Plaid: see link_token).
`link_token`optional	string	Plaid only: the token that opens Plaid Link. Link's public_token completes the flow through the callback, as code.
`state`required	string	OAuth state for security
`expires_at`required	string (date-time)	When this OAuth request expires

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