Templates · Daemon API

On this page

List agent templates

GET/templates

Operation listTemplatesAuthBearer token

Responses

Status Description Body

200 Templates TemplateList

templatesrequired array<TemplateSummary>

13 fields of templates

`id`required	string	File stem in the templates folder
`name`required	string
`description`	string
`icon`	string
`filePath`required	string
`shipped`	string	One of `standard`, `sandboxed`, `full-access`
`templateDescription`	string
`warning`	string
`reviewed`required	boolean	false = from someone else and not accepted yet
`modelProvider`	string
`modelId`	string
`modifiedAt`required	integer
`hasHistory`required	boolean

defaultIdrequired string

folderrequired string

defaultDirectoryrequired

string

Where POST /agents/create puts agents without directory

Errors 401 · 403 · 409 · 500 · 503

401 Missing or wrong bearer token (unauthorized)

403 The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin

409 No usable owner identity (identity_not_ready): set it up or unlock it first. identity carries its status. AgentCreateErrorResponse

errorrequired string

coderequired

string

One of bad_request, identity_not_ready, name_taken, template_missing, template_unreviewed, template_invalid, password_required, wrong_password, load_failed

identity object

7 fields of identity · IdentityStatus

`status`required	string	One of `none`, `locked`, `restore-needed`, `ready`
`ownerDid`required	string \| null
`runtimeDid`required	string \| null	This daemon's own runtime DID (never Studio's)
`storage`required	string	One of `keychain`, `file`
`backupConfirmed`required	boolean
`passphraseRequired`required	boolean	File storage not unlocked: create/restore/unlock take a passphrase
`message`required	string	What to do next

500 Unexpected runtime failure

503 The subsystem is not configured on this daemon

Error bodies use the error format.

Example

Request

curl "http://127.0.0.1:7385/templates" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Create a template (blank, or a duplicate of fromId)

POST/templates

Operation createTemplateAuthBearer token

