{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "Invalid API key"
  },
  "request_id": "req_abc123def456"
}

const response = await fetch('https://api.ledger.so/v1/agents', {
  headers: { 'Api-Key': apiKey }
});

if (!response.ok) {
  const { error, request_id } = await response.json();

  switch (error.type) {
    case 'authentication_error':
      // Check API key configuration
      break;
    case 'rate_limit_error':
      // Wait and retry
      const retryAfter = response.headers.get('Retry-After');
      await sleep(retryAfter * 1000);
      break;
    case 'validation_error':
      // Fix request parameters
      console.error(error.message);
      break;
    default:
      // Log request_id for support
      console.error(`Error ${error.code}: ${error.message} (${request_id})`);
  }
}