セッションインサイトを生成

必要に応じてセッションインサイトの生成をトリガーします。

インサイトがすでに生成されている場合は already_exists を返します。 それ以外の場合は、バックグラウンドで生成を開始します。生成完了後、結果を取得するには GET insights エンドポイントをポーリングしてください。

POST /v3/organizations/{org_id}/sessions/{devin_id}/insights/generate

セッションインサイトを生成

cURL

curl --request POST \
  --url https://api.devin.ai/v3/organizations/{org_id}/sessions/{devin_id}/insights/generate \
  --header 'Authorization: Bearer <token>'

200

{
  "session_id": "<string>",
  "status": "<string>"
}

devin_id は、セッション ID に devin- を接頭辞として付けたものです (例: devin-abc123) 。

​

権限

組織レベルのManageOrgSessions権限を持つサービスユーザーが必要です。

​

挙動

• インサイトがすでに生成済みである場合 (または生成中の場合) 、エンドポイントは再度トリガーせず、{ "status": "already_exists" } を返します。
• インサイトが存在しない場合 (または前回の試行が失敗した場合) 、エンドポイントはバックグラウンドで生成を開始し、{ "status": "started" } を返します。
• 生成完了後に結果を取得するには、GET セッションインサイト エンドポイントをポーリングしてください。

承認

Authorization · string · header · 必須

サービスユーザーの認証情報（接頭辞: cog_）

パスパラメータ

devin_id · string | null · 必須

Devin セッション ID（プレフィックス: devin-）

例:

"devin-abc123def456"

org_id · string | null · 必須

組織 ID（プレフィックス: org-）

例:

"org-abc123def456"

レスポンス

200

application/json

成功レスポンス

セッションインサイトの生成をトリガーした際のレスポンス。

session_id · string · 必須

インサイト生成がトリガーされたセッション ID。

status · string · 必須

生成リクエストのステータス。