Update a Pix key entry

Updates an existing Pix entry (RFC 7386 JSON Merge Patch). Only account information, name, and trade name can be changed. A branch or account number change resolves the new account in the CRM before BACEN is called: no CRM account refuses the update with PIX-0116 (or PIX-0140 when the CRM is unavailable) and BACEN is not called. Moving the key onto a salary account (SLRY), by stating that account type or by a branch or account number change to an account the CRM records as SLRY, is refused with 422 PIX-0176 before BACEN is called; a key already on a salary account stays updatable. BACEN’s refusals come back as PIX-0120 (the directory does not hold the key), PIX-0100 (it refused the change) and PIX-0106 (the key is not active).

PATCH /entries/{entry_id}

Update a Pix key entry

cURL

curl --request PATCH \
  --url https://api.example.com/dict-hub/v1/entries/{entry_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Account-Id: <x-account-id>' \
  --header 'X-Idempotency: <x-idempotency>' \
  --header 'X-Reason: <x-reason>' \
  --data '
{
  "account": {
    "branch": "0001",
    "number": "0007654321",
    "openingDate": "2010-01-10",
    "participant": "12345678",
    "type": "CACC"
  },
  "metadata": {
    "source": "mobile"
  },
  "owner": {
    "name": "João Silva",
    "tradeName": "Silva ME"
  }
}
'

200

Example

{ "account": { "branch": "0001", "number": "0007654321", "participant": "12345678", "type": "CACC", "openingDate": "2010-01-10T03:00:00Z" }, "createdAt": "2019-11-18T03:00:00Z", "id": "019606c3-5d6e-7f80-1b23-456789012cde", "keyCreationDate": "2019-11-18T03:00:00Z", "keyOwnershipDate": "2019-11-18T03:00:00Z", "keyType": "CPF", "keyValue": "52998224725", "organizationId": "019606d4-6e7f-8091-2c34-567890123def", "owner": { "document": "52998224725", "name": "João Silva", "personType": "NATURAL", "tradeName": "Silva ME" }, "requestId": "a946d533-7f22-42a5-9a9b-e87cd55c0f4d", "status": "ACTIVE", "updatedAt": "2019-11-18T03:00:00Z", "holderId": "019606e5-7f80-9102-3d45-678901234ef0", "metadata": {} }

Autorizaciones

Authorization · string · header · requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Idempotency · string · requerido

REQUIRED. Client-supplied replay key, at most 64 bytes. A request without it is refused with PIX-0030 @ 400 before the handler runs. Resending the same key and request within 1 hour returns the original response, its status included, with X-Idempotency-Replayed: true. Reusing the key with a divergent method, path or body, or while the first request runs, is PIX-0031 @ 412.

Required string length: 1 - 64

X-Account-Id · string · requerido

Account ID (UUID format)

Ejemplo:

"019606a1-3b4c-7d8e-9f01-234567890abc"

X-Reason · string · requerido

Reason for the update. For an EVP key it MUST be BRANCH_TRANSFER, RECONCILIATION or RFB_VALIDATION; for every other key type any non-empty value is accepted and recorded as the audit reason.

Ejemplo:

"USER_REQUESTED"

Parámetros de ruta

entry_id · string · requerido

Entry ID (UUID format)

Ejemplo:

"019606c3-5d6e-7f80-1b23-456789012cde"

Cuerpo

application/json

account · object

Show child attributes

metadata · object

Free-form, single-level key/value pairs persisted with the entry. Keys up to 100 characters, values up to 2000 characters, at most 25 entries; nested objects are rejected.

Show child attributes

Ejemplo:

{ "source": "mobile" }

owner · object

Show child attributes

Respuesta

200

application/json

OK

account · object · requerido

Show child attributes

createdAt · string<date-time> · requerido

Ejemplo:

"2019-11-18T03:00:00Z"

id · string · requerido

Ejemplo:

"019606c3-5d6e-7f80-1b23-456789012cde"

keyCreationDate · string<date-time> · requerido

Ejemplo:

"2019-11-18T03:00:00Z"

keyOwnershipDate · string<date-time> · requerido

Ejemplo:

"2019-11-18T03:00:00Z"

keyType · string · requerido

Ejemplo:

"CPF"

keyValue · string · requerido

Ejemplo:

"52998224725"

organizationId · string · requerido

Ejemplo:

"019606d4-6e7f-8091-2c34-567890123def"

owner · object · requerido

Show child attributes

requestId · string · requerido

Ejemplo:

"a946d533-7f22-42a5-9a9b-e87cd55c0f4d"

status · string · requerido

Ejemplo:

"ACTIVE"

updatedAt · string<date-time> · requerido

Ejemplo:

"2019-11-18T03:00:00Z"

holderId · string

CRM holder of the key's account. Absent while a key VSync synchronized from the directory waits for its owner's CRM account.

Ejemplo:

"019606e5-7f80-9102-3d45-678901234ef0"

metadata · object

Show child attributes