Block or Reactivate Keys

POST

https://api.cobre.co/v1/accounts/{acct_id}/keys/{key_id}/key_action

This endpoint allows actions to be performed on a Cobre key.

The actions and their corresponding reasons are as follows:

action	description	Allowed reasons
enable	Action that reactivates a previously blocked key whose current state is `disabled`. This will transition the key back to a `registered` state, allowing it to be used without restrictions.	`client_request`
disable	Action that blocks the key at the client’s request. This will transition the related key to a `disabled` state, preventing it from being used in any operations.	`client_request`

The selection of the reason depends on who is initiating the action and must be included in the API request body.

This functionality is in beta and may be subject to change. For now, it is not available in production environment.

See Cobre Keys with Bre-B guide

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

disable a Keyenable a 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 - disable a 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-01-06 03:48:26

Cancel a Key

Create a FX Quote