セッションを作成

curl --request POST \
  --url https://api.devin.ai/v3/organizations/{org_id}/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "advanced_mode": "analyze",
  "attachment_urls": [
    "<string>"
  ],
  "bypass_approval": true,
  "child_playbook_id": "<string>",
  "create_as_user_id": "<string>",
  "knowledge_ids": [
    "<string>"
  ],
  "max_acu_limit": 123,
  "playbook_id": "<string>",
  "repos": [
    "<string>"
  ],
  "secret_ids": [
    "<string>"
  ],
  "session_links": [
    "<string>"
  ],
  "session_secrets": [
    {
      "key": "<string>",
      "value": "<string>",
      "sensitive": true
    }
  ],
  "structured_output_schema": {},
  "tags": [
    "<string>"
  ],
  "title": "<string>"
}
'

{
  "acus_consumed": 123,
  "created_at": 123,
  "org_id": "<string>",
  "pull_requests": [
    {
      "pr_state": "<string>",
      "pr_url": "<string>"
    }
  ],
  "session_id": "<string>",
  "status": "new",
  "tags": [
    "<string>"
  ],
  "updated_at": 123,
  "url": "<string>",
  "child_session_ids": [
    "<string>"
  ],
  "is_advanced": false,
  "is_archived": false,
  "parent_session_id": "<string>",
  "playbook_id": "<string>",
  "service_user_id": "<string>",
  "status_detail": "working",
  "structured_output": {},
  "title": "<string>",
  "user_id": "<string>"
}

POST

organizations

{org_id}

sessions

セッションを作成

curl --request POST \
  --url https://api.devin.ai/v3/organizations/{org_id}/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "advanced_mode": "analyze",
  "attachment_urls": [
    "<string>"
  ],
  "bypass_approval": true,
  "child_playbook_id": "<string>",
  "create_as_user_id": "<string>",
  "knowledge_ids": [
    "<string>"
  ],
  "max_acu_limit": 123,
  "playbook_id": "<string>",
  "repos": [
    "<string>"
  ],
  "secret_ids": [
    "<string>"
  ],
  "session_links": [
    "<string>"
  ],
  "session_secrets": [
    {
      "key": "<string>",
      "value": "<string>",
      "sensitive": true
    }
  ],
  "structured_output_schema": {},
  "tags": [
    "<string>"
  ],
  "title": "<string>"
}
'

{
  "acus_consumed": 123,
  "created_at": 123,
  "org_id": "<string>",
  "pull_requests": [
    {
      "pr_state": "<string>",
      "pr_url": "<string>"
    }
  ],
  "session_id": "<string>",
  "status": "new",
  "tags": [
    "<string>"
  ],
  "updated_at": 123,
  "url": "<string>",
  "child_session_ids": [
    "<string>"
  ],
  "is_advanced": false,
  "is_archived": false,
  "parent_session_id": "<string>",
  "playbook_id": "<string>",
  "service_user_id": "<string>",
  "status_detail": "working",
  "structured_output": {},
  "title": "<string>",
  "user_id": "<string>"
}

権限

組織レベルで ManageOrgSessions 権限が付与されたサービスユーザーが必要です。

高度な機能用の追加権限

機能	必要な権限
`advanced_mode`	`UseDevinExpert`
`create_as_user_id`	`ImpersonateOrgSessions`

高度なモード

advanced_mode パラメータは、自動化ワークフロー向けの専用のセッション挙動を有効にします。これを設定すると、セッションは高度なペルソナを使用し、選択したモードに応じてプロンプトが変換されます。

利用可能なモード

Mode	Description	Required Parameters
`analyze`	既存の Devin セッションを分析してインサイトを抽出します	`session_links`
`create`	セッション分析に基づいて新しいプレイブックを作成します	なし（任意: `session_links`）
`improve`	フィードバックに基づいて既存のプレイブックを改善します	`child_playbook_id`
`batch`	タスクのリストに対して複数の Devin セッションを開始します	`child_playbook_id`
`manage`	Knowledge を管理します	なし

バッチモードのオプション

batch モードを使用する場合、バッチセッションの作成時に承認ステップをスキップするため、必要に応じて bypass_approval を true に設定できます。これは、セッションを手動承認なしでただちに開始させたい、完全に自動化されたワークフローに便利です。

ユーザーのなりすまし

create_as_user_id パラメータを使用すると、別のユーザーに代わってセッションを作成できます。これには以下が必要です:

サービスユーザーが ImpersonateOrgSessions 権限を持っていること
対象ユーザーが組織のメンバーであること
対象ユーザーが UseDevinSessions 権限を持っていること

承認

Authorization

string

header

必須

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

ボディ

application/json

prompt

string

必須

advanced_mode

enum<string> | null

利用可能なオプション:

analyze,

create,

improve,

batch,

manage

attachment_urls

string<uri>[] | null

Required string length: 1 - 2083

bypass_approval

boolean | null

child_playbook_id

string | null

create_as_user_id

string | null

knowledge_ids

string[] | null

max_acu_limit

integer | null

playbook_id

string | null

repos

string[] | null

secret_ids

string[] | null

session_links

string[] | null

session_secrets

SessionSecretInput · object[] | null

表示子属性

structured_output_schema

Structured Output Schema · object

構造化出力を検証するための JSON Schema（Draft 7）。最大 64KB。自己完結している必要があり（外部 $ref や外部参照は使用できません）。

レスポンス

成功レスポンス

acus_consumed

number

必須

created_at

integer

必須

org_id

string

必須

pull_requests

SessionPullRequest · object[]

必須

表示子属性

session_id

string

必須

status

enum<string>

必須

利用可能なオプション:

new,

claimed,

running,

exit,

error,

suspended,

resuming

はじめに

基本概念

組織 API

Enterprise API

レガシー API v1

レガシー API v2

セッションを作成

権限

高度な機能用の追加権限

高度なモード

利用可能なモード

バッチモードのオプション

ユーザーのなりすまし

承認

ボディ

レスポンス

はじめに

基本概念

組織 API

Enterprise API

レガシー API v1

レガシー API v2

​権限

​高度な機能用の追加権限

​高度なモード

​利用可能なモード

​バッチモードのオプション

​ユーザーのなりすまし

承認

ボディ

レスポンス

権限

高度な機能用の追加権限

高度なモード

利用可能なモード

バッチモードのオプション

ユーザーのなりすまし