---
title: "Rename Connected Account"
method: POST
path: "/connected_accounts/{accountId}/rename"
tags: ["Connected Accounts"]
---

# Rename Connected Account

`POST /connected_accounts/{accountId}/rename`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/connected_accounts/{accountId}/rename`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/connected_accounts/:accountId/rename/post.ts> (a function with typed inputs; its response is checked against the schema)

Rename a connected account by account ID.

## Path parameters

- `accountId` string, required

## Headers

- `Idempotency-Key` string

## Request body

- RenameConnectedAccountRequest
  - `accountName` string, required: The new name for the connected account

## Response `200`

Successfully renamed connected account.

- 'SUCCESS' | 'UNAUTHORISED__USER' | 'UNAUTHORISED__DEVICE' | 'INVALID_UNMANAGED_WALLET' | 'INVALID_EXCHANGE_ACCOUNT' | 'NO_ACTIVE_ADMINS' | 'TIMEOUT' | 'INVALID_PARAMETERS' | 'INTERNAL_ERROR' | 'INVALID_CREDENTIALS' | 'INVALID_OTP' | 'INVALID_OTP_METHOD' | 'INVALID_NETWORK_CONNECTION' | 'NETWORK_CONNECTION_EXISTS' | 'INVALID_CREDENTIALS__UNSUPPORTED_PROVIDER' | 'UNSUPPORTED_ALGORITHM' | 'INVALID_CREDENTIALS__IP_WHITELISTING' | 'INVALID_CREDENTIALS__OTP_FAILED' | 'UNSUPPORTED_ASSET' | 'ASSET_ALREADY_EXISTS' | 'ENV_UNSUPPORTED_ASSET' | 'NO_CONFIG_CHANGE_NEEDED' | 'SIMILAR_REQUEST_ALREADY_PENDING' | 'CLOUD_COSIGNER_ALREADY_EXISTS' | 'ILLEGAL_OPERATION' | 'OVERRIDING_PENDING_REQUEST' | 'OWNER_NOT_IN_GROUP' | 'INVALID_THIRD_PARTY_ACCOUNT_HIERARCHY' | 'EXTERNAL_KEY_VALIDATION_FAILED' | 'NO_AVAILABLE_EXTERNAL_KEYS' | 'INVALID_PROOF_OF_OWNERSHIP_SIGNATURE' | 'USER_HAS_EXTERNAL_KEYS' | 'SCHEMA_ALREADY_EXISTS' | 'SCHEMA_ID_OUT_OF_RANGE' | 'FORBIDDEN_SSO_IDP_DOMAIN' | 'UNKNOWN_ERROR': Status of the rename operation

## Other responses

- `400`: Bad request. Missing tenantId, accountId, or accountName.
- `401`: Unauthorized. Missing / invalid JWT token in Authorization header.
- `403`: Failed to rename connected account.
- `404`: Connected account not found
- `409`: Conflict. Account name is already in use by another account.
- `default`: Error Response

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)