Sign in

v56

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-03113163377.5 KB
Subkey

Update subkey IP allowlist

Replace the IP CIDR allowlist for a subkey. Empty array clears the allowlist (unrestricted). Only callable with the main account; subkeys cannot widen their own allowlist.

put/account/keys/subkeys/{public_key}/allowed-cidrs

Path parameters

public_keystring required

Subkey public key

Request body

allowed_cidrsstring[]

Full replacement list. Empty = unrestricted.

Example request

{
  "allowed_cidrs": [
    "[\"203.0.113.0/24\"",
    "\"198.51.100.42/32\"]"
  ]
}

Response

Updated subkey details

account_idstring

Account ID that owns this subkey

allowed_cidrsstring[]

IP CIDR allowlist; empty means unrestricted

created_atinteger

Subkey creation timestamp (nanoseconds since epoch)

idinteger

Unique subkey identifier

namestring

User-provided subkey name

public_keystring

Subkey public key

revoked_atinteger

Revocation timestamp (nanoseconds since epoch, 0 if not revoked)

statestring

Subkey state

updated_atinteger

Last modification timestamp (nanoseconds since epoch)

Example response

{
  "account_id": "0x1234567890abcdef",
  "allowed_cidrs": [
    "[\"203.0.113.0/24\"]"
  ],
  "created_at": 1640995200,
  "id": 1,
  "name": "My Subkey",
  "public_key": "0xabcdef1234567890abcdef",
  "updated_at": 1640995200
}