events

Creates, updates, deletes, gets or lists an events resource.

Overview

Name	events
Type	Resource
Id	aws.bedrock_agentcore.events

Fields

The following fields are returned by SELECT queries:

get_event

Name	Datatype	Description
actor_id	string	The identifier of the actor associated with the event. (pattern: <code>[a-zA-Z0-9][a-zA-Z0-9-/]*(?::[a-zA-Z0-9-/]+)[a-zA-Z0-9-_/]</code>)
branch	object	Contains information about a branch in an AgentCore Memory resource. Branches allow for organizing events into different conversation threads or paths.
event_id	string	The unique identifier of the event. (pattern: <code>[0-9]+#[a-fA-F0-9]+</code>)
event_timestamp	string (date-time)	The timestamp when the event occurred.
memory_id	string	The identifier of the AgentCore Memory resource containing the event. (pattern: <code>(arn:(aws|aws-cn|aws-us-gov):bedrock-agentcore:[a-z0-9-]+:[0-9]{12}:memory/)?[a-zA-Z][a-zA-Z0-9-_]{0,99}-[a-zA-Z0-9]{10}</code>)
metadata	object	Metadata associated with an event.
payload	array	The content payload of the event.
session_id	string	The identifier of the session containing the event. (pattern: <code>[a-zA-Z0-9][a-zA-Z0-9-_]*</code>)

list_events

Name	Datatype	Description
actor_id	string	The identifier of the actor associated with the event. (pattern: <code>[a-zA-Z0-9][a-zA-Z0-9-/]*(?::[a-zA-Z0-9-/]+)[a-zA-Z0-9-_/]</code>)
branch	object	Contains information about a branch in an AgentCore Memory resource. Branches allow for organizing events into different conversation threads or paths.
event_id	string	The unique identifier of the event. (pattern: <code>[0-9]+#[a-fA-F0-9]+</code>)
event_timestamp	string (date-time)	The timestamp when the event occurred.
memory_id	string	The identifier of the AgentCore Memory resource containing the event. (pattern: <code>(arn:(aws|aws-cn|aws-us-gov):bedrock-agentcore:[a-z0-9-]+:[0-9]{12}:memory/)?[a-zA-Z][a-zA-Z0-9-_]{0,99}-[a-zA-Z0-9]{10}</code>)
metadata	object	Metadata associated with an event.
payload	array	The content payload of the event.
session_id	string	The identifier of the session containing the event. (pattern: <code>[a-zA-Z0-9][a-zA-Z0-9-_]*</code>)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_event	select	memory_id, session_id, actor_id, event_id, region		Retrieves information about a specific event in an AgentCore Memory resource. To use this operation, you must have the bedrock-agentcore:GetEvent permission.
list_events	select	memory_id, session_id, actor_id, region		Lists events in an AgentCore Memory resource based on specified criteria. We recommend using pagination to ensure that the operation returns quickly and successfully. To use this operation, you must have the bedrock-agentcore:ListEvents permission.
create_event	insert	memory_id, region, actorId, eventTimestamp, payload		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.
delete_event	delete	memory_id, session_id, event_id, actor_id, region		Deletes an event from an AgentCore Memory resource. When you delete an event, it is permanently removed. To use this operation, you must have the bedrock-agentcore:DeleteEvent permission.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
actor_id	string	The identifier of the actor associated with the event to delete.
event_id	string	The identifier of the event to delete.
memory_id	string	The identifier of the AgentCore Memory resource from which to delete the event.
region	string	AWS region (default: us-east-1)
session_id	string	The identifier of the session containing the event to delete.

SELECT examples

get_event

Retrieves information about a specific event in an AgentCore Memory resource. To use this operation, you must have the bedrock-agentcore:GetEvent permission.

SELECT
actor_id,
branch,
event_id,
event_timestamp,
memory_id,
metadata,
payload,
session_id
FROM aws.bedrock_agentcore.events
WHERE memory_id = '{{ memory_id }}' -- required
AND session_id = '{{ session_id }}' -- required
AND actor_id = '{{ actor_id }}' -- required
AND event_id = '{{ event_id }}' -- required
AND region = '{{ region }}' -- required
;

list_events

Lists events in an AgentCore Memory resource based on specified criteria. We recommend using pagination to ensure that the operation returns quickly and successfully. To use this operation, you must have the bedrock-agentcore:ListEvents permission.

SELECT
actor_id,
branch,
event_id,
event_timestamp,
memory_id,
metadata,
payload,
session_id
FROM aws.bedrock_agentcore.events
WHERE memory_id = '{{ memory_id }}' -- required
AND session_id = '{{ session_id }}' -- required
AND actor_id = '{{ actor_id }}' -- required
AND region = '{{ region }}' -- required
;

INSERT examples

create_event

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.

INSERT INTO aws.bedrock_agentcore.events (
actorId,
sessionId,
eventTimestamp,
payload,
branch,
clientToken,
metadata,
extractionMode,
extractionConfig,
memory_id,
region
)
SELECT 
'{{ actorId }}' /* required */,
'{{ sessionId }}',
'{{ eventTimestamp }}' /* required */,
'{{ payload }}' /* required */,
'{{ branch }}',
'{{ clientToken }}',
'{{ metadata }}',
'{{ extractionMode }}',
'{{ extractionConfig }}',
'{{ memory_id }}',
'{{ region }}'
RETURNING
event
;

Manifest

# Description fields are for documentation purposes
- name: events
props:
  - name: memory_id
    value: "{{ memory_id }}"
    description: Required parameter for the events resource.
  - name: region
    value: "{{ region }}"
    description: Required parameter for the events resource.
  - name: actorId
    value: "{{ actorId }}"
  - name: sessionId
    value: "{{ sessionId }}"
  - name: eventTimestamp
    value: "{{ eventTimestamp }}"
  - name: payload
    value:
      - conversational:
          content:
            text: "{{ text }}"
          role: "{{ role }}"
        blob: "{{ blob }}"
        json:
          content: "{{ content }}"
  - name: branch
    description: |
      Contains information about a branch in an AgentCore Memory resource. Branches allow for organizing events into different conversation threads or paths.
    value:
      rootEventId: "{{ rootEventId }}"
      name: "{{ name }}"
  - name: clientToken
    value: "{{ clientToken }}"
  - name: metadata
    value: "{{ metadata }}"
  - name: extractionMode
    value: "{{ extractionMode }}"
    valid_values: ['SKIP']
  - name: extractionConfig
    description: |
      The configuration for extraction behavior. Use this structure to specify namespace variable keys and their values for namespace substitution during long-term memory extraction.
    value:
      namespaceVariables: "{{ namespaceVariables }}"

DELETE examples

delete_event

Deletes an event from an AgentCore Memory resource. When you delete an event, it is permanently removed. To use this operation, you must have the bedrock-agentcore:DeleteEvent permission.

DELETE FROM aws.bedrock_agentcore.events
WHERE memory_id = '{{ memory_id }}' --required
AND session_id = '{{ session_id }}' --required
AND event_id = '{{ event_id }}' --required
AND actor_id = '{{ actor_id }}' --required
AND region = '{{ region }}' --required
;