API: integrations

Status: GA Access: token required API contract: 0.3.0 · capability 2026-09-03.1 View as Markdown Open in Claude Open in ChatGPT

`GET /api/v1/integrations`

List Integrations

Every external connection with its cached status.

Auth: Authorization: Bearer <token> required

Responses:

Code	Meaning	Body
`200`	Successful Response	`array of ConnectionStatus`
`401`	Missing or invalid authentication credentials	`ErrorResponse`

Get Integration

One connection’s freshly recomputed status.

Auth: Authorization: Bearer <token> required

Parameter	In	Required	Type	Description
`connection_id`	path	yes	`string`

Responses:

Code	Meaning	Body
`200`	Successful Response	`ConnectionStatus`
`401`	Missing or invalid authentication credentials	`ErrorResponse`
`422`	Validation Error	`HTTPValidationError`

Recheck Integration

Force an immediate re-probe of one connection.

Auth: Authorization: Bearer <token> required

Parameter	In	Required	Type	Description
`connection_id`	path	yes	`string`
`Idempotency-Key`	header	no	`string`	Optional.

Responses:

Code	Meaning	Body
`200`	Successful Response	`ConnectionStatus`
`401`	Missing or invalid authentication credentials	`ErrorResponse`
`422`	Validation Error	`HTTPValidationError`