A template is an ordinary .adf in <userData>/templates (Studio's Settings > Agent templates); its id is the file stem. New agents get everything in a template except its identity and history. A duplicate carries the notes, never the identity or history. Names: letters, digits, spaces, -, _, at most 64 characters.

Request bodyapplication/json · TemplateCreateBody · required

Field	Type	Description
`name`required	string
`fromId`	string	Duplicate this template (no identity or history carried)

Responses

Status Description Body

201 Created TemplateRef

idrequired

string

The (possibly new) template id

templaterequired TemplateSummary | null

13 fields of template

`id`required	string	File stem in the templates folder
`name`required	string
`description`	string
`icon`	string
`filePath`required	string
`shipped`	string	One of `standard`, `sandboxed`, `full-access`
`templateDescription`	string
`warning`	string
`reviewed`required	boolean	false = from someone else and not accepted yet
`modelProvider`	string
`modelId`	string
`modifiedAt`required	integer
`hasHistory`required	boolean

Errors 400 · 401 · 403 · 404 · 409 · 500 · 503

400	Invalid body or the template was refused (`bad_request`, `template_invalid`)	AgentCreateErrorResponse
401	Missing or wrong bearer token (`unauthorized`)
403	The request guard refused it: Host header not allowed (`host_not_allowed`, DNS-rebinding protection) or a browser cross-site request (`cross_origin`)`host_not_allowedcross_origin`
404	Unknown template (`template_missing`)	AgentCreateErrorResponse
409	No usable owner identity (`identity_not_ready`): set it up or unlock it first. `identity` carries its status.	AgentCreateErrorResponse
500	Unexpected runtime failure
503	The subsystem is not configured on this daemon

Error bodies use the error format.

Example

Request

curl -X POST "http://127.0.0.1:7385/templates" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Researcher","fromId":"standard"}'

One template: summary, contents and whether it is the default

GET/templates/{id}

Operation getTemplateAuthBearer token

Path parameters

Name	Type	Description
`id`required	string	Template id (the file stem in the templates folder) example: standard

Responses

Status Description Body

200 Template TemplateDetail

templaterequired TemplateSummary | null

13 fields of template

`id`required	string	File stem in the templates folder
`name`required	string
`description`	string
`icon`	string
`filePath`required	string
`shipped`	string	One of `standard`, `sandboxed`, `full-access`
`templateDescription`	string
`warning`	string
`reviewed`required	boolean	false = from someone else and not accepted yet
`modelProvider`	string
`modelId`	string
`modifiedAt`required	integer
`hasHistory`required	boolean

isDefaultrequired boolean

defaultIdrequired string

contentsrequired object

3 fields of contents · TemplateContents

configrequired

object

The agent's ADF v0.2 config (adf_config). Only the most used fields are listed; the full shape is the ADF spec's AgentConfig. Secret values never appear here.

25 fields of config · AgentConfig

adf_versionrequired

string

Value 0.2

idrequired

string

Agent id (stable, the daemon addresses the agent by it)

namerequired string

descriptionrequired string

handle string

icon string

staterequired

string

Display (fleet-map) state of an agent

One of active, idle, hibernate, suspended, off

autonomousrequired boolean

autostart boolean

modelrequired object

9 fields of model · ModelConfig

providerrequired

string

Provider id (app provider or one of the agent's own providers)

model_idrequired string

temperature number | null

max_tokens integer | null

top_p number | null

reasoning

object

Provider-agnostic reasoning ("thinking") config

multimodal object

3 fields of multimodal

`image`	boolean
`audio`	boolean
`video`	boolean

params array<object>

2 fields of params

`key`required	string
`value`required	string

provider_params object

instructionsrequired string

contextrequired

object

compact_threshold, audit, dynamic_instructions

toolsrequired

array<object>

Tool declarations

5 fields of tools

`name`required	string
`enabled`required	boolean
`visible`	boolean
`restricted`	boolean
`locked`	boolean

triggersrequired

map<string, TriggerConfig>

on_startup, on_inbox, on_outbox, on_file_change, on_chat, on_timer, on_tool_call, on_task_create, on_task_complete, on_logs, on_llm_call

3 fields of triggers

enabledrequired boolean

targetsrequired array<TriggerTarget>

11 fields of targets

`scope`required	string	One of `agent`, `system`
`lambda`	string	System scope: `path/file.ts:functionName`
`command`	string	System scope: shell command (alternative to lambda)
`warm`	boolean
`filter`	object
`debounce_ms`	integer
`interval_ms`	integer
`batch_ms`	integer
`batch_count`	integer
`locked`	boolean
`loop`	string	Cognition loop this target wakes; absent = main

locked boolean

securityrequired object

limitsrequired object

messagingrequired

object

mode (proactive | respond_only | listen_only), receive, network, …

mcp object

2 fields of mcp

serversrequired array<McpServerConfig>

20 fields of servers

`name`required	string
`transport`required	string	One of `stdio`, `http`
`command`	string
`args`	array<string>
`url`	string
`oauth`	boolean
`headers`	map<string, string>
`header_env`	array<object>
`bearer_token_env_var`	string
`env`	map<string, string>
`env_keys`	array<string>
`env_schema`	array<object>
`npm_package`	string
`pypi_package`	string
`source`	string
`available_tools`	array<object>
`tool_call_timeout_ms`	integer
`restricted`	boolean
`run_location`	string	One of `host`, `shared`
`credential_files`	array<object>

new_tools_restricted boolean

adapters

map<string, AdapterInstanceConfig>

Channel adapters by type

4 fields of adapters

enabledrequired boolean

config

object

Adapter-specific settings (no secrets: tokens are credentials)

policy object

limits object

1 field of limits

max_attachment_size

integer

Bytes

providers array<AgentProviderConfig>

8 fields of providers

idrequired

string

anthropic, openai, … or custom:<id>

typerequired

string

One of anthropic, openai, openai-compatible, openrouter

namerequired string

baseUrlrequired string

preset string

defaultModel string

params array<object>

2 fields of params

`key`required	string
`value`required	string

requestDelayMs integer

loops

array<LoopConfig>

Inner (side) loops; main is implicit

8 fields of loops

`name`required	string	pattern: ^[a-z0-9][a-z0-9_-]{0,31}$
`goal`required	string	Becomes the loop's instructions
`enabled`required	boolean
`autostart`	boolean
`autonomous`	boolean
`model`	object	Fields as in ModelConfig above.
`compact_threshold`	integer \| null
`tools`	array<string>	Absolute allow-list, intersected with the host's enabled tools

ws_connections array<object>

serving object

locked_fields array<string>

metadatarequired

object

created_at, updated_at, author, tags, version

filesrequired object

3 fields of files

`readme`required	string
`mind`required	string
`soul`required	string

extrarequired array<object>

3 fields of extra

`path`required	string
`size`required	integer
`mime`required	string

Errors 400 · 401 · 403 · 404 · 409 · 500 · 503

400	Invalid body or the template was refused (`bad_request`, `template_invalid`)	AgentCreateErrorResponse
401	Missing or wrong bearer token (`unauthorized`)
403	The request guard refused it: Host header not allowed (`host_not_allowed`, DNS-rebinding protection) or a browser cross-site request (`cross_origin`)`host_not_allowedcross_origin`
404	Unknown template (`template_missing`)	AgentCreateErrorResponse
409	No usable owner identity (`identity_not_ready`): set it up or unlock it first. `identity` carries its status.	AgentCreateErrorResponse
500	Unexpected runtime failure
503	The subsystem is not configured on this daemon

Error bodies use the error format.

Example

Request

curl "http://127.0.0.1:7385/templates/standard" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Rename a template and/or set its notes

PATCH/templates/{id}

Operation updateTemplateAuthBearer token

Notes are shown wherever the template is offered and never copied into agents ("" clears one; at most 500 characters). A rename moves the file (defaultId follows): the response carries the new id.

Path parameters

Name	Type	Description
`id`required	string	Template id (the file stem in the templates folder) example: standard

Request bodyapplication/json · TemplatePatchBody · required

Field	Type	Description
`name`	string	Rename (moves the file; the response carries the new id)
`description`	string	Empty string clears
`warning`	string	Empty string clears

Responses

Status	Description	Body
200	Updated	TemplateRef
Fields as in TemplateRef above.

Errors 400 · 401 · 403 · 404 · 409 · 500 · 503

400	Invalid body or the template was refused (`bad_request`, `template_invalid`)	AgentCreateErrorResponse
401	Missing or wrong bearer token (`unauthorized`)
403	The request guard refused it: Host header not allowed (`host_not_allowed`, DNS-rebinding protection) or a browser cross-site request (`cross_origin`)`host_not_allowedcross_origin`
404	Unknown template (`template_missing`)	AgentCreateErrorResponse
409	No usable owner identity (`identity_not_ready`): set it up or unlock it first. `identity` carries its status.	AgentCreateErrorResponse
500	Unexpected runtime failure
503	The subsystem is not configured on this daemon

Error bodies use the error format.

Example

Request

curl -X PATCH "http://127.0.0.1:7385/templates/standard" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"description":"For research agents"}'

Delete a template (moved to templates-trash)

DELETE/templates/{id}

Operation deleteTemplateAuthBearer token

Never a hard delete; the default falls back to standard.

Path parameters

Name	Type	Description
`id`required	string	Template id (the file stem in the templates folder) example: standard

Responses

Status Description Body

200 Deleted TemplateDeleteResponse

`deleted`required	boolean	Value `true`
`id`required	string
`trashFolder`required	string
`defaultId`required	string

Errors 400 · 401 · 403 · 404 · 409 · 500 · 503

400	Invalid body or the template was refused (`bad_request`, `template_invalid`)	AgentCreateErrorResponse
401	Missing or wrong bearer token (`unauthorized`)
403	The request guard refused it: Host header not allowed (`host_not_allowed`, DNS-rebinding protection) or a browser cross-site request (`cross_origin`)`host_not_allowedcross_origin`
404	Unknown template (`template_missing`)	AgentCreateErrorResponse
409	No usable owner identity (`identity_not_ready`): set it up or unlock it first. `identity` carries its status.	AgentCreateErrorResponse
500	Unexpected runtime failure
503	The subsystem is not configured on this daemon

Error bodies use the error format.

Example

Request

curl -X DELETE "http://127.0.0.1:7385/templates/standard" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Make this the default template

POST/templates/{id}/default

Operation setDefaultTemplateAuthBearer token

No body.

Path parameters

Name	Type	Description
`id`required	string	Template id (the file stem in the templates folder) example: standard

Responses

Status Description Body

200 Default set TemplateDefaultResponse

defaultIdrequired string

Errors 400 · 401 · 403 · 404 · 409 · 500 · 503

400	Invalid body or the template was refused (`bad_request`, `template_invalid`)	AgentCreateErrorResponse
401	Missing or wrong bearer token (`unauthorized`)
403	The request guard refused it: Host header not allowed (`host_not_allowed`, DNS-rebinding protection) or a browser cross-site request (`cross_origin`)`host_not_allowedcross_origin`
404	Unknown template (`template_missing`)	AgentCreateErrorResponse
409	No usable owner identity (`identity_not_ready`): set it up or unlock it first. `identity` carries its status.	AgentCreateErrorResponse
500	Unexpected runtime failure
503	The subsystem is not configured on this daemon

Error bodies use the error format.

Example

Request

curl -X POST "http://127.0.0.1:7385/templates/standard/default" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Reset a shipped template to the shipped version

POST/templates/{id}/reset

Operation resetShippedTemplateAuthBearer token

For a shipped template (standard, sandboxed, full-access, even renamed); 400 for a user template. No body.

Path parameters

Name	Type	Description
`id`required	string	Template id (the file stem in the templates folder) example: standard

Responses

Status	Description	Body
200	Reset	TemplateRef
Fields as in TemplateRef above.

Errors 400 · 401 · 403 · 404 · 409 · 500 · 503

400	Invalid body or the template was refused (`bad_request`, `template_invalid`)	AgentCreateErrorResponse
401	Missing or wrong bearer token (`unauthorized`)
403	The request guard refused it: Host header not allowed (`host_not_allowed`, DNS-rebinding protection) or a browser cross-site request (`cross_origin`)`host_not_allowedcross_origin`
404	Unknown template (`template_missing`)	AgentCreateErrorResponse
409	No usable owner identity (`identity_not_ready`): set it up or unlock it first. `identity` carries its status.	AgentCreateErrorResponse
500	Unexpected runtime failure
503	The subsystem is not configured on this daemon

Error bodies use the error format.

Example

Request

curl -X POST "http://127.0.0.1:7385/templates/standard/reset" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

The review summary of a template

GET/templates/{id}/review

Operation getTemplateReviewAuthBearer token

The agent review summary (identity scenario, tools, MCP, triggers, network, …). Provider status is unchecked or missing: credentials are not probed. Someone else's template (foreign or identity-less) shows reviewed: false, and POST /agents/create refuses it (422 template_unreviewed) until accepted.

Path parameters

Name	Type	Description
`id`required	string	Template id (the file stem in the templates folder) example: standard

Responses

Status Description Body

200 Review TemplateReview

idrequired string

needsReviewrequired boolean

reviewedrequired boolean

summaryrequired

object

What the agent can do, as the review dialog shows it (Studio's AgentConfigSummary).

13 fields of summary · ReviewSummary

namerequired string

descriptionrequired string

icon string

identityrequired

object

agentDid, fileOwnerDid, ownerIsYou, scenario (mine | recognized | foreign | unclaimed), needsClaim, …

computeTierrequired

string

One of shared, isolated, host

autostartrequired boolean

toolsrequired array<object>

3 fields of tools

`name`required	string
`enabled`required	boolean
`notable`required	boolean

mcpServersrequired array<object>

triggersrequired array<object>

3 fields of triggers

`type`required	string
`enabled`required	boolean
`targetCount`required	integer

codeExecutionrequired boolean

messagingrequired object

1 field of messaging

moderequired string

networkrequired object

securityrequired object

Errors 400 · 401 · 403 · 404 · 409 · 500 · 503

400	Invalid body or the template was refused (`bad_request`, `template_invalid`)	AgentCreateErrorResponse
401	Missing or wrong bearer token (`unauthorized`)
403	The request guard refused it: Host header not allowed (`host_not_allowed`, DNS-rebinding protection) or a browser cross-site request (`cross_origin`)`host_not_allowedcross_origin`
404	Unknown template (`template_missing`)	AgentCreateErrorResponse
409	No usable owner identity (`identity_not_ready`): set it up or unlock it first. `identity` carries its status.	AgentCreateErrorResponse
500	Unexpected runtime failure
503	The subsystem is not configured on this daemon

Error bodies use the error format.

Example

Request

curl "http://127.0.0.1:7385/templates/standard/review" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Accept a template: claim it under this owner and mark it reviewed

POST/templates/{id}/review/accept

Operation acceptTemplateReviewAuthBearer token

Claims the file with a fresh identity under this owner, auto-locks compute (and ws / adapters / table protections when set), marks it reviewed. password for a password-protected file (400 password_required, 403 wrong_password); 409 identity_not_ready when the owner keys are unavailable.

Path parameters

Name	Type	Description
`id`required	string	Template id (the file stem in the templates folder) example: standard

Request bodyapplication/json · TemplateReviewAcceptBody · optional

Field	Type	Description
`password`	string	For a password-protected template file

Responses

Status Description Body

200 Accepted TemplateReviewAcceptResponse

idrequired string

reviewedrequired

boolean

Value true

templaterequired TemplateSummary | null

13 fields of template

`id`required	string	File stem in the templates folder
`name`required	string
`description`	string
`icon`	string
`filePath`required	string
`shipped`	string	One of `standard`, `sandboxed`, `full-access`
`templateDescription`	string
`warning`	string
`reviewed`required	boolean	false = from someone else and not accepted yet
`modelProvider`	string
`modelId`	string
`modifiedAt`required	integer
`hasHistory`required	boolean

Errors 400 · 401 · 403 · 404 · 409 · 500 · 503

400	Invalid body or the template was refused (`bad_request`, `template_invalid`)	AgentCreateErrorResponse
401	Missing or wrong bearer token (`unauthorized`)
403	Wrong password (`wrong_password`), or the request guard refused it: Host header not allowed (`host_not_allowed`, DNS-rebinding protection) or a browser cross-site request (`cross_origin`)	AgentCreateErrorResponse
404	Unknown template (`template_missing`)	AgentCreateErrorResponse
409	No usable owner identity (`identity_not_ready`): set it up or unlock it first. `identity` carries its status.	AgentCreateErrorResponse
500	Unexpected runtime failure
503	The subsystem is not configured on this daemon

Error bodies use the error format.

Example

Request

curl -X POST "http://127.0.0.1:7385/templates/standard/review/accept" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Replace a template's agent config

PUT/templates/{id}/config

Operation setTemplateConfigAuthBearer token

Validated with the config schema; the first issue is the 400 error.

Path parameters

Name	Type	Description
`id`required	string	Template id (the file stem in the templates folder) example: standard

Request bodyapplication/json · TemplateConfigBody · required

Field	Type	Description
`config`required	object	The agent's ADF v0.2 config (adf_config). Only the most used fields are listed; the full shape is the ADF spec's AgentConfig. Secret values never appear here. Fields as in AgentConfig above.

Responses

Status Description Body

200 Saved TemplateConfigResponse

`id`required	string
`success`required	boolean	Value `true`

Errors 400 · 401 · 403 · 404 · 409 · 500 · 503

400	Invalid body or the template was refused (`bad_request`, `template_invalid`)	AgentCreateErrorResponse
401	Missing or wrong bearer token (`unauthorized`)
403	The request guard refused it: Host header not allowed (`host_not_allowed`, DNS-rebinding protection) or a browser cross-site request (`cross_origin`)`host_not_allowedcross_origin`
404	Unknown template (`template_missing`)	AgentCreateErrorResponse
409	No usable owner identity (`identity_not_ready`): set it up or unlock it first. `identity` carries its status.	AgentCreateErrorResponse
500	Unexpected runtime failure
503	The subsystem is not configured on this daemon

Error bodies use the error format.

Example

Request

curl -X PUT "http://127.0.0.1:7385/templates/standard/config" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "config": {
    "adf_version": "0.2",
    "id": "string",
    "name": "string",
    "description": "string",
    "state": "active",
    "autonomous": true,
    "model": {
      "provider": "anthropic",
      "model_id": "claude-sonnet-4-5"
    },
    "instructions": "string",
    "context": {},
    "tools": [],
    "triggers": {},
    "security": {},
    "limits": {},
    "messaging": {},
    "metadata": {}
  }
}'

Write a template file (seed or extra)

PUT/templates/{id}/files

Operation setTemplateFileAuthBearer token

Path parameters

Name	Type	Description
`id`required	string	Template id (the file stem in the templates folder) example: standard

Request bodyapplication/json · TemplateFileBody · required

Field	Type	Description
`path`required	string	README.md, mind.md, soul.md or an extra file path
`content`required	string

Responses

Status Description Body

200 Written TemplateFileResponse

`id`required	string
`path`required	string
`success`required	boolean	Value `true`

Errors 400 · 401 · 403 · 404 · 409 · 500 · 503

400	Invalid body or the template was refused (`bad_request`, `template_invalid`)	AgentCreateErrorResponse
401	Missing or wrong bearer token (`unauthorized`)
403	The request guard refused it: Host header not allowed (`host_not_allowed`, DNS-rebinding protection) or a browser cross-site request (`cross_origin`)`host_not_allowedcross_origin`
404	Unknown template (`template_missing`)	AgentCreateErrorResponse
409	No usable owner identity (`identity_not_ready`): set it up or unlock it first. `identity` carries its status.	AgentCreateErrorResponse
500	Unexpected runtime failure
503	The subsystem is not configured on this daemon

Error bodies use the error format.

Example

Request

curl -X PUT "http://127.0.0.1:7385/templates/standard/files" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"path":"mind.md","content":"# Mind\n"}'

