사용자 지정 도메인을 기본으로 지정

POST /v1/custom-domains/{custom_domain_id}:make-primary · 권한 custom-domains:write

도메인을 환경의 기본 사용자 지정 도메인으로 지정합니다(호스팅된 로그인 링크가 이 도메인을 사용). 이전 기본 도메인은 같은 작업에서 그 역할을 잃습니다. 도메인은 active여야 하며, 이미 기본인 도메인을 다시 지정하면 아무것도 바뀌지 않습니다. 환경의 issuer가 사용자 지정 도메인에 있으면 기본 도메인 변경은 issuer를 바꾸므로 issuer 마이그레이션으로 예약해야 합니다.

요청

필드	유형	필수	설명
`custom_domain_id`	string	예	사용자 지정 도메인 ID(`cdom_…`).
`Idempotency-Key`	header	아니요	재시도된 요청을 안전하게 만드는 선택적 키 (16-64자).
`If-Match`	header	아니요	선택. 지정하면 도메인의 `ETag`와 일치해야 합니다(아니면 `412`).

요청 본문이 없습니다.

응답

200 OK와 도메인, ETag 헤더.

{
  "id": "cdom_01j9xk3m7q8r2s4t6v8w0y2z4a",
  "hostname": "login.example.com",
  "is_primary": true,
  "status": "active",
  "failure_reason": null,
  "dns_records": [
    {
      "type": "TXT",
      "name": "_akp-verify.login.example.com",
      "value": "idp-verify=3q2-7wEXAMPLEtokenQ9"
    },
    {
      "type": "CNAME",
      "name": "login.example.com",
      "value": "acme.eu.edge.keenauth.app"
    }
  ],
  "certificate_expires_at": "2027-01-04T09:31:12Z",
  "last_checked_at": "2026-10-05T09:31:00Z",
  "next_check_at": null,
  "activated_at": "2026-10-05T09:31:12Z",
  "degraded_since": null,
  "status_changed_at": "2026-10-05T09:31:12Z",
  "created_at": "2026-10-05T09:30:00.123456Z",
  "updated_at": "2026-10-05T09:31:12Z"
}

오류

HTTP	code	조건
404	`not_found`	사용자 지정 도메인이 없거나 다른 환경에 속합니다.
409	`custom_domain_state_conflict`	도메인이 `active`가 아닙니다.
409	`issuer_change_requires_schedule`	환경의 issuer가 사용자 지정 도메인에 있습니다. 변경은 issuer 마이그레이션으로 예약해야 합니다.
412	`precondition_failed`	`If-Match`가 도메인의 현재 버전과 일치하지 않습니다.
503	`service_unavailable`	환경의 issuer 정보를 일시적으로 사용할 수 없습니다.
401	`unauthenticated`	자격 증명이 없거나 유효하지 않거나 취소되었습니다.
403	`insufficient_permissions`	자격 증명에 필요한 권한이 없습니다.
429	`rate_limited`	속도 제한을 초과했습니다. `Retry-After` 시간 후에 다시 시도하세요.

예제

curl -X POST https://api.eu.keenauth.com/v1/custom-domains/cdom_01j9xk3m7q8r2s4t6v8w0y2z4a:make-primary \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "4"'