Forward テンプレートを ID で取得します。
GET /api/v1/forward/templates/{template_id}
エージェント設定とセッションのデフォルト値を含む、完全なテンプレートオブジェクトを返します。
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <PAT または SAT> |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
template_id | string | Yes | Forward の Template ID。 |
Example request
Example response
HTTP 200 OK
Response fields
| Field | Type | Description |
|---|---|---|
type | string | 常に template。 |
id | string | Template ID。 |
name | string | テンプレート名。 |
status | string | active または archived。 |
model | string | object | モデル ID 文字列、または id と任意の effort、speed、context_window を含むオブジェクト。Model を参照してください。 |
max_tool_rounds | integer | 1 Turn あたりのツール呼び出しラウンド数の上限。 |
multiagent | object | null | Multi-agent 設定。{"type":"advisor","model":"ultimate"} を含めることができ、Advisor のモデルは文字列です。Multiagent を参照してください。 |
managed_tool_config | object | Template の Forward 管理対象機能のベースライン。設定されている場合は enabled_tools 配列として返されます。 |
vaults | object | Vault ID をキーとするデフォルトの Vault 設定。 |
github_repositories | object | デフォルトの GitHub リポジトリ設定。正規化された url と最終的な mount_path を含み、authorization_token は含みません。 |
system | string | システムプロンプト。 |
environment_id | string | デフォルトの Environment ID。 |
metadata | object | カスタムメタデータ。 |
Errors
| HTTP | Type | Code | Trigger |
|---|---|---|---|
| 403 | permission_error | - | このリソースへのアクセス権がない。 |
| 404 | not_found_error | - | テンプレートが存在しない、または呼び出し元に表示されない。 |
| 401 | authentication_error | authentication_required | PAT または SAT が無効または有効期限切れです。 |
Notes
- アーカイブ済みのテンプレートも ID で取得できます。
managed_tool_config.enabled_toolsは Template の完全なベースラインです。Identity レベルのセレクターごとのオーバーライドは Identity Config を照会してください。scheduleは、Schedule の作成、照会、削除の 3 つの Forward 管理対象機能を同時に有効化します。driveは Drive 機能全体を表します。レスポンスはこれらの設定セレクターを保持し、実行ツール名に展開しません。- 実行時のみに存在する Qoder Cloud Agents のフィールドは、このレスポンスには追加されません。
github_repositories.*.authorization_tokenは書き込み専用で、Template のレスポンスには含まれません。