Files · Daemon API

On this page

List the agent's files

GET/agents/{id}/files

Operation listAgentFilesAuthBearer token

Path parameters

Name	Type	Description
`id`required	string	Loaded agent: its id, handle or name. example: agent-1

Responses

Status Description Body

200 Files (metadata) AgentFilesResponse

agentIdrequired

string

Agent id

filesrequired array<FileListEntry>

7 fields of files

`path`required	string
`size`required	integer
`mime_type`	string
`protection`required	string	One of `none`, `read_only`, `no_delete`
`authorized`required	boolean
`created_at`required	string
`updated_at`required	string

Errors 401 · 403 · 404

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 agent (or the named resource: loop, task, file, …)

Error bodies use the error format.

Example

Request

curl "http://127.0.0.1:7385/agents/agent-1/files" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Read one file

GET/agents/{id}/files/content

Operation getAgentFileContentAuthBearer token

Text-like files come back as encoding: "utf-8" with content; binary files as encoding: "base64" with content_base64.

Path parameters

Name	Type	Description
`id`required	string	Loaded agent: its id, handle or name. example: agent-1

Query parameters

Name	Type	Description
`path`required	string	File path inside the agent example: notes/today.md

Responses

Status Description Body

200 File with content (utf-8) or content_base64 FileContentResponse

`agentId`required	string	Agent id
`path`required	string
`mime_type`required	string \| null
`size`required	integer
`protection`required	string	One of `none`, `read_only`, `no_delete`
`authorized`required	boolean
`created_at`required	string
`updated_at`required	string
`encoding`required	string	One of `utf-8`, `base64`
`content`	string	utf-8 files
`content_base64`	string	Binary files

Errors 400 · 401 · 403 · 404

400	Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (`statusCode`, `code`, `error`, `message`).`bad_requestFST_ERR_CTP_EMPTY_JSON_BODY`
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 agent (or the named resource: loop, task, file, …)

Error bodies use the error format.

Example

Request

curl "http://127.0.0.1:7385/agents/agent-1/files/content?path=notes/today.md" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Response 200

{
  "agentId": "Xk3v9QpLm2",
  "path": "mind.md",
  "mime_type": "text/markdown",
  "size": 12,
  "protection": "none",
  "authorized": false,
  "created_at": "2026-09-01T10:00:00.000Z",
  "updated_at": "2026-09-01T10:00:00.000Z",
  "encoding": "utf-8",
  "content": "# Mind\n"
}

Write one file

PUT/agents/{id}/files/content

Operation writeAgentFileContentAuthBearer token

Text with content, binary with content_base64 (plus mime_type). Fires the agent's file-change triggers.

Path parameters

Name	Type	Description
`id`required	string	Loaded agent: its id, handle or name. example: agent-1

Query parameters

Name	Type	Description
`path`required	string	File path inside the agent example: notes/today.md

Request bodyapplication/json · FileWriteBody · required

One of content / content_base64 is required.

Field	Type	Description
`content`	string	Text content
`content_base64`	string	Binary content (alias: contentBase64)
`contentBase64`	string
`mime_type`	string	Alias: mimeType
`mimeType`	string
`protection`	string	One of `none`, `read_only`, `no_delete`

Responses

Status Description Body

200 Written AgentSuccess

`agentId`required	string	Agent id
`success`required	boolean

Errors 400 · 401 · 403 · 404 · 500

400	Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (`statusCode`, `code`, `error`, `message`).`bad_requestFST_ERR_CTP_EMPTY_JSON_BODY`
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 agent (or the named resource: loop, task, file, …)
500	Unexpected runtime failure

Error bodies use the error format.

Example

Request

curl -X PUT "http://127.0.0.1:7385/agents/agent-1/files/content?path=notes/today.md" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"hello\n","mime_type":"text/plain"}'

Response 200

{
  "agentId": "Xk3v9QpLm2",
  "success": true
}

Delete one file

DELETE/agents/{id}/files/content

Operation deleteAgentFileContentAuthBearer token

