Update a segment

Metadata is applied as an RFC 7396 merge patch: a body without metadata, or with an empty metadata object, leaves the stored metadata as it is; a key sent as null is deleted; any other key is added or replaced; metadata sent as null deletes every key the client wrote.

PATCH /v1/organizations/{organization_id}/ledgers/{ledger_id}/segments/{segment_id}

Update a segment

cURL

curl --request PATCH \
  --url https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/segments/{segment_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "metadata": {},
  "name": "My Segment Updated"
}
'

200

{
  "createdAt": "2021-01-01T00:00:00Z",
  "deletedAt": "2021-01-01T00:00:00Z",
  "id": "00000000-0000-0000-0000-000000000000",
  "ledgerId": "00000000-0000-0000-0000-000000000000",
  "name": "My Segment",
  "organizationId": "00000000-0000-0000-0000-000000000000",
  "status": {
    "code": "ACTIVE",
    "description": "Active status"
  },
  "updatedAt": "2021-01-01T00:00:00Z",
  "metadata": {}
}

Autorizaciones

Authorization · string · header · requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

organization_id · string · requerido

Organization ID (UUID)

ledger_id · string · requerido

Ledger ID (UUID)

segment_id · string · requerido

Segment ID (UUID)

Cuerpo

application/json

metadata · object

Show child attributes

name · string

Ejemplo:

"My Segment Updated"

status · object

Show child attributes

Respuesta

200

application/json

OK

createdAt · string<date-time> · requerido

Ejemplo:

"2021-01-01T00:00:00Z"

deletedAt · string<date-time> | null · requerido

Ejemplo:

"2021-01-01T00:00:00Z"

id · string<uuid> · requerido

Ejemplo:

"00000000-0000-0000-0000-000000000000"

ledgerId · string<uuid> · requerido

Ejemplo:

"00000000-0000-0000-0000-000000000000"

name · string · requerido

Maximum string length: 256

Ejemplo:

"My Segment"

organizationId · string<uuid> · requerido

Ejemplo:

"00000000-0000-0000-0000-000000000000"

status · object · requerido

Show child attributes

updatedAt · string<date-time> · requerido

Ejemplo:

"2021-01-01T00:00:00Z"

metadata · object

Show child attributes