---
title: "Update a Corporate Holder"
method: PATCH
path: "/v2/corporate-holder/{id}"
tags: ["Corporate Holder"]
---

# Update a Corporate Holder

`PATCH /v2/corporate-holder/{id}`

## Request

- Base URL: `https://api.starkbank.com`
- URL: `https://api.starkbank.com/v2/corporate-holder/{id}`
- Auth: API key in header `Digital-Signature`

Update a single corporate holder. At least one updatable parameter must be informed.

## Path parameters

- `id` string, required

## Request body

- object
  - `centerId` string: Id of the new target cost center. Example: "5656565656565656".
  - `name` string: New card holder name. It must be unique among the active holders of your Workspace. Example: "Iron Bank S.A.".
  - `permissions` string[]: New array of permission objects. It replaces the current permissions of the holder. Example: [{"ownerType": "project", "ownerId": "6253551860842496"}]
  - `rules` string[]: New array of rule objects with the spending rules of the holder. Example: [{"name": "General USD", "interval": "day", "amount": 100000, "currencyCode": "USD"}]
  - `status` string: You may block the holder by passing "blocked" in the status, and unblock it by passing "active".
  - `tags` string[]: New array of up to 100 strings to tag the holder. All tags will be converted to lowercase.

## Response `200`

Successful operation

- object

## Other responses

- `400`: Client error
- `500`: Server error

---

[API](https://skmtc.dev/starkbank/apis/stark-bank-api.md) - [All operations](https://skmtc.dev/starkbank/apis/stark-bank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starkbank/apis/stark-bank-api/revisions/aeff5068a5da?raw)