Path parameters

Name	Type	Description
`id`required	string	Loaded agent: its id, handle or name. example: agent-1

Query parameters

Name	Type	Description
`path`required	string	File path inside the agent example: notes/today.md

Responses

Status Description Body

200 success is false when nothing was deleted AgentSuccess

`agentId`required	string	Agent id
`success`required	boolean

Errors 400 · 401 · 403 · 404 · 500

400	Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (`statusCode`, `code`, `error`, `message`).`bad_requestFST_ERR_CTP_EMPTY_JSON_BODY`
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 agent (or the named resource: loop, task, file, …)
500	Unexpected runtime failure

Error bodies use the error format.

Example

Request

curl -X DELETE "http://127.0.0.1:7385/agents/agent-1/files/content?path=notes/today.md" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Response 200

{
  "agentId": "Xk3v9QpLm2",
  "success": true
}

Rename a file

POST/agents/{id}/files/rename

Operation renameAgentFileAuthBearer token

Path parameters

Name	Type	Description
`id`required	string	Loaded agent: its id, handle or name. example: agent-1

Request bodyapplication/json · FileRenameBody · required

Field	Type	Description
`oldPath`required	string
`newPath`required	string

Responses

Status Description Body

200 Renamed AgentSuccess

`agentId`required	string	Agent id
`success`required	boolean

Errors 400 · 401 · 403 · 404 · 500

400	Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (`statusCode`, `code`, `error`, `message`).`bad_requestFST_ERR_CTP_EMPTY_JSON_BODY`
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 agent (or the named resource: loop, task, file, …)
500	Unexpected runtime failure

Error bodies use the error format.

Example

Request

curl -X POST "http://127.0.0.1:7385/agents/agent-1/files/rename" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"oldPath":"string","newPath":"string"}'

Response 200

{
  "agentId": "Xk3v9QpLm2",
  "success": true
}

Rename a folder (path prefix)

POST/agents/{id}/files/rename-folder

Operation renameAgentFolderAuthBearer token

Path parameters

Name	Type	Description
`id`required	string	Loaded agent: its id, handle or name. example: agent-1

Request bodyapplication/json · FolderRenameBody · required

Field	Type	Description
`oldPrefix`required	string
`newPrefix`required	string

Responses

Status Description Body

200 Renamed FolderRenameResponse

`agentId`required	string	Agent id
`success`required	boolean	Value `true`
`count`required	integer	Files moved

Errors 400 · 401 · 403 · 404 · 500

400	Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (`statusCode`, `code`, `error`, `message`).`bad_requestFST_ERR_CTP_EMPTY_JSON_BODY`
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 agent (or the named resource: loop, task, file, …)
500	Unexpected runtime failure

Error bodies use the error format.

Example

Request

curl -X POST "http://127.0.0.1:7385/agents/agent-1/files/rename-folder" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"oldPrefix":"string","newPrefix":"string"}'

Set a file's protection

PATCH/agents/{id}/files/protection

Operation setAgentFileProtectionAuthBearer token

Path parameters

Name	Type	Description
`id`required	string	Loaded agent: its id, handle or name. example: agent-1

Request bodyapplication/json · FileProtectionBody · required

Field	Type	Description
`path`required	string
`protection`required	string	One of `none`, `read_only`, `no_delete`

Responses

Status Description Body

200 Saved AgentSuccess

`agentId`required	string	Agent id
`success`required	boolean

Errors 400 · 401 · 403 · 404 · 500

400	Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (`statusCode`, `code`, `error`, `message`).`bad_requestFST_ERR_CTP_EMPTY_JSON_BODY`
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 agent (or the named resource: loop, task, file, …)
500	Unexpected runtime failure

Error bodies use the error format.

Example

Request

curl -X PATCH "http://127.0.0.1:7385/agents/agent-1/files/protection" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"path":"string","protection":"none"}'

Response 200

{
  "agentId": "Xk3v9QpLm2",
  "success": true
}

