---
title: "Change who can use a connection"
method: PUT
path: "/connections/{id}/access"
tags: ["Connections"]
---

# Change who can use a connection

`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`

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.

## Path parameters

- `id` string, required

## Request body

- object
  - `access` 'everyone' | 'only_me' | 'members', required: Who can use the connection: the whole team, only you, or the people in `members`.
  - `members` string[]: Emails of account members who can use it, for `members`. Replaces the current list.

## Response `200`

The connection with its new access

- Connection
  - `object` string, required
  - `id` string, required
  - `kind` string, required
  - `provider` string, required
  - `label` string, nullable, required
  - `status` string, required
  - `status_detail` string, nullable, required
  - `disconnectable` boolean, required
  - `callable` boolean, required
  - `access` string, required
  - `members` string[], nullable, required
  - `connected_at` string, nullable, required

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `403`: Forbidden
- `404`: Resource not found
- `422`: Validation error
- `429`: Rate limit exceeded — 600 requests per minute per credential. Retry after the number of seconds in `Retry-After`.
- `500`: Internal server error

---

[API](https://skmtc.dev/crevio/apis/crevio-api-v1.md) · [All operations](https://skmtc.dev/crevio/apis/crevio-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/crevio/apis/crevio-api-v1/revisions/2219f18ad651?raw)