---
title: "Set or clear a connected account's nickname"
method: PATCH
path: "/v1/integrations/accounts/{account_id}/label"
tags: ["integrations"]
---

# Set or clear a connected account's nickname

`PATCH /v1/integrations/accounts/{account_id}/label`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/integrations/accounts/{account_id}/label`
- Auth: HTTP bearer

Sets a human nickname on a connected account (e.g. 'Stripe US') so a tenant can tell multiple accounts of the same app apart; the agent uses it to route to the right one. Send an empty/null label to clear it. Tenant-scoped: a foreign/unknown account id 404s.

## Path parameters

- `account_id` string, uuid, required

## Headers

- `X-Tenant-Id` string, nullable

## Request body

- LabelBody: Set/clear a connected account's user NICKNAME. ``null`` or blank clears it.
  - `label` string, nullable

## Response `200`

Successful Response

- ConnectedAccountResponse
  - `id` string, uuid, required
  - `provider` string, required
  - `app_slug` string, nullable
  - `status_code` string, required
  - `visibility_code` 'team' | 'personal': Who, within a tenant, may use a connected account's tools. ``TEAM``: any actor in the tenant. ``PERSONAL``: only the actor who connected it. Designed to extend to a ``GROUP`` scope later (the Groups model is already on main).
  - `sync_enqueued` boolean, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/patricia/apis/patricia-api.md) · [All operations](https://skmtc.dev/patricia/apis/patricia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/patricia/apis/patricia-api/revisions/0dfb44495ea1?raw)