Connections

Change who can use a connection

Change who can use an app connection without disconnecting it: its credential, tool settings and history stay as they are. everyone shares it with the whole team, only_me limits it to the caller, and members limits it to the listed teammates (include yourself to keep using it). Only those people see its tools, in their chats and in the tasks they created. A personal connection always stays usable by its owner, and naming members shares it with them too. It cannot be opened to everyone, because its credential belongs to its owner; connect it again as a Team connection for that. An account admin changes a team connection; only its owner changes a personal one. Only app connections support this. When Crevio's agent calls this, the user approves it first.

put/connections/{id}/access

Request

  • Base URL: https://api.crevio.co/v1
  • URL: https://api.crevio.co/v1/connections/{id}/access
  • Auth: API key in header Authorization

Path parameters

idstring required

Unified public connection id, as returned by GET /connections/connected. Opaque — pass it back verbatim.

Request body

access'everyone' | 'only_me' | 'members' required

Who can use the connection: the whole team, only you, or the people in members.

membersstring[]

Emails of account members who can use it, for members. Replaces the current list.

Response

The connection with its new access

objectstring required
idstring required
kindstring required
providerstring required
labelstring nullable required
statusstring required
status_detailstring nullable required
disconnectableboolean required
callableboolean required
accessstring required
membersstring[] nullable required
connected_atstring nullable required

Changes

No recorded changes to this operation across all 2 revisions of this API.