메인 콘텐츠로 건너뛰기
POST
curl

인증

Authorization
string
header
필수

Settings → Developers에서 발급한 키를 Authorization: Bearer dr_live_<12자리 16진수>_<64자리 16진수> 형태로 전송합니다. 키는 명시적인 범위를 가지며 — 각 엔드포인트에 필요한 범위가 해당 엔드포인트에 명시되어 있습니다. 전체 키는 발급 시점에 딱 한 번만 표시되며 다시 조회할 수 없습니다 — 이후에는 keyId 접두어만 표시됩니다. 폐기된 키는 바로 다음 요청부터 인증에 실패합니다.

본문

application/json
name
string
필수

태그 이름. 앞뒤 공백을 제거한 뒤 1~50자여야 하며 NUL 문자를 포함할 수 없습니다.

예시:

"webinar-oct"

응답

정확히 같은 이름의 태그가 이미 있습니다. 새로 만들지 않았고(created: false) 기존 태그를 반환합니다. 재시도는 여기로 옵니다.

id
string<uuid>
필수

태그 id.

name
string
필수

저장된 태그 이름(앞뒤 공백 제거, NFC 정규화).

created
boolean
필수

이 호출이 태그를 새로 만들었으면 true, 같은 이름의 태그가 이미 있었으면 false.