Bloquear o reactivar claves

Prod Env

https://api.cobre.co/v1

POST

/accounts/{acct_id}/keys/{key_id}/key_action

Este endpoint permite realizar acciones en una key de Cobre.

Las acciones y sus razones correspondientes son las siguientes:

action	description	Allowed reasons
enable	Acción que reactiva una llave previamente bloqueada cuyo estado actual es `disabled`. Esto hará que la llave vuelva al estado `registered`, permitiendo que se use sin restricciones.	`client_request`
disable	Acción que bloquea la llave a solicitud del cliente. Esto hará que la llave relacionada pase al estado `disabled`, impidiendo que se use en cualquier operación.	`client_request`

La selección de la razón depende de quién está iniciando la acción y debe incluirse en el cuerpo de la solicitud de la API.

Esta funcionalidad está en beta y puede estar sujeta a cambios. Por ahora, no está disponible en el entorno de producción.

Ver guía de llaves Cobre con Bre-B

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/json

Examples

Responses

🟢200Correcto

application/json

Body

🟠404No encontrado

🟠409Conflicto

Request Example

Shell

JavaScript

Java

Swift

cURL

deshabilitar una Keyhabilitar una Key

curl --location --request POST 'https://api.cobre.co/v1/accounts//keys//key_action' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "action": "disable",
    "reason": "client_request"
}'

Response Example

200 - deshabilitar una Key

{
    "id": "key_TQjvIO8UFf1bv81",
    "alias": "My first Cobre Key",
    "connectivity": {
        "status": "registered",
        "description": ""
    },
    "previous_action": {
        "action_requested": "disable",
        "action_code": "",
        "action_description": ""
    },
    "created_at": "2025-11-28T21:32:08Z",
    "updated_at": "2025-11-28T21:32:09Z"
}

Modified at 2026-02-11 16:57:18

Cancelar una llaves

Registrar una Contraparte para Débito Directo