Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1465766489.0 KB

Creates an event in an AgentCore Memory resource. Events represent interactions or activities that occur within a session and are associated with specific actors.

To use this operation, you must have the bedrock-agentcore:CreateEvent permission.

This operation is subject to request rate limiting.

post/memories/{memoryId}/events

Path parameters

memoryIdstring required

The identifier of the AgentCore Memory resource in which to create the event.

Request body

actorIdstring required

The identifier of the actor associated with this event. An actor represents an entity that participates in sessions and generates events.

sessionIdstring

The identifier of the session in which this event occurs. A session represents a sequence of related events.

eventTimestampstring date-time required

The timestamp when the event occurred. If not specified, the current time is used.

clientTokenstring

A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, AgentCore ignores the request, but does not return an error.

metadataobject

The key-value metadata to attach to the event.

extractionMode'SKIP'

Controls long-term memory extraction for this event. When set to <code>SKIP</code>, the event is stored in short-term memory but is excluded from long-term memory extraction. If not specified, the event is processed for extraction as usual.

Response

Success