STstarkbank
Corporate Holder

Update a Corporate Holder

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

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

Path parameters

idstring required

Id of the corporate holder entity.

Request body

centerIdstring

Id of the new target cost center. Example: "5656565656565656".

namestring

New card holder name. It must be unique among the active holders of your Workspace. Example: "Iron Bank S.A.".

permissionsstring[]

New array of permission objects. It replaces the current permissions of the holder. Example: [{"ownerType": "project", "ownerId": "6253551860842496"}]

rulesstring[]

New array of rule objects with the spending rules of the holder. Example: [{"name": "General USD", "interval": "day", "amount": 100000, "currencyCode": "USD"}]

statusstring

You may block the holder by passing "blocked" in the status, and unblock it by passing "active".

tagsstring[]

New array of up to 100 strings to tag the holder. All tags will be converted to lowercase.

Response

Successful operation

object required

Changes

No recorded changes to this operation across all 1 revision of this API.