---
title: "관리 API"
description: "범위가 지정된 API 키로 백엔드에서 조직 리소스를 관리합니다."
locale: "ko"
---

> Documentation Index
> Fetch the locale documentation index at: https://xid.dev/ko/llms.txt
> Use this file to discover all available pages before exploring further.

# 관리 API

## 인증

관리 API 호출은 `Authorization: Bearer sk_live_*` 또는 `Authorization: Bearer sk_test_*`를 사용합니다. 키는 조직별로 범위가 제한되며 각 리소스 작업 전에 검사됩니다.

```shell
curl https://xid.dev/v1/users \
  -H 'Authorization: Bearer sk_live_xxx'
```

## 리소스

| 리소스 | 기능 | 상태 |
| --- | --- | --- |
| `/v1/users` | 사용자를 생성, 조회, 업데이트, 차단, 차단 해제, 내보내기, 제거합니다. | 구현됨 |
| `/v1/organizations` | 조직, 도메인, 브랜딩, 설정을 관리합니다. | 구현됨 |
| `/v1/organizations/:orgId/memberships` | 멤버를 조회, 추가, 역할 업데이트, 제거합니다. | 구현됨 |
| `/v1/organizations/:orgId/invitations` | 초대를 생성(bulk 제한 있음), 폐기, 조회합니다. | 구현됨 |
| `/v1/sessions` | 사용자 세션을 조회, 가져오기, 폐기합니다. | 구현됨 |
| `/v1/applications` | OAuth 클라이언트, 리디렉션 URI, 권한 부여, 토큰 정책, 비밀값을 등록합니다. | 구현됨 |
| `/v1/connections` | Upstream 엔터프라이즈 SSO 연결을 관리합니다. | 구현됨 |
| `/v1/directories` | SCIM 디렉터리를 만들고 디렉터리 토큰을 순환합니다. | 구현됨 |
| `/v1/roles` | 사용자 정의 역할을 생성, 조회, 업데이트, 삭제합니다. | 구현됨 |
| `/v1/permissions` | 권한을 생성, 조회, 업데이트, 삭제합니다. | 구현됨 |
| `/v1/users/:userId/emailAddresses` | 기본 이메일 주소를 추가, 제거, 설정합니다. | 구현됨 |
| `/v1/users/:userId/phoneNumbers` | 기본 전화번호를 추가, 제거, 설정합니다. | 구현됨 |
| `/v1/allowlist-identifiers` | 허용된 이메일 또는 도메인 식별자를 생성, 삭제, 조회합니다. | 구현됨 |
| `/v1/oauth-applications` | XID가 ID 공급자로 동작하는 OAuth 애플리케이션을 관리합니다. | 구현됨 |
| `/v1/redirect-urls` | 허용된 리디렉션 URL 값을 등록 및 제거합니다. | 구현됨 |
| `/v1/webhooks` | Webhook 엔드포인트를 생성, 조회, 업데이트, 삭제합니다. | 구현됨 |
| `/v1/api-keys` | 조직 API 키를 생성, 조회, 폐기합니다. | 구현됨 |
| `/v1/billing` | 플랜 조회, 구독 관리, 결제 내역 확인. | 계획됨 |

## 페이지네이션 및 오류

목록 엔드포인트는 데이터 배열과 커서 메타데이터를 반환합니다. 오류는 안정적인 코드, 읽기 쉬운 메시지, 필드 검증용 선택적 메타데이터를 포함한 구조화된 JSON을 사용합니다.

Source: https://xid.dev/ko/management-api/index.mdx