> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arouter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API Key 업데이트

> 기존 API key의 이름, 상태, 지출 한도 또는 액세스 제한을 업데이트합니다. 관리 key가 필요합니다.

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH https://api.arouter.ai/api/v1/keys/KEY_HASH \
    -H "Authorization: Bearer lr_mgmt_xxxx" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "production-backend-v2",
      "limit": 200,
      "limit_reset": "monthly",
      "allowed_providers": ["openai", "anthropic", "google"],
      "allowed_models": ["openai/gpt-5.4", "anthropic/claude-sonnet-4.6", "google/gemini-2.5-flash"]
    }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.patch(
      "https://api.arouter.ai/api/v1/keys/KEY_HASH",
      headers={"Authorization": "Bearer lr_mgmt_xxxx"},
      json={
          "name": "production-backend-v2",
          "limit": 200,
          "limit_reset": "monthly",
          "allowed_providers": ["openai", "anthropic", "google"],
      },
  )
  print(resp.json())
  ```

  ```go Go theme={null}
  updated, err := client.UpdateKey(ctx, "KEY_HASH", &arouter.UpdateKeyRequest{
      Name:             stringPtr("production-backend-v2"),
      Limit:            float64Ptr(200),
      LimitReset:       stringPtr("monthly"),
      AllowedProviders: []string{"openai", "anthropic", "google"},
  })
  ```

  ```typescript Node.js theme={null}
  const updated = await router.updateKey("KEY_HASH", {
    name: "production-backend-v2",
    limit: 200,
    limit_reset: "monthly",
    allowed_providers: ["openai", "anthropic", "google"],
  });
  console.log(updated.data.name); // "production-backend-v2"
  ```
</RequestExample>

요청 본문의 모든 필드는 선택적입니다 — 변경하려는 필드만 포함하세요.

## Key 비활성화 / 활성화

```bash theme={null}
curl -X PATCH https://api.arouter.ai/api/v1/keys/KEY_HASH \
  -H "Authorization: Bearer lr_mgmt_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"disabled": true}'
```

비활성화된 key는 즉시 요청 수락을 중지합니다. `disabled: false`로 설정하면 다시 활성화됩니다.

## 지출 한도 업데이트

```bash theme={null}
curl -X PATCH https://api.arouter.ai/api/v1/keys/KEY_HASH \
  -H "Authorization: Bearer lr_mgmt_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 500,
    "limit_reset": "monthly"
  }'
```

`limit`을 `null`로 설정하면 지출 상한이 제거됩니다. `limit_reset` 필드는 카운터가 재설정되는 시기를 제어합니다: `daily`(UTC 자정), `weekly`(월요일 UTC 자정), 또는 `monthly`(매월 1일 UTC 자정). `null`로 설정하면 평생 상한이 됩니다.