---
title: "Update Subkey"
method: PUT
path: "/account/keys/subkeys/{public_key}"
tags: ["Subkey"]
---

# Update Subkey

`PUT /account/keys/subkeys/{public_key}`

## Request

- Base URL: `https://api.prod.paradex.trade/v1`
- URL: `https://api.prod.paradex.trade/v1/account/keys/subkeys/{public_key}`
- Auth: API key in header `Authorization`

Update properties of an existing subkey for the authenticated account.

## Path parameters

- `public_key` string, required

## Request body

- RequestsUpdateSubkey
  - `name` string, required: New name for the subkey.

## Response `200`

Updated subkey details

- ResponsesSubkey
  - `account_id` string: Account ID that owns this subkey
  - `allowed_cidrs` string[]: IP CIDR allowlist; empty means unrestricted
  - `block_trade_signing_enabled` boolean: Whether this subkey is enabled for block trade signing (create, offer and execute signatures) for its account: it is active, and either the account owner enabled it with the main key or it is the Paradigm RFQ delegation key, which follows its delegation. Always false for pending and revoked subkeys.
  - `created_at` integer: Subkey creation timestamp (nanoseconds since epoch)
  - `id` integer: Unique subkey identifier
  - `name` string: User-provided subkey name
  - `public_key` string: Subkey public key
  - `revoked_at` integer: Revocation timestamp (nanoseconds since epoch, 0 if not revoked)
  - `state` string: Subkey state
  - `updated_at` integer: Last modification timestamp (nanoseconds since epoch)

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

## Changes

- **2026-10-22** `f33feb7333ea`: 12 warning
  - added the new `ADDRESS_BOOK_NOT_PARADEX_ACCOUNT` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `ADDRESS_BOOK_NOT_PARADEX_ACCOUNT` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `401`
  - added the new `ADDRESS_BOOK_NOT_PARADEX_ACCOUNT` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `403`
  - added the new `ADDRESS_BOOK_NOT_PARADEX_ACCOUNT` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `404`
  - …8 more
- **2026-10-20** `72c125c93c2b`: 8 warning
  - added the new `SESSION_EXPIRED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `SESSION_EXPIRED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `401`
  - added the new `SESSION_EXPIRED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `403`
  - added the new `SESSION_EXPIRED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `404`
  - …4 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/changes/account/keys/subkeys/:public_key/put.md)

---

[API](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2.md) - [All operations](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/revisions/f33feb7333ea?raw)