Update agent task template¶

Updates a saved agent task template; fields not provided retain their original values.

PATCH https://moi.matrixorigin.cn/newmoi/workspaces/{workspace_id}/agent-task-templates/{template_id}

Before you call¶

Prepare personal access token, workspace ID, and template ID.

The example below uses:

$AI_STUDIO_API_KEY: Actual personal access token.
$WORKSPACE_ID: Target workspace ID.
$TEMPLATE_ID: Template ID to update.

Request example¶

curl -X PATCH "https://moi.matrixorigin.cn/newmoi/workspaces/$WORKSPACE_ID/agent-task-templates/$TEMPLATE_ID" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d '{
    "description": "用于工作流中的摘要节点"
  }'

Path parameters¶

Parameters	Type	Is it required	Description
`workspace_id`	string	Yes	The target workspace ID.
`template_id`	string	Yes	The ID of the template to update.

Request body¶

Parameters	Type	Is it required	Description
`name`	string	No	Template name.
`agent_id`	string	No	ID of the agent to be called.
`description`	string	No	Template description.
`message_template`	object	No	Task message template.
`input_schema`	object	No	Input structure definition.
`default_context_refs`	array	No	Default context reference.
`runtime_policy_ref`	string	No	Run policy reference.
`idempotency_policy`	object	No	Idempotent policy.
`output_contract`	object	No	Output contract.
`status`	string	No	Template status.
`labels`	object	No	Tag key-value pair.
`annotations`	object	No	Annotation key-value pair.

Successful response¶

Returns 200 and the updated template on success.

{"code": 0, "data": {"id": "template_01", "description": "用于工作流中的摘要节点"}}

The response fields are as follows.

Field	Type	Description
`code`	integer	`0` on success.
`data.id`	string	Template ID.
`data.description`	string	Updated template description.

Error response¶

{"code": 5, "message": "agent task template not found"}

Common HTTP errors¶

HTTP status code	error code	Common causes	Recommended actions
`400`	`2`	The request body is invalid.	Check the fields to be updated.
`404`	`5`	The template does not exist.	Check template ID.

Last updated on Sep 3, 2026