Dismiss Pix Key
POSTTag: api-paas-post-pix-keys-dismiss-by-idDescription: Set a key to not be shown anymore. The key state will change to CLAIM_PENDING, CANCELED or READY. If the key state is:/v2/pix/keys/:id/dismiss
- CLAIM_NOT_CONFIRMED: The key state will change to CLAIM_PENDING.
- PORTABILITY_REQUEST_AUTO_CONFIRMED: The key state will change to CANCELED.
- PORTABILITY_CANCELED: The key state will change to CANCELED.
- OWNERSHIP_CANCELED: The key state will change to CANCELED.
- OWNERSHIP_CONFLICT: The key state will change to CANCELED.
- CLAIM_CLOSED: The key state will change to CANCELED.
- PORTABILITY_READY: The key state will change to READY.
- OWNERSHIP_READY: The key state will change to READY.
- ADD_KEY_READY: The key state will change to READY.
- DELETED: The key state will change to CANCELED.
- NOT_CONFIRMED: The key state will change to CANCELED.
Request
Path Parameters
Pix Key ID.
Header Parameters
Sender Wallet UUID (if empty, your default Wallet UUID will be settled)
The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.
Possible values: [pt-BR
, en-US
]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
The product ID is a UUID (v4) used to identify the Z.ro product configuration.
The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.
Responses
- 200
- 400
- 401
- 404
- 422
The pix key returned successfully.
- application/json
- Schema
- Example (from schema)
Schema
Pix Key ID.
Pix key.
Pix Key Type.
Pix Key State.
Pix Key created at.
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"key": "f6e2e084-29b9-4935-a059-5473b13033aa",
"type": "EVP",
"state": "CANCELED",
"created_at": "2025-10-22T19:11:19.377Z"
}
If any required params are missing or has invalid format or type.
User authentication failed.
If the key id was not found.
If any required params are missing or has invalid format or type.