# Use a key id from GET /v1/keys; the placeholder answers 404.
curl --fail-with-body -sS -X PATCH 'https://api-testnet.lumeus.dev/v1/keys/00000000-0000-4000-8000-000000000000' \
  -H "Authorization: Bearer $LUMEUS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"name":"my-app-reader"}'

// Node 18+ (ES module)
// Use a key id from GET /v1/keys; the placeholder answers 404.
const res = await fetch('https://api-testnet.lumeus.dev/v1/keys/00000000-0000-4000-8000-000000000000', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "my-app-reader"
  }),
});
console.log(res.status, JSON.stringify(await res.json(), null, 2));

# Use a key id from GET /v1/keys; the placeholder answers 404.
import json
import os

import requests

res = requests.patch(
    "https://api-testnet.lumeus.dev/v1/keys/00000000-0000-4000-8000-000000000000",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_API_KEY']}"},
    json={
        "name": "my-app-reader"
    },
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "id": "00000000-0000-4000-8000-000000000000",
  "name": "my-app-reader",
  "key_prefix": "lum_test_0000",
  "network": "testnet",
  "created_at": "2026-10-22T09:15:04Z",
  "last_used_at": "2026-10-22T09:15:04Z",
  "access": "read"
}

{
  "code": "invalid_request",
  "error": "name is required (1–100 chars)",
  "request_id": "req_6f1c2a9b0e4d4c7a8b3f5e21"
}

{
  "code": "unauthorized",
  "error": "missing credentials",
  "request_id": "req_6f1c2a9b0e4d4c7a8b3f5e21"
}

{
  "code": "forbidden",
  "error": "this API key is read-only; use a full-access key or a signed-in session",
  "request_id": "req_6f1c2a9b0e4d4c7a8b3f5e21"
}

{
  "code": "not_found",
  "error": "API key not found",
  "request_id": "req_6f1c2a9b0e4d4c7a8b3f5e21"
}

{
  "code": "method_not_allowed",
  "error": "method POST is not allowed on /v1/keys/00000000-0000-4000-8000-000000000000; allowed: DELETE, PATCH",
  "request_id": "req_6f1c2a9b0e4d4c7a8b3f5e21"
}

{
  "code": "rate_limited",
  "error": "rate limit exceeded",
  "request_id": "req_6f1c2a9b0e4d4c7a8b3f5e21"
}

{
  "code": "unavailable",
  "error": "rate limiter unavailable",
  "request_id": "req_6f1c2a9b0e4d4c7a8b3f5e21"
}