Endpoints
DEVELOPER REFERENCE
List connections
GET /mcp/connections
List active connected accounts for a provider returned by a node schema. This endpoint returns identifiers and display names, not credentials.
GET /api/v1/mcp/connectionsPermission: workflows:read. Write endpoints also require a workspace role that permits changes. See authentication and errors.
Request
curl --request GET 'https://app.innflow.ai/api/v1/mcp/connections?provider=provider_id' \
--header "Authorization: Bearer $INNFLOW_API_KEY"Examples use placeholder IDs. Set INNFLOW_API_KEY in your shell and replace IDs with your own before sending a request.
Parameters
| Name | In | Required | Details |
|---|---|---|---|
X-Innflow-Workspace | header | No | Organization ID, or personal. Set explicitly; omission uses legacy user-owned resource scope. |
provider | query | Yes | Provider identifier from the node schema. |
page | query | No | Page number, starting at 1. |
pageSize | query | No | Results per page (1–100). |
Response
HTTP 200 — Returns data with items (id, provider, name) and nextPage. An unknown provider returns 422 UNKNOWN_PROVIDER.
See OpenAPI download for the machine-readable request contract and errors for errors and retry behavior.