Mark a file as authorized code (or not)

PATCH/agents/{id}/files/authorized

Operation setAgentFileAuthorizedAuthBearer token

Path parameters

Name	Type	Description
`id`required	string	Loaded agent: its id, handle or name. example: agent-1

Request bodyapplication/json · FileAuthorizedBody · required

Field	Type	Description
`path`required	string
`authorized`required	boolean

Responses

Status Description Body

200 Saved AgentSuccess

`agentId`required	string	Agent id
`success`required	boolean

Errors 400 · 401 · 403 · 404 · 500

400	Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (`statusCode`, `code`, `error`, `message`).`bad_requestFST_ERR_CTP_EMPTY_JSON_BODY`
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 agent (or the named resource: loop, task, file, …)
500	Unexpected runtime failure

Error bodies use the error format.

Example

Request

curl -X PATCH "http://127.0.0.1:7385/agents/agent-1/files/authorized" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"path":"string","authorized":true}'

Response 200

{
  "agentId": "Xk3v9QpLm2",
  "success": true
}

Read the primary document

GET/agents/{id}/document

Operation getAgentDocumentAuthBearer token

Path parameters

Name	Type	Description
`id`required	string	Loaded agent: its id, handle or name. example: agent-1

Responses

Status Description Body

200 Content TextContentResponse

`agentId`required	string	Agent id
`content`required	string

Errors 401 · 403 · 404

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 agent (or the named resource: loop, task, file, …)

Error bodies use the error format.

Example

Request

curl "http://127.0.0.1:7385/agents/agent-1/document" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Write the primary document

PUT/agents/{id}/document

Operation setAgentDocumentAuthBearer token

Fires the agent's file/document-change triggers.

Path parameters

Name	Type	Description
`id`required	string	Loaded agent: its id, handle or name. example: agent-1

Request bodyapplication/json · TextContentBody · required

Field	Type	Description
`content`required	string

Responses

Status Description Body

200 Saved AgentSuccess

`agentId`required	string	Agent id
`success`required	boolean

Errors 400 · 401 · 403 · 404 · 500

400	Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (`statusCode`, `code`, `error`, `message`).`bad_requestFST_ERR_CTP_EMPTY_JSON_BODY`
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 agent (or the named resource: loop, task, file, …)
500	Unexpected runtime failure

Error bodies use the error format.

Example

Request

curl -X PUT "http://127.0.0.1:7385/agents/agent-1/document" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"# Notes\n"}'

Response 200

{
  "agentId": "Xk3v9QpLm2",
  "success": true
}

Read mind.md

GET/agents/{id}/mind

Operation getAgentMindAuthBearer token

Path parameters

Name	Type	Description
`id`required	string	Loaded agent: its id, handle or name. example: agent-1

Responses

Status Description Body

200 Content TextContentResponse

`agentId`required	string	Agent id
`content`required	string

Errors 401 · 403 · 404

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 agent (or the named resource: loop, task, file, …)

Error bodies use the error format.

Example

Request

curl "http://127.0.0.1:7385/agents/agent-1/mind" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Write mind.md

PUT/agents/{id}/mind

Operation setAgentMindAuthBearer token

Path parameters

Name	Type	Description
`id`required	string	Loaded agent: its id, handle or name. example: agent-1

Request bodyapplication/json · TextContentBody · required

Field	Type	Description
`content`required	string

Responses

Status Description Body

200 Saved AgentSuccess

`agentId`required	string	Agent id
`success`required	boolean

Errors 400 · 401 · 403 · 404 · 500

400	Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (`statusCode`, `code`, `error`, `message`).`bad_requestFST_ERR_CTP_EMPTY_JSON_BODY`
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 agent (or the named resource: loop, task, file, …)
500	Unexpected runtime failure

Error bodies use the error format.

Example

Request

curl -X PUT "http://127.0.0.1:7385/agents/agent-1/mind" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"# Notes\n"}'

Response 200

{
  "agentId": "Xk3v9QpLm2",
  "success": true
}