Get Connection
get
/v1/graphs/{graph_id}/connections/{connection_id}Part of Connections.
Authentication
Authenticate in any one of these ways — not all of them:
- API key in the
X-API-Keyheader. - Bearer token in the
Authorizationheader.
Path parameters
| Name | Type | Description |
|---|---|---|
graph_idrequired | string | Graph Id |
connection_idrequired | string | Unique connection identifier |
Example request
curl
curl -X GET "https://api.robosystems.ai/v1/graphs/{graph_id}/connections/{connection_id}" \
-H "X-API-Key: $ROBOSYSTEMS_API_KEY"Responses
200 Successful Response
| Field | Type | Description |
|---|---|---|
connection_idrequired | string | Unique connection identifier |
providerrequired | string | Connection provider type |
entity_idoptional | string | Entity identifier |
statusrequired | string | Connection status |
created_atrequired | string (date-time) | string | Creation timestamp |
updated_atoptional | string (date-time) | string | Last update timestamp |
last_syncoptional | string (date-time) | string | Last sync timestamp |
write_policyoptional | string | Source-of-truth write policy: 'native' (RoboSystems is authoritative; no outbound write-back) or 'qb_authoritative' (QuickBooks is authoritative; RoboSystems-originated entries publish to QB). Set via the write-policy endpoint. |
source_nameoptional | string | External-provider registered source slug — the value the integration stamps on the events it emits. Null for platform providers. |
metadatarequired | object | Provider-specific metadata |
| 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 |