Management Key

API 키 업데이트

키를 활성화/비활성화하거나 지출 한도를 설정/해제합니다 — 한 번의 호출로 둘 중 하나만 수행하며 동시에 둘 다 할 수 없습니다. 키 생성과 동일한 규칙을 가진 관리 엔드포인트입니다: Bearer 토큰은 Management API Key여야 하거나 로그인된 세션을 사용해야 합니다.

PATCH/api/v1/keys/:id

인증

Authorization필수

string · header

Authorization 헤더에 Bearer 토큰으로 API 키를 전달합니다.

경로 파라미터

id필수

string

업데이트할 키의 ID.

Body

enabled

boolean

이 키를 활성화(true) 또는 비활성화(false)합니다. 수동 전환은 이전의 지출 한도 자동 비활성화 플래그를 지우므로, 나중에 의도와 달리 조용히 자동 재활성화되는 일이 없습니다.

spendLimitUsd

number | null

지출 한도(USD)를 설정합니다. 한도를 해제하려면 null을 전달하세요. enabled와 상호 배타적입니다 — 하나의 요청에서는 둘 중 하나만 보낼 수 있습니다.

positive, ≤1,000,000

spendLimitPeriod

string | null

지출 한도의 재설정 주기. spendLimitUsd가 설정될 때마다 필수이며, 원래 값인 day/week/month만 허용됩니다 — 키 생성 엔드포인트와 달리 여기서는 daily/weekly/monthly 별칭이 허용되지 않습니다.

dayweekmonth

PATCH /api/v1/keys/:id

1
2
3
4
curl -X PATCH https://bazaarlink.ai/api/v1/keys/key_abc123 \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

응답 예시

업데이트됨. 응답은 단순한 확인 플래그일 뿐 전체 키 레코드가 아닙니다 — 현재 상태를 보려면 키 목록 조회를 다시 호출하세요.

1
2
3
{
  "updated": true
}