Clone Job To Template V1

Promote a job’s configuration into a reusable template. Captures params minus the per-call fields (instruction, idempotency key, etc.) into the new template’s…

POST /api/v1/jobs/{job_id}/clone-to-template

cURL

curl --request POST \
  --url 'https://api.computer.stateset.app/api/v1/jobs/{job_id}/clone-to-template' \
  --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.",
  "include_instruction": false
}'

201

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

Promote a job’s configuration into a reusable template.

Captures params minus the per-call fields (instruction, idempotency key, etc.) into the new template’s defaults. Useful workflow: iterate on a one-off /trigger call until it works, then clone-to-template to make it the team’s reusable starting point.

Reserved per-call params NOT carried into defaults: instruction (unless include_instruction=true), tags, webhook_url, webhook_secret, output_schema. Everything else (model, effort, max_cost_usd, custom params) is preserved.

Path parameters

job_id · string (uuid) · required

Request body

CloneJobToTemplateRequest

name · string · required

Template name. Same rules as POST /templates: alphanumeric + underscore + dash, must not collide with a built-in or an existing tenant template.

description · string · required

Human-readable purpose; surfaces in GET /templates.

include_instruction · boolean

When true, the source job’s instruction is captured as a template default. Most callers want false (the instruction is per-call, the template captures the surrounding config).

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/jobs/{job_id}/clone-to-template' \
  --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.",
  "include_instruction": false
}'

201

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