Remove an extra file

DELETE/templates/{id}/files

Operation removeTemplateFileAuthBearer token

Seed files cannot be removed; clear their text instead.

Path parameters

Name	Type	Description
`id`required	string	Template id (the file stem in the templates folder) example: standard

Query parameters

Name	Type	Description
`path`required	string	Extra file path

Responses

Status Description Body

200 Removed TemplateFileResponse

`id`required	string
`path`required	string
`success`required	boolean	Value `true`

Errors 400 · 401 · 403 · 404 · 409 · 500 · 503

400	Invalid body or the template was refused (`bad_request`, `template_invalid`)	AgentCreateErrorResponse
401	Missing or wrong bearer token (`unauthorized`)
403	The request guard refused it: Host header not allowed (`host_not_allowed`, DNS-rebinding protection) or a browser cross-site request (`cross_origin`)`host_not_allowedcross_origin`
404	Unknown template (`template_missing`)	AgentCreateErrorResponse
409	No usable owner identity (`identity_not_ready`): set it up or unlock it first. `identity` carries its status.	AgentCreateErrorResponse
500	Unexpected runtime failure
503	The subsystem is not configured on this daemon

Error bodies use the error format.

Example

Request

curl -X DELETE "http://127.0.0.1:7385/templates/standard/files?path=PATH" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"