Account Management
Private

Generates a new secret key for an existing API key while keeping the same key ID and other properties. This is useful if the secret has been compromised or needs to be rotated for security purposes.

The old secret becomes invalid immediately, and the new secret is returned in the response. Store the new secret securely as it will not be displayed again. All applications using the old secret will need to be updated with the new secret.

📖 Related Article: Creating new API key on Deribit

Scope: account:read_write

Try in API console

get/private/reset_api_key

Request

  • Base URL
    https://test.deribit.com/api/v2
  • URL
    https://test.deribit.com/api/v2/private/reset_api_key
  • Auth
    none declared

Query parameters

idinteger required
Example:1

API key ID

Response

Success response

jsonrpc'2.0' required

The JSON-RPC version (2.0)

idinteger

The id that was sent in the request

Example response

{
  "result": {
    "id": 1,
    "timestamp": 1536569522277,
    "client_id": "IY2D68DS",
    "client_secret": "P9Z_c73KaBPwpoTVfsXzehAhjhdJn5kM7Zlz_hhDhE8",
    "public_key": "-----BEGIN PUBLIC KEY----- MCowBQYDK2VwAyEApajFN0CSwIaaiIRPiFbiYYvpsLQLSccSLLsKPe984sc= -----END PUBLIC KEY-----",
    "max_scope": [
      "account:read",
      "trade:read",
      "block_trade:read_write",
      "wallet:none"
    ],
    "enabled": true,
    "name": "TestName"
  }
}

Changes

No recorded changes to this operation across all 11 revisions of this API.