---
title: "管理 API"
description: "スコープ付き API キーでバックエンドから組織リソースを管理します。"
locale: "ja"
---

> Documentation Index
> Fetch the relevant documentation index at: https://vonvon.id/ja/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` | 招待の作成（一括上限あり）、取り消し、一覧表示を行います。 | 実装済み |
| `/v1/sessions` | ユーザーセッションの一覧表示、取得、取り消しを行います。 | 実装済み |
| `/v1/applications` | OAuth クライアント、リダイレクト URI、グラント、トークンポリシー、シークレットを登録します。 | 実装済み |
| `/v1/connections` | 上流エンタープライズ 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/ja/management-api/index.mdx