AgentConnect
Agents

Read a memory file

Read one byte slice of a memory file (?path defaults to MEMORY.md); a missing file is data (exists:false). A memory home in the Control Plane is read here with no daemon involved; a home on the daemon is proxied live from the owning daemon, and is 503 when the agent is unplaced or the daemon is offline. 503 also when the memory home of the agent is not reachable right now; code says why.

GET
/v1/orgs/{orgId}/agents/{id}/memory/file

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

orgId*string
id*string

Query Parameters

channelKey?string

A place layer's key, from GET /agents/:id/memory/channels; absent means the shared layer. A layer whose conversation shows the caller no session in the console answers 404, as an absent one does.

Match^[A-Za-z0-9._-]+$
Length1 <= length <= 120
path?string
Length1 <= length
offset?integer
Range0 <= value <= 9007199254740991
limit?integer
Range0 < value <= 65536

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/orgs/string/agents/string/memory/file"
{  "path": "string",  "exists": true,  "size": 0,  "mtime": "string",  "content": "string",  "offset": 0,  "nextOffset": 0,  "truncated": true}