# Overview

## Connections

Accounts at other apps (a member’s Google account, the company’s GitHub App) that tools act with. `connection-entries` lists the apps this server can connect to; `connection-apps` is the workspace’s own registration of its client at an app (a tenant admin’s, secrets by reference); `connections` are the accounts connected through them, with the connect that makes one (`requests`, `start`, `finish`). A connection is a member’s own or the company’s, and its token never leaves the server. `connection-choices` say which company connection an agent or a flow uses for an app in a project; a project’s admins set them. `POST /v1/connection-notices/{tenantId}/{appId}` is where an app reports a removal, signed its own way. Caller-plugged via `ConnectionBinding`.

## Operations

GET

[/v1/connection-entries](https://docs.kindgi.com/reference/api/operations/connectionentrieslist.md)

GET

[/v1/connection-apps](https://docs.kindgi.com/reference/api/operations/connectionappslist.md)

POST

[/v1/connection-apps](https://docs.kindgi.com/reference/api/operations/connectionappscreate.md)

GET

[/v1/connection-apps/{appId}](https://docs.kindgi.com/reference/api/operations/connectionappsget.md)

DELETE

[/v1/connection-apps/{appId}](https://docs.kindgi.com/reference/api/operations/connectionappsremove.md)

PATCH

[/v1/connection-apps/{appId}](https://docs.kindgi.com/reference/api/operations/connectionappsupdate.md)

GET

[/v1/connections](https://docs.kindgi.com/reference/api/operations/connectionslist.md)

POST

[/v1/connections](https://docs.kindgi.com/reference/api/operations/connectionsconnect.md)

POST

[/v1/connections/finish](https://docs.kindgi.com/reference/api/operations/connectionsfinish.md)

GET

[/v1/connections/requests/{requestId}](https://docs.kindgi.com/reference/api/operations/connectionsrequestsget.md)

POST

[/v1/connections/requests/{requestId}/start](https://docs.kindgi.com/reference/api/operations/connectionsrequestsstart.md)

GET

[/v1/connections/{connectionId}](https://docs.kindgi.com/reference/api/operations/connectionsget.md)

DELETE

[/v1/connections/{connectionId}](https://docs.kindgi.com/reference/api/operations/connectionsdisconnect.md)

PATCH

[/v1/connections/{connectionId}](https://docs.kindgi.com/reference/api/operations/connectionsupdate.md)

GET

[/v1/connections/{connectionId}/choices](https://docs.kindgi.com/reference/api/operations/connectionschoices.md)

GET

[/v1/connection-choices](https://docs.kindgi.com/reference/api/operations/connectionchoiceslist.md)

PUT

[/v1/connection-choices](https://docs.kindgi.com/reference/api/operations/connectionchoicesset.md)

DELETE

[/v1/connection-choices/{choiceId}](https://docs.kindgi.com/reference/api/operations/connectionchoicesremove.md)

GET

[/v1/connection-choices/candidates](https://docs.kindgi.com/reference/api/operations/connectionchoicescandidates.md)

GET

[/v1/connection-choices/needs](https://docs.kindgi.com/reference/api/operations/connectionchoicesneeds.md)

POST

[/v1/connection-notices/{tenantId}/{appId}](https://docs.kindgi.com/reference/api/operations/connectionnoticesreceive.md)