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

// 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/rotate', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "overlap_seconds": 3600
  }),
});
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.post(
    "https://api-testnet.lumeus.dev/v1/keys/00000000-0000-4000-8000-000000000000/rotate",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_API_KEY']}"},
    json={
        "overlap_seconds": 3600
    },
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "id": "00000000-0000-4000-8000-000000000001",
  "name": "my-app",
  "api_key": "lum_test_0000…",
  "key_prefix": "lum_test_0000",
  "network": "testnet",
  "base_url": "https://api-testnet.lumeus.dev",
  "created_at": "2026-10-22T09:15:04Z",
  "rotated_from": "00000000-0000-4000-8000-000000000000",
  "previous": {
    "id": "00000000-0000-4000-8000-000000000000",
    "name": "my-app",
    "key_prefix": "lum_test_0000",
    "network": "testnet",
    "created_at": "2026-10-01T08:00:00Z",
    "last_used_at": "2026-10-22T09:15:04Z",
    "expires_at": "2026-10-22T10:15:04Z",
    "access": "read"
  },
  "access": "read",
  "expires_at": null
}

{
  "code": "invalid_request",
  "error": "overlap_seconds must be between 0 and 604800",
  "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 GET is not allowed on /v1/keys/00000000-0000-4000-8000-000000000000/rotate; allowed: POST",
  "request_id": "req_6f1c2a9b0e4d4c7a8b3f5e21"
}

{
  "code": "conflict",
  "error": "API key is revoked, expired or already rotating",
  "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"
}