認証

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl -X GET "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer cog_your_token_here"

• Service User API Key は サービスユーザー として認証されます。つまり、サービスユーザーのアイデンティティ、権限、orgへの所属が適用されます。
• パーソナルアクセストークン は、それを作成した 人間のユーザー として認証されます。つまり、そのユーザーのアイデンティティ、権限、orgへの所属が適用されます。

1. Settings > Service users (組織) または Enterprise settings > Service users (Enterprise) で サービスユーザーを作成 します
2. サービスユーザーがアクセスできるエンドポイントを制御する ロールを割り当て ます
3. APIキーを生成 します — キーは cog_ で始まり、作成時に一度だけ表示されます
4. すべての API リクエストの Authorization ヘッダーに このキーを含め ます

curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Create a simple Python script"}'

• キーは cog_ で始まり、作成時に一度だけ表示されます
• サービスユーザーは、監査ログ上で人間のユーザーとは別に表示されます
• 権限は RBAC で制御されます — 連携に必要なものだけを付与してください
• Enterprise のサービスユーザーは、すべての組織にわたって org レベルの権限を継承します

1. キーを安全に保管する: 環境変数やシークレット管理システムを使用する
2. キーを定期的にローテーションする: 定期的に新しいキーを発行し、古いキーを失効させる
3. 自動化にはサービスユーザーを使用する: 本番環境では個人のキーではなくサービスユーザーを優先して使用する
4. 最小権限の原則を適用する: 必要最小限の権限のみを付与する
5. 利用状況を監視する: 予期しない API の利用がないか監査ログを確認する
6. 漏えいしたキーは直ちに失効させる: キーが漏えいした場合は、そのキーを失効させて新しいキーを発行する

• 無効または期限切れの APIキー
• Authorization ヘッダーが設定されていない
• Bearer トークン形式の誤り
• Devin MCP でレガシー APIキー (apk_ / apk_user_) を利用している — cog_ プレフィックスのキーのみがサポートされています

• API key に必要な権限が付与されていない
• エンドポイントに対して誤ったキー種別を使用している (例: v3 エンドポイントに legacy key を使用している)
• 許可スコープ外のリソースへアクセスしようとしている

• service user に正しいロールと権限が付与されていることを確認する
• legacy v2 エンドポイントの場合: Enterprise Admin ロールを持っていることを確認する
• legacy v1 エンドポイントの場合: 対象の組織 (organization) へのアクセス権があることを確認する

• API エンドポイント URL が正しくない
• リソースが存在しない、またはアクセス権限がない

• Teams クイックスタート — 数分で利用開始
• Enterprise クイックスタート — RBAC と複数組織環境のセットアップ
• 一般的なフロー — エンドツーエンドのワークフロー使用例
• 移行ガイド — v1/v2 からの移行