Create Template V1

Create a tenant-owned template. Returns 422 if the name collides with a platform built-in, 409 if a template with the same name already exists for the tenant.

POST /api/v1/templates

cURL

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

201

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

Create a tenant-owned template.

Returns 422 if the name collides with a platform built-in, 409 if a template with the same name already exists for the tenant.

Request body

CreateTemplateRequest

name · string · required

Template identifier — passed as agent_type on /trigger. Alphanumeric + underscore + dash; must not collide with a platform built-in name.

description · string · required

Human-readable purpose; surfaces in GET /templates.

defaults · object

Default params merged into every trigger that targets this template. The tenant’s request payload overrides on key collision.

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
201	Successful Response
422	Validation Error

cURL

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

201

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