メインコンテンツへスキップ
v3 API は、サービスユーザー認証付きのフル RBAC サポートを提供します。本番環境での自動化には、この API の利用を推奨します。
v3 API は現在ベータ版です。API の改善に伴い、一部のエンドポイントは変更される可能性があります。
ベース URL:
  • https://api.devin.ai/v3beta1/enterprise/* – **エンタープライズ（アカウントレベル）**権限が必要なエンドポイント
  • https://api.devin.ai/v3beta1/organizations/* – 単一の組織を対象とするエンドポイント
認証方式: サービスユーザーの認証情報（エンタープライズまたは組織レベル） (詳細はこちら)
一部のエンタープライズエンドポイントは特定の組織を対象としますが、 それでもエンタープライズレベルの権限で保護されています。これらは /v3beta1/enterprise/organizations/{org_id}/... のようなパスを使用します（例: GET /v3beta1/enterprise/organizations/{org_id}/audit-logs）。 org_id パスパラメータを含んでいても、ManageEnterpriseSettings のような エンタープライズレベルの権限が引き続き必要です。

​
Permissions and RBAC

v3 API では、サービスユーザーに対してロールベースアクセス制御（RBAC）を使用します。各エンドポイントには、サービスユーザーのロールに割り当てられた特定の権限が必要です。サービスユーザーは Enterprise レベルまたは組織レベルのいずれかで作成でき、その権限によってアクセス可能なエンドポイントが決まります。

​
権限の種類

v3 API では、次の権限を使用します。
Permission説明エンドポイント
ManageAccountKnowledgeEnterprise または組織レベルの Knowledge ノートを管理Notes のエンドポイント (GET, POST, PUT, DELETE)
ManageAccountPlaybooksEnterprise または組織レベルの Playbook を管理Playbooks のエンドポイント (GET, POST, PUT, DELETE)
ManageEnterpriseSettings組織タグを含む Enterprise 全体の設定を管理Tags のエンドポイント、組織管理

​
サービスユーザーのスコープ

Enterprise サービスユーザーは Enterprise 全体のリソースにアクセスでき、Enterprise 内のすべての組織をまたいで操作できます。/v3beta1/enterprise/* 配下のエンドポイントを使用します。 Organization サービスユーザーは特定の組織に紐づいており、その組織内のリソースにのみアクセスできます。/v3beta1/organizations/{org_id}/* 配下のエンドポイントを使用します。

​
サービスユーザーの作成

サービスユーザーは次の方法で作成できます。
  • Enterprise Settings → Service Users: カスタムロールを持つ Enterprise レベルまたは組織レベルのサービスユーザーを作成できます
認証およびトークン生成の詳細については、Authentication Guide を参照してください。

​
Self

認証済みサービスユーザーの情報を取得します。

Self の取得

認証済みサービスユーザーの情報を取得します

​
監査ログ

包括的な監査証跡にアクセスします:

Enterprise 監査ログ

Enterprise 全体の監査ログを取得

Organization 監査ログ

特定の Organization の監査ログを取得

​
利用状況

詳細な利用量指標を追跡できます:

利用サイクル

利用サイクルの概要を表示

日次利用状況

日次の利用量の内訳を取得

組織別

組織別の利用量を追跡

ユーザー別

ユーザー別の利用量を追跡

セッション別

セッション別の利用量を追跡

​
組織

RBAC によるアクセス制御で組織を管理:

組織一覧

すべての組織を表示

組織の作成

新しい組織を作成

組織の更新

組織の設定を更新

組織の削除

組織を削除

​
サービスユーザー

Enterprise レベルおよび組織レベルのサービスユーザーを管理します。

Enterprise サービスユーザーの一覧

Enterprise のサービスユーザーを表示

Enterprise サービスユーザーの作成

Enterprise のサービスユーザーを作成

Enterprise サービスユーザーの更新

Enterprise のサービスユーザーを更新

Enterprise サービスユーザーの削除

Enterprise のサービスユーザーを削除

組織サービスユーザーの一覧

組織のサービスユーザーを表示

組織サービスユーザーの作成

組織のサービスユーザーを作成

​
ユーザー

Enterprise レベルおよび組織レベルのユーザーを管理します。

Enterprise ユーザー一覧

Enterprise ユーザーを表示

Enterprise ユーザーを追加

Enterprise にユーザーを追加

Enterprise ユーザーを更新

Enterprise ユーザーを更新

Enterprise ユーザーを削除

Enterprise からユーザーを削除

組織ユーザー一覧

組織ユーザーを表示

組織ユーザーを追加

組織にユーザーを追加

​
IDP グループ

Enterprise レベルと組織レベルで IdP グループを管理します。

Enterprise グループの一覧

Enterprise の IdP グループを表示

Enterprise グループの追加

Enterprise に IdP グループを追加

組織グループの一覧

組織の IdP グループを表示

組織グループの追加

組織に IdP グループを追加

​
Git 権限

リポジトリへのアクセス権を管理します：

権限を一覧表示

組織の Git 権限を表示します

権限を追加

Git 権限を追加します

権限を削除

Git 権限を削除します

​
ノート

Enterprise レベルおよび組織レベルでのナレッジノートを管理します。

Enterprise ノート一覧

Enterprise のナレッジノートを表示します

Enterprise ノート作成

新しい Enterprise ノートを作成します

組織ノート一覧

組織のナレッジノートを表示します

組織ノート作成

新しい組織ノートを作成します

​
プレイブック

Enterprise レベルおよび組織レベルでプレイブックを管理します。

Enterprise プレイブック一覧

Enterprise プレイブックを表示する

Enterprise プレイブックを作成

新しい Enterprise プレイブックを作成する

組織プレイブック一覧

組織プレイブックを表示する

組織プレイブックを作成

新しい組織プレイブックを作成する

​
セッション

組織内のセッションを管理します：

セッション一覧

組織のセッションを表示します

セッションを作成

新しいセッションを作成します

​
タグ

組織のタグを管理します（セッションタグ機能が必要です）:

タグを取得

組織のタグを表示します

タグを追加

組織にタグを追加します

タグを置き換え

組織のすべてのタグを置き換えます

タグを削除

特定のタグを削除します

​
ロールとメトリクス

ロール一覧

利用可能なロールを確認

利用状況メトリクス

Enterprise の利用状況メトリクスを取得

組織メトリクス

組織の利用状況メトリクスを取得

​
使用例

コード例を見る

v3 API のコード例や代表的なユースケースをご覧ください