---
title: "Rename a connection"
method: PATCH
path: "/connections/{id}"
tags: ["Connections"]
---

# Rename a connection

`PATCH /connections/{id}`

## Request

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

Set a nickname for a connection, so several accounts of the same app are tellable apart ("work gmail" vs "support gmail"). Send an empty string to clear it and fall back to the provider's own label. Only app connections can be renamed; every other family takes its name from a record the provider owns.

## Path parameters

- `id` string, required

## Request body

- object
  - `nickname` string, required: The name to show for this connection. Empty clears it.

## Response `200`

The renamed connection

- 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
- `409`: Conflict
- `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
- `502`: Upstream (provider) failure
- `503`: Feature not configured for this workspace

---

[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)