IntegrationOS Connections API

Manage connections

Documentation GitHub OpenAPI

Operations 14

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/connections List my connections · List connections #

Ask an LLM

“Which connected accounts do I have in my current scope?”

“Can I list connections for an organization or project tenant by passing its ID as a header?”

Tell an agent

List my connections.

List connections in project tenant {project}, page {page}.

GET /v1/connections/metrics Get connection usage metrics · Get connection metrics #

Ask an LLM

“How many connections do I have, and what do the connection metrics show?”

“Is there a summary count of connections I can pull for a dashboard?”

Tell an agent

Show my connection metrics.

Fetch the connection counts summary for a dashboard.

GET /v1/connections/organizations/{org_id} List an organization's connections · List organization connections #

Ask an LLM

“Which connections belong to a specific organization?”

“Can I page through all organization-level connections?”

Tell an agent

List the connections in organization {org_id}.

Show page {page} of organization {org_id}'s connections, {limit} at a time.

GET /v1/connections/organizations/{org_id}/projects/{project_id} List a project's connections · List project connections #

Ask an LLM

“What connections exist inside one project of my organization?”

“Can I list a project's connections a page at a time?”

Tell an agent

List the connections in project {project_id} of org {org_id}.

Show page {page} of project {project_id} connections in organization {org_id}.

DELETE /v1/connections/organizations/{org_id}/projects/{project_id}/{id} Delete a connection from a project · Delete project connection #

Ask an LLM

“How do I remove a connected account from one project?”

“Can I delete a project's connection through the project-scoped path?”

Tell an agent destructive · confirm first

Delete connection {id} from project {project_id} in org {org_id}.

Remove project {project_id}'s connection {id} under organization {org_id}.

GET /v1/connections/organizations/{org_id}/projects/{project_id}/{id} Get a connection within a project · Retrieve project connection #

Ask an LLM

“How do I fetch one connection that belongs to a project by its ID?”

“Can I view a project connection's record through the project path?”

Tell an agent

Get connection {id} in project {project_id}, org {org_id}.

Show project {project_id}'s connection record {id} under organization {org_id}.

PATCH /v1/connections/organizations/{org_id}/projects/{project_id}/{id} Rename or retag a project connection · Update project connection tags #

Ask an LLM

“Can I change the tags on a connection that lives in a project?”

“How do I give a project connection a new display name?”

Tell an agent

Set tags {tags} on connection {id} in project {project_id}, org {org_id}.

Rename project {project_id} connection {id} to {name} in organization {org_id}.

DELETE /v1/connections/organizations/{org_id}/{id} Delete a connection from an organization · Delete organization connection #

Ask an LLM

“How do I remove an organization-level connection?”

“Can an admin delete a connection owned by the organization rather than a project?”

Tell an agent destructive · confirm first

Delete connection {id} from organization {org_id}.

Remove the org-level connection {id} in {org_id}.

GET /v1/connections/organizations/{org_id}/{id} Get a connection within an organization · Retrieve organization connection #

Ask an LLM

“How do I fetch one organization-level connection by ID?”

“Can I view an org connection's record without going through a project?”

Tell an agent

Get connection {id} in organization {org_id}.

Show organization {org_id}'s connection record {id}.

PATCH /v1/connections/organizations/{org_id}/{id} Rename or retag an organization connection · Update organization connection tags #

Ask an LLM

“Can I retag a connection owned by my organization?”

“Does sending an empty name clear an organization connection's display name?”

Tell an agent

Set tags {tags} on connection {id} in organization {org_id}.

Rename org {org_id} connection {id} to {name}.

GET /v1/connections/reachable List connections my grant can reach · List reachable connections #

Ask an LLM

“Which connections can my grant reach, including ones I can only run custom actions on?”

“What access label does each reachable connection carry for my credential?”

Tell an agent

List every connection my grant can reach, with its access label.

Show page {page} of reachable connections for my credential.

DELETE /v1/connections/{id} Delete a connection by ID · Delete connection #

Ask an LLM

“How do I delete a connection in my current scope using only its ID?”

“Can I remove a connected account without going through the organization or project paths?”

Tell an agent destructive · confirm first

Delete connection {id}.

Remove connection {id} acting in project tenant {project}.

GET /v1/connections/{id} Get a connection by ID · Retrieve connection #

Ask an LLM

“How do I look up a single connection by its ID in my current scope?”

“Can I fetch a connection directly without specifying an organization path?”

Tell an agent

Get connection {id}.

Fetch connection {id} acting in organization tenant {org}.

PATCH /v1/connections/{id} Rename or retag a connection by ID · Update connection tags #

Ask an LLM

“Can I change a connection's tags using just its ID?”

“Are a connection's tags left alone if I only send a new name?”

Tell an agent

Set the tags on connection {id} to {tags}.

Rename connection {id} to {name}.

IntegrationOS Connections API

Operations 14

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification