help / router / agents_create

agents_createwrite

POST /api/agents — provision agent specialist + insert definition (owner only) · auth: authenticated

POST /api/agents

signature sha256:a3e3e9a4caaf2060f63d51b6c8d288e1

Parameters

nametyperequirednotes
namestringyesHuman-readable label.
descriptionstring | nullnoWhat the agent does, in prose.
scriptstringyesJavaScript source to execute (ES2023).
cron_expressionstringyesFive-field cron expression.
timezonestring | nullnoIANA timezone for cron evaluation.
timeout_msnumber | nullnoPer-run wall-clock timeout (ms).
hold_cost_nanonumber | nullnoToken hold placed before each run (nano; 1 USD = 1e9).
envobject | nullnoKey/value pairs injected into the sandbox.
enabledboolean | nullnoWhether the scheduler ticks this definition.

Response

nametypedescription
definitionobject

Call it

write requires auth: authenticated