CyclesController_applyTemplateUpdate
POST
/api/cycles/streams/{streamId}/cycles/{cycleId}/template-update
const url = 'https://api.streams.chat/api/cycles/streams/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/cycles/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/template-update';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"targetVersion":1,"expectedUpdatedAt":"2026-04-15T12:00:00Z","cycle":{"triggerName":"example","description":"example","phasesTemplate":[{"id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","agentId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","goal":"example","instructions":"example","autoAdvance":true,"loopUntilGoalMet":true,"phaseName":"example","operatorPool":["2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"],"operatorScope":"phase","operatorStrategy":"random","operatorAgentId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","operatorAgentPrompt":"example","assetIds":[],"sourcePhaseId":null}]},"graph":{"version":1,"startNodeId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","defaultTarget":{"kind":"complete"},"nodes":[{"id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","kind":"phase","phaseId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","next":{"kind":"node","nodeId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"}}]}}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.streams.chat/api/cycles/streams/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/cycles/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/template-update \ --header 'Content-Type: application/json' \ --data '{ "targetVersion": 1, "expectedUpdatedAt": "2026-04-15T12:00:00Z", "cycle": { "triggerName": "example", "description": "example", "phasesTemplate": [ { "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "agentId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "goal": "example", "instructions": "example", "autoAdvance": true, "loopUntilGoalMet": true, "phaseName": "example", "operatorPool": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ], "operatorScope": "phase", "operatorStrategy": "random", "operatorAgentId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "operatorAgentPrompt": "example", "assetIds": [], "sourcePhaseId": null } ] }, "graph": { "version": 1, "startNodeId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "defaultTarget": { "kind": "complete" }, "nodes": [ { "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "kind": "phase", "phaseId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "next": { "kind": "node", "nodeId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" } } ] } }'Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”streamId
required
string format: uuid
cycleId
required
string format: uuid
Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
targetVersion
required
integer
expectedUpdatedAt
required
string format: date-time
cycle
required
object
triggerName
required
string
description
required
string
phasesTemplate
required
Array<object>
object
id
required
string format: uuid
agentId
required
string format: uuid
goal
required
string
instructions
required
string
autoAdvance
required
boolean
loopUntilGoalMet
boolean
phaseName
required
string
operatorPool
required
Array<string>
operatorScope
string
operatorStrategy
string
operatorAgentId
string format: uuid
operatorAgentPrompt
string
assetIds
Array<string>
sourcePhaseId
string format: uuid
graph
object
version
required
number
startNodeId
required
string format: uuid
defaultTarget
required
object
kind
required
string
nodes
required
Array<object>
One of:
object
id
required
string format: uuid
kind
required
string
condition
required
One of:
object
type
required
string
statement
required
string
yesDescription
string
noDescription
string
object
type
required
string
statement
required
string
options
required
Array<object>
object
id
required
string format: uuid
name
required
string
description
string
object
type
required
string
statement
required
string
levels
Array<object>
object
id
required
string format: uuid
description
required
string
branches
required
Array<object>
object
id
required
string format: uuid
label
required
string
predicate
required
Any of:
object
kind
required
string
optionIds
required
Array<string>