PATCH
/
v1
/
organizations
/
{organization_id}
/
ledgers
/
{ledger_id}
/
account-types
/
{account_type_id}
Update an Account Type
curl --request PATCH \
  --url https://onboarding.sandbox.midaz.io/v1/organizations/{organization_id}/ledgers/{ledger_id}/account-types/{account_type_id} \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Updated Cash Account",
  "description": "Updated account type for liquid assets held in cash or cash equivalents.",
  "metadata": {
    "customField": "updatedValue",
    "newField": "newField"
  }
}'
{
"id": "<string>",
"name": "<string>",
"description": "<string>",
"keyValue": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"deletedAt": "2023-11-07T05:31:56Z",
"metadata": {}
}

Path Parameters

organization_id
string
required

The unique identifier of the Organization associated with the Ledger.

ledger_id
string
required

The unique identifier of the associated Ledger.

account_type_id
string
required

The unique identifier of the Account Type that you want to retrieve.

Body

application/json
name
string

Name of the Account Type.

description
string

Description of the Account Type.

metadata
object

An object containing key-value pairs to add as metadata, where the field name is the key and the field value is the value. For example, to add a Cost Center, use 'costCenter': 'BR_11101997'.

Response

Indicates that the resource was successfully created and the operation was completed as expected.

id
string<uui>

The unique identifier of the Account Type.

name
string

Name of the Account Type.

description
string

Dscription of the Account Type.

keyValue
string

Unique identifier for the Account Type created.

createdAt
string<date-time>

Timestamp of creation (UTC).

updatedAt
string<date-time>

Timestamp of last update (UTC).

deletedAt
string<date-time> | null

Timestamp of soft deletion, if applicable (UTC).

metadata
object

An object containing key-value pairs to add as metadata, where the field name is the key and the field value is the value. For example, to add a Cost Center, use 'costCenter': 'BR_11101997'.