--- title: HTTP API description: Use Agent Memory from services that call the Cloudflare API directly. image: https://edgetunnel-b2h.pages.dev/dev-products-preview.png --- > Documentation Index > Fetch the complete documentation index at: https://edgetunnel-b2h.pages.dev/agent-memory/llms.txt > Use this file to discover all available pages before exploring further. [Skip to content](#%5Ftop) # HTTP API Use the HTTP API to call Agent Memory from services that do not run inside [Cloudflare Workers](https://edgetunnel-b2h.pages.dev/workers/). For Workers applications, use the [Workers API](https://edgetunnel-b2h.pages.dev/agent-memory/api/workers-api/) through an `agent_memory` binding. The HTTP API uses namespaces and profiles. A namespace scopes profiles for your application, and each profile is an isolated memory store. Profiles are created automatically when you first write to them. ## Authentication All requests require an [API token](https://edgetunnel-b2h.pages.dev/fundamentals/api/get-started/create-token/) with the appropriate Agent Memory permissions. Include your API token in the `Authorization` header: ```txt Authorization: Bearer ``` For information about calling the Cloudflare API, refer to [Make API calls](https://edgetunnel-b2h.pages.dev/fundamentals/api/how-to/make-api-calls/). ## Namespace management A [namespace](https://edgetunnel-b2h.pages.dev/agent-memory/concepts/namespaces-profiles/) is a top-level container that scopes memory profiles for your application. ### Create a namespace Creates a new namespace for the given account. ```bash curl -X POST "https://api.cloudflare.com/client/v4/accounts//agent-memory/namespaces" \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{"name": "support-agent"}' ``` The response includes the namespace name that you use in Worker bindings and HTTP API calls. ```json { "result": { "id": "01JSGCEXAMPLE000000000000", "name": "support-agent", "created_at": "2026-04-21T00:00:00.000Z", "updated_at": "2026-04-21T00:00:00.000Z" }, "success": true, "errors": [], "messages": [] } ``` ### List namespaces Lists all namespaces for the given account. Results are paginated. ```bash curl "https://api.cloudflare.com/client/v4/accounts//agent-memory/namespaces?per_page=50" \ -H "Authorization: Bearer " ``` ```json { "result": [ { "id": "01JSGCEXAMPLE000000000000", "name": "support-agent", "created_at": "2026-04-21T00:00:00.000Z", "updated_at": "2026-04-21T00:00:00.000Z" } ], "success": true, "errors": [], "messages": [], "result_info": { "cursor": "next-cursor", "per_page": 50, "count": 1 } } ``` ### Get a namespace Retrieves a single namespace by name. ```bash curl "https://api.cloudflare.com/client/v4/accounts//agent-memory/namespaces/" \ -H "Authorization: Bearer " ``` ```json { "result": { "id": "01JSGCEXAMPLE000000000000", "name": "support-agent", "created_at": "2026-04-21T00:00:00.000Z", "updated_at": "2026-04-21T00:00:00.000Z" }, "success": true, "errors": [], "messages": [] } ``` ### Delete a namespace Marks a namespace for deletion. The namespace name becomes available for reuse after deletion. ```bash curl -X DELETE "https://api.cloudflare.com/client/v4/accounts//agent-memory/namespaces/" \ -H "Authorization: Bearer " ``` ```json { "result": null, "success": true, "errors": [], "messages": [] } ``` ## Profiles Use profile endpoints to manage profiles and operate on memory stored in a named profile. Profiles are created automatically when you first write to them. ### Delete a profile Marks a profile and all its memories and messages for deletion. ```bash curl -X DELETE "https://api.cloudflare.com/client/v4/accounts//agent-memory/namespaces//profiles/" \ -H "Authorization: Bearer " ``` ```json { "result": null, "success": true, "errors": [], "messages": [] } ``` ### Delete a session Marks all memories and messages in a profile that are tagged with the given session ID for deletion. Rows from other sessions in the same profile are untouched. Idempotent: deleting a session ID that has no rows is a no-op. ```bash curl -X DELETE "https://api.cloudflare.com/client/v4/accounts//agent-memory/namespaces//profiles//sessions/" \ -H "Authorization: Bearer " ``` ```json { "result": null, "success": true, "errors": [], "messages": [] } ``` ### Ingest messages Processes a conversation and extracts structured memories from it. Agent Memory identifies facts, events, instructions, and tasks automatically, so you do not need to specify what to remember. ```bash curl -X POST "https://api.cloudflare.com/client/v4/accounts//agent-memory/namespaces//profiles//ingest" \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "messages": [ { "role": "user", "content": "I prefer concise answers.", "timestamp": "2026-04-21T00:00:00.000Z" } ], "sessionId": "chat-2026-04-21" }' ``` ```json { "result": null, "success": true, "errors": [], "messages": [] } ``` `ingest` is idempotent. Re-ingesting the same conversation does not create duplicate memories. ### Remember a memory Stores a single memory explicitly. Use `remember` when your application or agent already knows what should be stored. ```bash curl -X POST "https://api.cloudflare.com/client/v4/accounts//agent-memory/namespaces//profiles//remember" \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "content": "The user prefers concise answers.", "sessionId": "chat-2026-04-21" }' ``` ```json { "result": { "id": "01JSGCEXAMPLE000000000000", "type": "instruction", "summary": "The user prefers concise answers.", "content": "The user prefers concise answers.", "sessionId": "chat-2026-04-21", "createdAt": "2026-04-21T00:00:00.000Z", "updatedAt": "2026-04-21T00:00:00.000Z" }, "success": true, "errors": [], "messages": [] } ``` ### Recall memories Searches stored memories in the profile and returns a synthesized answer grounded in the stored content. ```bash curl -X POST "https://api.cloudflare.com/client/v4/accounts//agent-memory/namespaces//profiles//recall" \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "query": "How should I answer this user?", "thinkingLevel": "low", "responseLength": "medium" }' ``` ```json { "result": { "answer": "The user prefers concise answers.", "count": 1, "candidates": [ { "id": "01JSGCEXAMPLE000000000000", "summary": "The user prefers concise answers.", "sessionId": "chat-2026-04-21", "score": 0.87 } ] }, "success": true, "errors": [], "messages": [] } ``` If no memories match the query, `recall` returns an empty answer. ### List memories Lists memories stored in the profile. ```bash curl "https://api.cloudflare.com/client/v4/accounts//agent-memory/namespaces//profiles//memories?per_page=50" \ -H "Authorization: Bearer " ``` ```json { "result": [ { "id": "01JSGCEXAMPLE000000000000", "type": "instruction", "summary": "The user prefers concise answers.", "sessionId": "chat-2026-04-21", "createdAt": "2026-04-21T00:00:00.000Z", "updatedAt": "2026-04-21T00:00:00.000Z" } ], "success": true, "errors": [], "messages": [], "result_info": { "cursor": "next-cursor", "per_page": 50, "count": 1 } } ``` List entries omit `content`. Use the get memory endpoint to retrieve the full memory. To filter memories, use the `session_id` and `type` query parameters. ### Get a memory Retrieves a memory by ID. ```bash curl "https://api.cloudflare.com/client/v4/accounts//agent-memory/namespaces//profiles//memories/" \ -H "Authorization: Bearer " ``` ```json { "result": { "id": "01JSGCEXAMPLE000000000000", "type": "instruction", "summary": "The user prefers concise answers.", "content": "The user prefers concise answers.", "sessionId": "chat-2026-04-21", "createdAt": "2026-04-21T00:00:00.000Z", "updatedAt": "2026-04-21T00:00:00.000Z" }, "success": true, "errors": [], "messages": [] } ``` ### Delete a memory Deletes a memory by ID. Removes the memory and any source messages linked to it. Returns the deleted memory. ```bash curl -X DELETE "https://api.cloudflare.com/client/v4/accounts//agent-memory/namespaces//profiles//memories/" \ -H "Authorization: Bearer " ``` ```json { "result": { "id": "01JSGCEXAMPLE000000000000", "type": "instruction", "summary": "The user prefers concise answers.", "content": "The user prefers concise answers.", "sessionId": "chat-2026-04-21", "createdAt": "2026-04-21T00:00:00.000Z", "updatedAt": "2026-04-21T00:00:00.000Z" }, "success": true, "errors": [], "messages": [] } ``` ### Get a summary Generates a structured Markdown summary of everything stored in a memory profile. Use it to inspect what Agent Memory remembers about a profile. ```bash curl -X POST "https://api.cloudflare.com/client/v4/accounts//agent-memory/namespaces//profiles//summary" \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{}' ``` ```json { "result": { "summary": "## Summary\n\nThe user prefers concise answers." }, "success": true, "errors": [], "messages": [] } ``` To scope the "Last Session" section of the summary, include the `sessionId` field in the request body. ## Error responses All endpoints return standard Cloudflare V4 error responses on failure: ```json { "result": null, "success": false, "errors": [ { "code": 10008, "message": "Namespace name already exists" } ], "messages": [] } ``` Common error scenarios include: | Scenario | HTTP status | | ----------------------------- | ----------- | | Invalid namespace name format | 400 | | Authentication failure | 401 | | Namespace name already exists | 409 | | Namespace not found | 404 | | Profile not found | 404 | ```json {"@context":"https://schema.org","@type":"TechArticle","@id":"https://edgetunnel-b2h.pages.dev/agent-memory/api/http-api/#page","headline":"HTTP API ยท Cloudflare Agent Memory docs","description":"Use Agent Memory from services that call the Cloudflare API directly.","url":"https://edgetunnel-b2h.pages.dev/agent-memory/api/http-api/","inLanguage":"en","image":"https://edgetunnel-b2h.pages.dev/dev-products-preview.png","dateModified":"2026-06-02","publisher":{"@type":"Organization","name":"Cloudflare","url":"https://www.cloudflare.com/"},"isPartOf":{"@type":"WebSite","@id":"https://edgetunnel-b2h.pages.dev/#website","name":"Cloudflare Docs","url":"https://edgetunnel-b2h.pages.dev/"}} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"item":{"@id":"/directory/","name":"Directory"}},{"@type":"ListItem","position":2,"item":{"@id":"/agent-memory/","name":"Agent Memory"}},{"@type":"ListItem","position":3,"item":{"@id":"/agent-memory/api/","name":"API"}},{"@type":"ListItem","position":4,"item":{"@id":"/agent-memory/api/http-api/","name":"HTTP API"}}]} ```