認証
Management API 呼び出しでは、Authorization: Bearer sk_live_* または Authorization: Bearer sk_test_* を使用します。キーのスコープは解決された Tenant に限定されます。Organization リソースでは、要求された Organization がその Tenant に属していることも確認します。
curl https://xid.dev/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 を使用します。