> ## Documentation Index
> Fetch the complete documentation index at: https://onecli.sh/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Organization Connections API: Apps Shared Across Workspaces

> List, rename, and disconnect app connections shared into every workspace of your organization with the OneCLI API.

Organization connections are app connections, such as a GitHub or Google account, that an admin connects once and shares into every workspace. Agents in any workspace can then be granted the connection without anyone handling tokens.

Use these endpoints to audit and clean up shared connections. To create one, use [Organization apps](https://onecli.sh/docs/api-reference/organization-apps). For how connections work, see [App connections](https://onecli.sh/docs/integrations/app-connections.md).

## Related guides

* [App connections: connect agents to apps](https://onecli.sh/docs/integrations/app-connections.md)
* [Agent access: grant connections to agents](https://onecli.sh/docs/guides/agent-access.md)

## Endpoints

| Endpoint | Method and path | What it does |
| - | - | - |
| [List organization connections](https://onecli.sh/docs/api-reference/organization-connections/list-organization-connections.md) | `GET /org/connections` | List app connections shared into every workspace, newest first. |
| [Rename an organization connection](https://onecli.sh/docs/api-reference/organization-connections/rename-an-organization-connection.md) | `PATCH /org/connections/{connectionId}` | Rename an organization connection so admins and members can tell shared accounts apart, such as a production and a staging GitHub org. |
| [Disconnect an organization connection](https://onecli.sh/docs/api-reference/organization-connections/disconnect-an-organization-connection.md) | `DELETE /org/connections/{connectionId}` | Disconnect an organization connection, removing it from every workspace and every agent grant that referenced it. |

## Next steps

* [API overview](https://onecli.sh/docs/api-reference.md): base URLs, authentication, and pagination
* [Errors](https://onecli.sh/docs/api-reference/errors.md): status codes and the error format
* [Editions](https://onecli.sh/docs/api-reference/editions.md): which endpoints each edition serves


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.