メインコンテンツへスキップ
POST /api/v1/forward/identities/{identity_id}/templates/{template_id}/config config が存在しない場合は作成し、存在する場合は既存のアクティブな config を更新します。Identity Config は Template のベースラインに対するユーザーレベルのオーバーライドです。

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT>
Content-TypeYesapplication/json
Idempotency-KeyNo安全でないリクエストに対する任意のべき等性キー。

​
Path parameters

ParameterTypeRequiredDescription
identity_idstringYesForward Identity ID。
template_idstringYesForward Template ID。

​
Body parameters

ParameterTypeRequiredDescription
namestringNoConfig の表示名。
identity_configobjectYesユーザーレベルのオーバーライド構成。
metadataobjectNoカスタムメタデータ。指定した場合は既存のメタデータを置き換えます。

​
Identity config object

identity_config は保存されるユーザーレベルのオーバーライド DSL です。これは Get Effective Config が返すコンパイル済みのランタイム構成ではありません。
FieldInternal targetDescription
systemAgentシステムプロンプトのオーバーライドまたは追加ルール。
modelAgentモデルのオーバーライド。
toolsAgentツール名をキーとする組み込みツールのオーバーライド。
mcp_serversAgentMCP サーバー名をキーとする MCP サーバーのオーバーライド。
skillsAgentSkill ID をキーとする Skill のオーバーライド。
toolsetsAgent主に MCP ツールセットや組み込みツールグループを対象とする、ツールセットレベルのオーバーライド。
agent_metadataAgentコンパイルされた agent メタデータにマージされるメタデータ。
vaultsSessionVault ID をキーとする Vault リソースのオーバーライド。
filesSessionFile ID をキーとする File リソースのオーバーライド。Forward が mount_path を注入するため、呼び出し元はここで指定しません。
environment / environment_idUnsupportedIdentity Config は Template の environment をオーバーライドできません。これらのフィールドを含むリクエストは 400 invalid_request_error で失敗します。

​
Update semantics

Request shapeSemantics
フィールドが省略されている既存の値を保持します。
フィールドが非 null 値で存在するそのフィールドを更新します。
フィールドが null で存在する現在の Identity Config からそのフィールドを削除します。
metadata が省略されている既存のメタデータを保持します。
metadata オブジェクト既存のメタデータを置き換えます。
metadata nullメタデータをクリアします。

​
Resource map semantics

skills、vaults、files はリソース ID をマップキーとして使用します。マップ項目の内部に skill_id、vault_id、file_id、id、resource_id を含めないでください。これらのランタイムフィールドは、Forward がコンパイルした Effective Config にのみ現れます。
Map item valueSemantics
{ "enabled": true }リソースを明示的に有効化またはオーバーライドします。
{ "enabled": false }Template のベースラインに存在していても、リソースを明示的に無効化します。
項目が省略されているTemplate のベースラインを継承します。
項目の値が nullこのオーバーライドを削除し、Template の継承を復元します。

​
Example request

curl -s -X POST 'https://api.qoder.com/api/v1/forward/identities/idn_019eabc123/templates/tmpl_support/config' \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "CRM profile",
    "identity_config": {
      "system": {
        "mode": "append",
        "content": "Prefer CRM data when answering."
      },
      "skills": {
        "skill_customer_reply": {
          "enabled": true,
          "type": "custom",
          "version": "1"
        },
        "skill_marketing_copy": {
          "enabled": false
        }
      },
      "mcp_servers": {
        "mcp_crm": {
          "enabled": true,
          "type": "http",
          "url": "https://crm.example.com/mcp"
        }
      },
      "tools": {
        "Read": { "enabled": true },
        "Grep": { "enabled": true },
        "WebSearch": { "enabled": true }
      },
      "vaults": {
        "vault_crm": { "enabled": true }
      },
      "files": {
        "file_019eXXXX": { "enabled": true }
      }
    },
    "metadata": {}
  }'

​
Example response

HTTP 200 OK 
{
  "type": "config",
  "identity_id": "idn_019eabc123",
  "template_id": "tmpl_support",
  "name": "CRM profile",
  "status": "active",
  "effective_hash": "sha256:...",
  "created_at": "2026-06-18T10:00:00Z",
  "updated_at": "2026-06-18T10:00:00Z"
}

​
Response fields

FieldTypeDescription
typestring常に config。
identity_idstringForward Identity ID。
template_idstringForward Template ID。
namestringConfig の表示名。
statusstringConfig のステータス。
effective_hashstringコンパイルされた有効な構成のハッシュ。
created_atstring作成タイムスタンプ。
updated_atstring更新タイムスタンプ。

​
Errors

HTTPTypeTrigger
400invalid_request_errorconfig フィールドが無効、サポートされていない environment のオーバーライド、または無効なボディです。
401authentication_errorPAT が無効または期限切れです。
404not_found_errorIdentity、Template、Skill、Vault、または File が存在しません。
409conflict_errorconfig の状態が競合しています。

​
Notes

  • 省略された config フィールドは変更されません。
  • フィールドを null に設定すると、現在の Identity Config からそのフィールドが削除されます。
  • リソースマップは、そのリソース ID をマップキーとして使用します。1 つのリソースの継承を復元するには、そのマップエントリを null に設定します。
  • Identity Config は environment_id のオーバーライドをサポートしていません。

アイデンティティ構成を取得する

有効な構成を取得する