Update Template V1

Update description and/or defaults on a tenant-owned template…

PATCH /api/v1/templates/{name}

cURL

curl --request PATCH \
  --url 'https://api.computer.stateset.app/api/v1/templates/{name}' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "description": "Two-person tent, green — replacement for damaged pole set.",
  "defaults": {}
}'

200

{
  "name": "Two-Person Tent",
  "kind": "builtin",
  "description": "Two-person tent, green — replacement for damaged pole set."
}

Update description and/or defaults on a tenant-owned template.

The template name is immutable — to rename, delete and re-create (which intentionally orphans referencing job rows from the old name). Built-in templates cannot be modified.

Path parameters

name · string · required

Request body

UpdateTemplateRequest

description · string,null

New description; omit to leave unchanged.

defaults · object,null

New defaults dict. Replaces the entire defaults blob — pass the merged result, not a partial. Omit to leave unchanged.

Response

TemplateInfo

name · string · required

The exact string to pass as agent_type on /trigger.

kind · string · required

builtin ships with the platform; tenant is owned by your org.

description · string,null

Human-readable description (tenant templates only).

Status codes

Code	Meaning
200	Successful Response
422	Validation Error

cURL

curl --request PATCH \
  --url 'https://api.computer.stateset.app/api/v1/templates/{name}' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "description": "Two-person tent, green — replacement for damaged pole set.",
  "defaults": {}
}'

200

{
  "name": "Two-Person Tent",
  "kind": "builtin",
  "description": "Two-person tent, green — replacement for damaged pole set."
}