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

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

# 관리 API

## 인증

Management API 호출은 `Authorization: Bearer sk_live_*` 또는 `Authorization: Bearer sk_test_*`를 사용합니다. 키의 범위는 확인된 Tenant로 제한됩니다. Organization 리소스는 요청한 Organization이 해당 Tenant에 속하는지도 확인합니다.

```shell
curl https://vonvon.id/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/project-grants` | 프로젝트 권한 부여를 생성, 나열, 조회, 취소 및 삭제합니다. | 구현됨 |
| `/v1/user-grants` | 범위가 지정된 사용자 권한 부여를 할당, 나열, 조회, 취소 및 삭제합니다. | 구현됨 |
| `/v1/organizations/:orgId/domains` | 조직 도메인을 나열, 생성 및 제거합니다. | 구현됨 |
| `/v1/organizations/:orgId/custom-hostnames` | 사용자 정의 호스트 이름을 생성, 검사, 새로 고침 및 제거합니다. | 구현됨 |
| `/v1/organizations/:orgId/audit-events` | 커서 페이지 매김을 사용하여 조직 감사 이벤트를 읽습니다. | 구현됨 |
| `/v1/webhooks` | Webhook 엔드포인트를 생성, 조회, 업데이트, 삭제합니다. | 구현됨 |
| `/v1/api-keys` | 조직 API 키를 생성, 조회, 폐기합니다. | 구현됨 |
| `/v1/organizations/:orgId/scim-targets` | 아웃바운드 SCIM 대상을 생성, 업데이트, 동기화 및 제거합니다. | 구현됨 |

## 페이지네이션 및 오류

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

Source: https://vonvon.id/ko/management-api/index.mdx