POST /accounts/{account_id}/agent-memory/namespaces/{namespace_name}/profiles/{profile_name}/ingest
Processes a conversation and extracts structured memories from it. Agent Memory identifies facts, events, instructions, and tasks automatically.
Servers
- https://api.cloudflare.com/client/v4
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
namespace_name |
String | Yes | |
profile_name |
String | Yes | |
account_id |
String | Yes |
Cloudflare Account ID. |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
messages[] |
Array | Yes |
Conversation messages to extract memories from. |
messages[].timestamp |
String | No |
Message timestamp. |
messages[].content |
String | Yes |
Text content of the message. |
messages[].role |
String | Yes |
Author role of the message. Valid values:
|
sessionId |
String | No |
Session identifier. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.