メインコンテンツへスキップ
POST
新しいセッションを作成
デフォルトのメンバーロールおよび管理者ロールであれば、どの APIキーでもこのエンドポイントを呼び出せます。Enterprise でカスタムロールまたは編集済みのロールを使用する場合は、Devinセッションの使用 権限 (UseDevinSessions) が含まれている必要があります。 セッションは、APIキーを所有するユーザーとして作成されます。

上限と検証

  • prompt は 30,000 文字以下にする必要があります。これを超えるプロンプトを指定すると 400 が返されます。
  • tags に指定できるタグは最大 50 個で、各タグは 256 文字以下の空でない文字列である必要があります。必須タグを強制適用しているエンタープライズでは、予約済みのタグ名を指定すると 400 で拒否されます。
  • structured_output_schema は、ルートに "type": "object" を持つ有効な JSON Schema (Draft 7) で、外部の $ref を含まず、サイズが 64 KB 以下である必要があります。これらの条件を満たさない場合、リクエストは 400 を返します。
  • レスポンスの is_new_session は、リクエストで idempotency_key(または非推奨の idempotent)を利用した場合にのみ設定されます。それ以外の場合は null になります。

承認

Authorization
string
header
必須

個人用APIキー (apk_user_*) またはサービス用APIキー (apk_*)

ボディ

application/json
prompt
string
必須
idempotent
boolean
デフォルト:false
knowledge_ids
string[] | null

使用する Knowledge ID のリストです。None の場合はすべての Knowledge を使用し、空リストの場合は Knowledge を使用しません。

max_acu_limit
integer | null

ACU の最大 limit。正の値である必要があります。

必須範囲: x > 0
playbook_id
string | null
secret_ids
string[] | null

使用するシークレット ID の一覧です。None が指定された場合は、すべてのシークレットを使用します。空リストが指定された場合は、シークレットを一切使用しません。

session_secrets
SessionSecretInput · object[] | null

使用するセッション固有のシークレットのリスト。このセッションでのみ利用可能で、組織のシークレットには保存されません。

snapshot_id
string | null
structured_output_schema
Structured Output Schema · object | null

構造化出力を検証するための JSON Schema(Draft 7 準拠)。最大 64KB。自己完結型である必要があります(外部への $ref 参照は不可)。

tags
string[] | null

セッションに追加するタグのリスト。

Maximum array length: 50
title
string | null

セッションのカスタムタイトル。None が指定された場合は、自動的にタイトルが生成されます。

unlisted
boolean
デフォルト:false

レスポンス

成功時のレスポンス

セッションが正常に作成された場合に返されるレスポンスボディ。

session_id
string
必須
url
string
必須
is_new_session
boolean | null