Creates multiple memory records in a single batch operation for the specified memory with custom content.
", "idempotent":true }, "BatchDeleteMemoryRecords":{ "name":"BatchDeleteMemoryRecords", "http":{ "method":"POST", "requestUri":"/memories/{memoryId}/memoryRecords/batchDelete", "responseCode":200 }, "input":{"shape":"BatchDeleteMemoryRecordsInput"}, "output":{"shape":"BatchDeleteMemoryRecordsOutput"}, "errors":[ {"shape":"ServiceQuotaExceededException"}, {"shape":"ThrottledException"}, {"shape":"ServiceException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"} ], "documentation":"Deletes multiple memory records in a single batch operation from the specified memory.
" }, "BatchUpdateMemoryRecords":{ "name":"BatchUpdateMemoryRecords", "http":{ "method":"POST", "requestUri":"/memories/{memoryId}/memoryRecords/batchUpdate", "responseCode":200 }, "input":{"shape":"BatchUpdateMemoryRecordsInput"}, "output":{"shape":"BatchUpdateMemoryRecordsOutput"}, "errors":[ {"shape":"ServiceQuotaExceededException"}, {"shape":"ThrottledException"}, {"shape":"ServiceException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"} ], "documentation":"Updates multiple memory records with custom content in a single batch operation within the specified memory.
" }, "CompleteResourceTokenAuth":{ "name":"CompleteResourceTokenAuth", "http":{ "method":"POST", "requestUri":"/identities/CompleteResourceTokenAuth", "responseCode":200 }, "input":{"shape":"CompleteResourceTokenAuthRequest"}, "output":{"shape":"CompleteResourceTokenAuthResponse"}, "errors":[ {"shape":"UnauthorizedException"}, {"shape":"ValidationException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InternalServerException"} ], "documentation":"Confirms the user authentication session for obtaining OAuth2.0 tokens for a resource.
" }, "CreateEvent":{ "name":"CreateEvent", "http":{ "method":"POST", "requestUri":"/memories/{memoryId}/events", "responseCode":201 }, "input":{"shape":"CreateEventInput"}, "output":{"shape":"CreateEventOutput"}, "errors":[ {"shape":"ServiceQuotaExceededException"}, {"shape":"ThrottledException"}, {"shape":"ServiceException"}, {"shape":"RetryableConflictException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"InvalidInputException"}, {"shape":"ResourceNotFoundException"} ], "documentation":"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.
", "idempotent":true }, "DeleteEvent":{ "name":"DeleteEvent", "http":{ "method":"DELETE", "requestUri":"/memories/{memoryId}/actor/{actorId}/sessions/{sessionId}/events/{eventId}", "responseCode":200 }, "input":{"shape":"DeleteEventInput"}, "output":{"shape":"DeleteEventOutput"}, "errors":[ {"shape":"ServiceQuotaExceededException"}, {"shape":"ThrottledException"}, {"shape":"ServiceException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"InvalidInputException"}, {"shape":"ResourceNotFoundException"} ], "documentation":"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.
Deletes a memory record from an AgentCore Memory resource. When you delete a memory record, it is permanently removed.
To use this operation, you must have the bedrock-agentcore:DeleteMemoryRecord permission.
Performs on-demand evaluation of agent traces using a specified evaluator. This synchronous API accepts traces in OpenTelemetry format and returns immediate scoring results with detailed explanations.
" }, "GetAgentCard":{ "name":"GetAgentCard", "http":{ "method":"GET", "requestUri":"/runtimes/{agentRuntimeArn}/invocations/.well-known/agent-card.json", "responseCode":200 }, "input":{"shape":"GetAgentCardRequest"}, "output":{"shape":"GetAgentCardResponse"}, "errors":[ {"shape":"ServiceQuotaExceededException"}, {"shape":"ValidationException"}, {"shape":"AccessDeniedException"}, {"shape":"RuntimeClientError"}, {"shape":"ThrottlingException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerException"} ], "documentation":"Retrieves the A2A agent card associated with an AgentCore Runtime agent.
" }, "GetBrowserSession":{ "name":"GetBrowserSession", "http":{ "method":"GET", "requestUri":"/browsers/{browserIdentifier}/sessions/get", "responseCode":200 }, "input":{"shape":"GetBrowserSessionRequest"}, "output":{"shape":"GetBrowserSessionResponse"}, "errors":[ {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InternalServerException"} ], "documentation":"Retrieves detailed information about a specific browser session in Amazon Bedrock. This operation returns the session's configuration, current status, associated streams, and metadata.
To get a browser session, you must specify both the browser identifier and the session ID. The response includes information about the session's viewport configuration, timeout settings, and stream endpoints.
The following operations are related to GetBrowserSession:
Retrieves detailed information about a specific code interpreter session in Amazon Bedrock. This operation returns the session's configuration, current status, and metadata.
To get a code interpreter session, you must specify both the code interpreter identifier and the session ID. The response includes information about the session's timeout settings and current status.
The following operations are related to GetCodeInterpreterSession:
Retrieves information about a specific event in an AgentCore Memory resource.
To use this operation, you must have the bedrock-agentcore:GetEvent permission.
Retrieves a specific memory record from an AgentCore Memory resource.
To use this operation, you must have the bedrock-agentcore:GetMemoryRecord permission.
Retrieves the API key associated with an API key credential provider.
", "readonly":true }, "GetResourceOauth2Token":{ "name":"GetResourceOauth2Token", "http":{ "method":"POST", "requestUri":"/identities/oauth2/token", "responseCode":200 }, "input":{"shape":"GetResourceOauth2TokenRequest"}, "output":{"shape":"GetResourceOauth2TokenResponse"}, "errors":[ {"shape":"UnauthorizedException"}, {"shape":"ValidationException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InternalServerException"} ], "documentation":"Returns the OAuth 2.0 token of the provided resource.
", "readonly":true }, "GetWorkloadAccessToken":{ "name":"GetWorkloadAccessToken", "http":{ "method":"POST", "requestUri":"/identities/GetWorkloadAccessToken", "responseCode":200 }, "input":{"shape":"GetWorkloadAccessTokenRequest"}, "output":{"shape":"GetWorkloadAccessTokenResponse"}, "errors":[ {"shape":"UnauthorizedException"}, {"shape":"ValidationException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InternalServerException"} ], "documentation":"Obtains a workload access token for agentic workloads not acting on behalf of a user.
" }, "GetWorkloadAccessTokenForJWT":{ "name":"GetWorkloadAccessTokenForJWT", "http":{ "method":"POST", "requestUri":"/identities/GetWorkloadAccessTokenForJWT", "responseCode":200 }, "input":{"shape":"GetWorkloadAccessTokenForJWTRequest"}, "output":{"shape":"GetWorkloadAccessTokenForJWTResponse"}, "errors":[ {"shape":"UnauthorizedException"}, {"shape":"ValidationException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InternalServerException"} ], "documentation":"Obtains a workload access token for agentic workloads acting on behalf of a user, using a JWT token.
" }, "GetWorkloadAccessTokenForUserId":{ "name":"GetWorkloadAccessTokenForUserId", "http":{ "method":"POST", "requestUri":"/identities/GetWorkloadAccessTokenForUserId", "responseCode":200 }, "input":{"shape":"GetWorkloadAccessTokenForUserIdRequest"}, "output":{"shape":"GetWorkloadAccessTokenForUserIdResponse"}, "errors":[ {"shape":"UnauthorizedException"}, {"shape":"ValidationException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InternalServerException"} ], "documentation":"Obtains a workload access token for agentic workloads acting on behalf of a user, using the user's ID.
" }, "InvokeAgentRuntime":{ "name":"InvokeAgentRuntime", "http":{ "method":"POST", "requestUri":"/runtimes/{agentRuntimeArn}/invocations", "responseCode":200 }, "input":{"shape":"InvokeAgentRuntimeRequest"}, "output":{"shape":"InvokeAgentRuntimeResponse"}, "errors":[ {"shape":"ServiceQuotaExceededException"}, {"shape":"ValidationException"}, {"shape":"AccessDeniedException"}, {"shape":"RuntimeClientError"}, {"shape":"ThrottlingException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerException"} ], "documentation":"Sends a request to an agent or tool hosted in an Amazon Bedrock AgentCore Runtime and receives responses in real-time.
To invoke an agent you must specify the AgentCore Runtime ARN and provide a payload containing your request. You can optionally specify a qualifier to target a specific version or endpoint of the agent.
This operation supports streaming responses, allowing you to receive partial responses as they become available. We recommend using pagination to ensure that the operation returns quickly and successfully when processing large responses.
For example code, see Invoke an AgentCore Runtime agent.
If you're integrating your agent with OAuth, you can't use the Amazon Web Services SDK to call InvokeAgentRuntime. Instead, make a HTTPS request to InvokeAgentRuntime. For an example, see Authenticate and authorize with Inbound Auth and Outbound Auth.
To use this operation, you must have the bedrock-agentcore:InvokeAgentRuntime permission. If you are making a call to InvokeAgentRuntime on behalf of a user ID with the X-Amzn-Bedrock-AgentCore-Runtime-User-Id header, You require permissions to both actions (bedrock-agentcore:InvokeAgentRuntime and bedrock-agentcore:InvokeAgentRuntimeForUser).
Executes code within an active code interpreter session in Amazon Bedrock. This operation processes the provided code, runs it in a secure environment, and returns the execution results including output, errors, and generated visualizations.
To execute code, you must specify the code interpreter identifier, session ID, and the code to run in the arguments parameter. The operation returns a stream containing the execution results, which can include text output, error messages, and data visualizations.
This operation is subject to request rate limiting based on your account's service quotas.
The following operations are related to InvokeCodeInterpreter:
Lists all actors in an AgentCore Memory resource. We recommend using pagination to ensure that the operation returns quickly and successfully.
To use this operation, you must have the bedrock-agentcore:ListActors permission.
Retrieves a list of browser sessions in Amazon Bedrock that match the specified criteria. This operation returns summary information about each session, including identifiers, status, and timestamps.
You can filter the results by browser identifier and session status. The operation supports pagination to handle large result sets efficiently.
We recommend using pagination to ensure that the operation returns quickly and successfully when retrieving large numbers of sessions.
The following operations are related to ListBrowserSessions:
Retrieves a list of code interpreter sessions in Amazon Bedrock that match the specified criteria. This operation returns summary information about each session, including identifiers, status, and timestamps.
You can filter the results by code interpreter identifier and session status. The operation supports pagination to handle large result sets efficiently.
We recommend using pagination to ensure that the operation returns quickly and successfully when retrieving large numbers of sessions.
The following operations are related to ListCodeInterpreterSessions:
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.
Lists all long-term memory extraction jobs that are eligible to be started with optional filtering.
To use this operation, you must have the bedrock-agentcore:ListMemoryExtractionJobs permission.
Lists memory records 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:ListMemoryRecords permission.
Lists sessions 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:ListSessions permission.
Searches for and retrieves memory records from an AgentCore Memory resource based on specified search criteria. We recommend using pagination to ensure that the operation returns quickly and successfully.
To use this operation, you must have the bedrock-agentcore:RetrieveMemoryRecords permission.
Creates and initializes a browser session in Amazon Bedrock. The session enables agents to navigate and interact with web content, extract information from websites, and perform web-based tasks as part of their response generation.
To create a session, you must specify a browser identifier and a name. You can also configure the viewport dimensions to control the visible area of web content. The session remains active until it times out or you explicitly stop it using the StopBrowserSession operation.
The following operations are related to StartBrowserSession:
Creates and initializes a code interpreter session in Amazon Bedrock. The session enables agents to execute code as part of their response generation, supporting programming languages such as Python for data analysis, visualization, and computation tasks.
To create a session, you must specify a code interpreter identifier and a name. The session remains active until it times out or you explicitly stop it using the StopCodeInterpreterSession operation.
The following operations are related to StartCodeInterpreterSession:
Starts a memory extraction job that processes events that failed extraction previously in an AgentCore Memory resource and produces structured memory records. When earlier extraction attempts have left events unprocessed, this job will pick up and extract those as well.
To use this operation, you must have the bedrock-agentcore:StartMemoryExtractionJob permission.
Terminates an active browser session in Amazon Bedrock. This operation stops the session, releases associated resources, and makes the session unavailable for further use.
To stop a browser session, you must specify both the browser identifier and the session ID. Once stopped, a session cannot be restarted; you must create a new session using StartBrowserSession.
The following operations are related to StopBrowserSession:
Terminates an active code interpreter session in Amazon Bedrock. This operation stops the session, releases associated resources, and makes the session unavailable for further use.
To stop a code interpreter session, you must specify both the code interpreter identifier and the session ID. Once stopped, a session cannot be restarted; you must create a new session using StartCodeInterpreterSession.
The following operations are related to StopCodeInterpreterSession:
Stops a session that is running in an running AgentCore Runtime agent.
", "idempotent":true }, "UpdateBrowserStream":{ "name":"UpdateBrowserStream", "http":{ "method":"PUT", "requestUri":"/browsers/{browserIdentifier}/sessions/streams/update", "responseCode":200 }, "input":{"shape":"UpdateBrowserStreamRequest"}, "output":{"shape":"UpdateBrowserStreamResponse"}, "errors":[ {"shape":"ServiceQuotaExceededException"}, {"shape":"AccessDeniedException"}, {"shape":"ConflictException"}, {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InternalServerException"} ], "documentation":"Updates a browser stream. To use this operation, you must have permissions to perform the bedrock:UpdateBrowserStream action.
", "idempotent":true } }, "shapes":{ "AccessDeniedException":{ "type":"structure", "members":{ "message":{"shape":"NonBlankString"} }, "documentation":"The exception that occurs when you do not have sufficient permissions to perform an action. Verify that your IAM policy includes the necessary permissions for the operation you are trying to perform.
", "error":{ "httpStatusCode":403, "senderFault":true }, "exception":true }, "AccessTokenType":{ "type":"string", "max":131072, "min":1, "sensitive":true }, "ActorId":{ "type":"string", "max":255, "min":1, "pattern":"[a-zA-Z0-9][a-zA-Z0-9-_/]*(?::[a-zA-Z0-9-_/]+)*[a-zA-Z0-9-_/]*" }, "ActorSummary":{ "type":"structure", "required":["actorId"], "members":{ "actorId":{ "shape":"ActorId", "documentation":"The unique identifier of the actor.
" } }, "documentation":"Contains summary information about an actor in an AgentCore Memory resource.
" }, "ActorSummaryList":{ "type":"list", "member":{"shape":"ActorSummary"} }, "AgentCard":{ "type":"structure", "members":{}, "document":true }, "ApiKeyType":{ "type":"string", "max":65536, "min":1, "sensitive":true }, "AuthorizationUrlType":{ "type":"string", "min":1, "sensitive":true }, "AutomationStream":{ "type":"structure", "required":[ "streamEndpoint", "streamStatus" ], "members":{ "streamEndpoint":{ "shape":"BrowserStreamEndpoint", "documentation":"The endpoint URL for the automation stream. This URL is used to establish a WebSocket connection to the stream for sending commands and receiving responses.
" }, "streamStatus":{ "shape":"AutomationStreamStatus", "documentation":"The current status of the automation stream. This indicates whether the stream is available for use. Possible values include ACTIVE, CONNECTING, and DISCONNECTED.
" } }, "documentation":"The configuration for a stream that enables programmatic control of a browser session in Amazon Bedrock. This stream provides a bidirectional communication channel for sending commands to the browser and receiving responses, allowing agents to automate web interactions such as navigation, form filling, and element clicking.
" }, "AutomationStreamStatus":{ "type":"string", "enum":[ "ENABLED", "DISABLED" ] }, "AutomationStreamUpdate":{ "type":"structure", "members":{ "streamStatus":{ "shape":"AutomationStreamStatus", "documentation":"The status of the automation stream.
" } }, "documentation":"Contains information about an update to an automation stream.
" }, "BatchCreateMemoryRecordsInput":{ "type":"structure", "required":[ "memoryId", "records" ], "members":{ "memoryId":{ "shape":"MemoryId", "documentation":"The unique ID of the memory resource where records will be created.
", "location":"uri", "locationName":"memoryId" }, "records":{ "shape":"MemoryRecordsCreateInputList", "documentation":"A list of memory record creation inputs to be processed in the batch operation.
" }, "clientToken":{ "shape":"String", "documentation":"A unique, case-sensitive identifier to ensure idempotent processing of the batch request.
", "idempotencyToken":true } } }, "BatchCreateMemoryRecordsOutput":{ "type":"structure", "required":[ "successfulRecords", "failedRecords" ], "members":{ "successfulRecords":{ "shape":"MemoryRecordsOutputList", "documentation":"A list of memory records that were successfully created during the batch operation.
" }, "failedRecords":{ "shape":"MemoryRecordsOutputList", "documentation":"A list of memory records that failed to be created, including error details for each failure.
" } } }, "BatchDeleteMemoryRecordsInput":{ "type":"structure", "required":[ "memoryId", "records" ], "members":{ "memoryId":{ "shape":"MemoryId", "documentation":"The unique ID of the memory resource where records will be deleted.
", "location":"uri", "locationName":"memoryId" }, "records":{ "shape":"MemoryRecordsDeleteInputList", "documentation":"A list of memory record deletion inputs to be processed in the batch operation.
" } } }, "BatchDeleteMemoryRecordsOutput":{ "type":"structure", "required":[ "successfulRecords", "failedRecords" ], "members":{ "successfulRecords":{ "shape":"MemoryRecordsOutputList", "documentation":"A list of memory records that were successfully deleted during the batch operation.
" }, "failedRecords":{ "shape":"MemoryRecordsOutputList", "documentation":"A list of memory records that failed to be deleted, including error details for each failure.
" } } }, "BatchUpdateMemoryRecordsInput":{ "type":"structure", "required":[ "memoryId", "records" ], "members":{ "memoryId":{ "shape":"MemoryId", "documentation":"The unique ID of the memory resource where records will be updated.
", "location":"uri", "locationName":"memoryId" }, "records":{ "shape":"MemoryRecordsUpdateInputList", "documentation":"A list of memory record update inputs to be processed in the batch operation.
" } } }, "BatchUpdateMemoryRecordsOutput":{ "type":"structure", "required":[ "successfulRecords", "failedRecords" ], "members":{ "successfulRecords":{ "shape":"MemoryRecordsOutputList", "documentation":"A list of memory records that were successfully updated during the batch operation.
" }, "failedRecords":{ "shape":"MemoryRecordsOutputList", "documentation":"A list of memory records that failed to be updated, including error details for each failure.
" } } }, "Blob":{"type":"blob"}, "Body":{ "type":"blob", "max":100000000, "min":0, "sensitive":true }, "Boolean":{ "type":"boolean", "box":true }, "Branch":{ "type":"structure", "required":["name"], "members":{ "rootEventId":{ "shape":"EventId", "documentation":"The identifier of the root event for this branch.
" }, "name":{ "shape":"BranchName", "documentation":"The name of the branch.
" } }, "documentation":"Contains information about a branch in an AgentCore Memory resource. Branches allow for organizing events into different conversation threads or paths.
" }, "BranchFilter":{ "type":"structure", "required":["name"], "members":{ "name":{ "shape":"BranchName", "documentation":"The name of the branch to filter by.
" }, "includeParentBranches":{ "shape":"Boolean", "documentation":"Specifies whether to include parent branches in the results. Set to true to include parent branches, or false to exclude them.
" } }, "documentation":"Contains filter criteria for branches when listing events.
" }, "BranchName":{ "type":"string", "max":100, "min":1, "pattern":"[a-zA-Z0-9][a-zA-Z0-9-_]*" }, "BrowserExtension":{ "type":"structure", "required":["location"], "members":{ "location":{ "shape":"ResourceLocation", "documentation":"The location where the browser extension files are stored. This specifies the source from which the extension will be loaded and installed.
" } }, "documentation":"Browser extension configuration.
" }, "BrowserExtensions":{ "type":"list", "member":{"shape":"BrowserExtension"}, "max":10, "min":1 }, "BrowserSessionId":{ "type":"string", "pattern":"[0-9a-zA-Z]{1,40}" }, "BrowserSessionStatus":{ "type":"string", "enum":[ "READY", "TERMINATED" ] }, "BrowserSessionStream":{ "type":"structure", "required":["automationStream"], "members":{ "automationStream":{ "shape":"AutomationStream", "documentation":"The stream that enables programmatic control of the browser. This stream allows agents to perform actions such as navigating to URLs, clicking elements, and filling forms.
" }, "liveViewStream":{ "shape":"LiveViewStream", "documentation":"The stream that provides a visual representation of the browser content. This stream allows agents to observe the current state of the browser, including rendered web pages and visual elements.
" } }, "documentation":"The collection of streams associated with a browser session in Amazon Bedrock. These streams provide different ways to interact with and observe the browser session, including programmatic control and visual representation of the browser content.
" }, "BrowserSessionSummaries":{ "type":"list", "member":{"shape":"BrowserSessionSummary"} }, "BrowserSessionSummary":{ "type":"structure", "required":[ "browserIdentifier", "sessionId", "status", "createdAt" ], "members":{ "browserIdentifier":{ "shape":"String", "documentation":"The unique identifier of the browser associated with the session. This identifier specifies which browser environment is used for the session.
" }, "sessionId":{ "shape":"BrowserSessionId", "documentation":"The unique identifier of the browser session. This identifier is used in operations that interact with the session.
" }, "name":{ "shape":"Name", "documentation":"The name of the browser session. This name helps identify and manage the session.
" }, "status":{ "shape":"BrowserSessionStatus", "documentation":"The current status of the browser session. Possible values include ACTIVE, STOPPING, and STOPPED.
" }, "createdAt":{ "shape":"DateTimestamp", "documentation":"The timestamp when the browser session was created. This value is in ISO 8601 format.
" }, "lastUpdatedAt":{ "shape":"DateTimestamp", "documentation":"The timestamp when the browser session was last updated. This value is in ISO 8601 format.
" } }, "documentation":"A condensed representation of a browser session in Amazon Bedrock. This structure contains key information about a browser session, including identifiers, status, and timestamps, without the full details of the session configuration and streams.
" }, "BrowserSessionTimeout":{ "type":"integer", "box":true, "max":28800, "min":1 }, "BrowserStreamEndpoint":{ "type":"string", "max":512, "min":10 }, "ClientToken":{ "type":"string", "max":256, "min":33, "pattern":"[a-zA-Z0-9](-*[a-zA-Z0-9]){0,256}" }, "CodeInterpreterResult":{ "type":"structure", "required":["content"], "members":{ "content":{ "shape":"ContentBlockList", "documentation":"The textual content of the execution result. This includes standard output from the code execution, such as print statements, console output, and text representations of results.
" }, "structuredContent":{ "shape":"ToolResultStructuredContent", "documentation":"The structured content of the execution result. This includes additional metadata about the execution, such as execution time, memory usage, and structured representations of output data. The format depends on the specific code interpreter and execution context.
" }, "isError":{ "shape":"Boolean", "documentation":"Indicates whether the result represents an error. If true, the content contains error messages or exception information. If false, the content contains successful execution results.
" } }, "documentation":"The output produced by executing code in a code interpreter session in Amazon Bedrock. This structure contains the results of code execution, including textual output, structured data, and error information. Agents use these results to generate responses that incorporate computation, data analysis, and visualization.
", "event":true }, "CodeInterpreterSessionId":{ "type":"string", "pattern":"[0-9a-zA-Z]{1,40}" }, "CodeInterpreterSessionStatus":{ "type":"string", "enum":[ "READY", "TERMINATED" ] }, "CodeInterpreterSessionSummaries":{ "type":"list", "member":{"shape":"CodeInterpreterSessionSummary"} }, "CodeInterpreterSessionSummary":{ "type":"structure", "required":[ "codeInterpreterIdentifier", "sessionId", "status", "createdAt" ], "members":{ "codeInterpreterIdentifier":{ "shape":"String", "documentation":"The unique identifier of the code interpreter associated with the session. This identifier specifies which code interpreter environment is used for the session.
" }, "sessionId":{ "shape":"CodeInterpreterSessionId", "documentation":"The unique identifier of the code interpreter session. This identifier is used in operations that interact with the session.
" }, "name":{ "shape":"Name", "documentation":"The name of the code interpreter session. This name helps identify and manage the session.
" }, "status":{ "shape":"CodeInterpreterSessionStatus", "documentation":"The current status of the code interpreter session. Possible values include ACTIVE, STOPPING, and STOPPED.
" }, "createdAt":{ "shape":"DateTimestamp", "documentation":"The timestamp when the code interpreter session was created. This value is in ISO 8601 format.
" }, "lastUpdatedAt":{ "shape":"DateTimestamp", "documentation":"The timestamp when the code interpreter session was last updated. This value is in ISO 8601 format.
" } }, "documentation":"A condensed representation of a code interpreter session in Amazon Bedrock. This structure contains key information about a code interpreter session, including identifiers, status, and timestamps, without the full details of the session configuration.
" }, "CodeInterpreterSessionTimeout":{ "type":"integer", "box":true, "max":28800, "min":1 }, "CodeInterpreterStreamOutput":{ "type":"structure", "members":{ "result":{"shape":"CodeInterpreterResult"}, "accessDeniedException":{"shape":"AccessDeniedException"}, "conflictException":{"shape":"ConflictException"}, "internalServerException":{"shape":"InternalServerException"}, "resourceNotFoundException":{"shape":"ResourceNotFoundException"}, "serviceQuotaExceededException":{"shape":"ServiceQuotaExceededException"}, "throttlingException":{"shape":"ThrottlingException"}, "validationException":{"shape":"ValidationException"} }, "documentation":"Contains output from a code interpreter stream.
", "eventstream":true }, "CompleteResourceTokenAuthRequest":{ "type":"structure", "required":[ "userIdentifier", "sessionUri" ], "members":{ "userIdentifier":{ "shape":"UserIdentifier", "documentation":"The OAuth2.0 token or user ID that was used to generate the workload access token used for initiating the user authorization flow to retrieve OAuth2.0 tokens.
" }, "sessionUri":{ "shape":"RequestUri", "documentation":"Unique identifier for the user's authentication session for retrieving OAuth2 tokens. This ID tracks the authorization flow state across multiple requests and responses during the OAuth2 authentication process.
" } } }, "CompleteResourceTokenAuthResponse":{ "type":"structure", "members":{} }, "ConflictException":{ "type":"structure", "members":{ "message":{"shape":"NonBlankString"} }, "documentation":"The exception that occurs when the request conflicts with the current state of the resource. This can happen when trying to modify a resource that is currently being modified by another request, or when trying to create a resource that already exists.
", "error":{ "httpStatusCode":409, "senderFault":true }, "exception":true }, "Content":{ "type":"structure", "members":{ "text":{ "shape":"ContentTextString", "documentation":"The text content of the memory item.
" } }, "documentation":"Contains the content of a memory item.
", "union":true }, "ContentBlock":{ "type":"structure", "required":["type"], "members":{ "type":{ "shape":"ContentBlockType", "documentation":"The type of content in the block.
" }, "text":{ "shape":"String", "documentation":"The text content of the block.
" }, "data":{ "shape":"Blob", "documentation":"The binary data content of the block.
" }, "mimeType":{ "shape":"String", "documentation":"The MIME type of the content.
" }, "uri":{ "shape":"String", "documentation":"The URI of the content.
" }, "name":{ "shape":"String", "documentation":"The name of the content block.
" }, "description":{ "shape":"String", "documentation":"The description of the content block.
" }, "size":{ "shape":"Long", "documentation":"The size of the content in bytes.
" }, "resource":{ "shape":"ResourceContent", "documentation":"The resource associated with the content block.
" } }, "documentation":"A block of content in a response.
" }, "ContentBlockList":{ "type":"list", "member":{"shape":"ContentBlock"} }, "ContentBlockType":{ "type":"string", "enum":[ "text", "image", "resource", "resource_link" ] }, "ContentTextString":{ "type":"string", "max":100000, "min":1, "sensitive":true }, "Context":{ "type":"structure", "members":{ "spanContext":{ "shape":"SpanContext", "documentation":"The span context information that uniquely identifies the trace and span being evaluated, including session ID, trace ID, and span ID for precise targeting within the agent's execution flow.
" } }, "documentation":"The contextual information associated with an evaluation, including span context details that identify the specific traces and sessions being evaluated within the agent's execution flow.
", "union":true }, "Conversational":{ "type":"structure", "required":[ "content", "role" ], "members":{ "content":{ "shape":"Content", "documentation":"The content of the conversation message.
" }, "role":{ "shape":"Role", "documentation":"The role of the participant in the conversation (for example, \"user\" or \"assistant\").
" } }, "documentation":"Contains conversational content for an event payload.
" }, "CreateEventInput":{ "type":"structure", "required":[ "memoryId", "actorId", "eventTimestamp", "payload" ], "members":{ "memoryId":{ "shape":"MemoryId", "documentation":"The identifier of the AgentCore Memory resource in which to create the event.
", "location":"uri", "locationName":"memoryId" }, "actorId":{ "shape":"ActorId", "documentation":"The identifier of the actor associated with this event. An actor represents an entity that participates in sessions and generates events.
" }, "sessionId":{ "shape":"SessionId", "documentation":"The identifier of the session in which this event occurs. A session represents a sequence of related events.
" }, "eventTimestamp":{ "shape":"Timestamp", "documentation":"The timestamp when the event occurred. If not specified, the current time is used.
" }, "payload":{ "shape":"PayloadTypeList", "documentation":"The content payload of the event. This can include conversational data or binary content.
" }, "branch":{ "shape":"Branch", "documentation":"The branch information for this event. Branches allow for organizing events into different conversation threads or paths.
" }, "clientToken":{ "shape":"String", "documentation":"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.
", "idempotencyToken":true }, "metadata":{ "shape":"MetadataMap", "documentation":"The key-value metadata to attach to the event.
" } } }, "CreateEventOutput":{ "type":"structure", "required":["event"], "members":{ "event":{ "shape":"Event", "documentation":"The event that was created.
" } } }, "CredentialProviderName":{ "type":"string", "max":128, "min":1, "pattern":"[a-zA-Z0-9\\-_]+" }, "CustomRequestKeyType":{ "type":"string", "max":256, "min":1, "pattern":"[a-zA-Z0-9\\-_\\.]+" }, "CustomRequestParametersType":{ "type":"map", "key":{"shape":"CustomRequestKeyType"}, "value":{"shape":"CustomRequestValueType"} }, "CustomRequestValueType":{ "type":"string", "max":2048, "min":1, "sensitive":true }, "DateTimestamp":{ "type":"timestamp", "timestampFormat":"iso8601" }, "DeleteEventInput":{ "type":"structure", "required":[ "memoryId", "sessionId", "eventId", "actorId" ], "members":{ "memoryId":{ "shape":"MemoryId", "documentation":"The identifier of the AgentCore Memory resource from which to delete the event.
", "location":"uri", "locationName":"memoryId" }, "sessionId":{ "shape":"SessionId", "documentation":"The identifier of the session containing the event to delete.
", "location":"uri", "locationName":"sessionId" }, "eventId":{ "shape":"EventId", "documentation":"The identifier of the event to delete.
", "location":"uri", "locationName":"eventId" }, "actorId":{ "shape":"ActorId", "documentation":"The identifier of the actor associated with the event to delete.
", "location":"uri", "locationName":"actorId" } } }, "DeleteEventOutput":{ "type":"structure", "required":["eventId"], "members":{ "eventId":{ "shape":"EventId", "documentation":"The identifier of the event that was deleted.
" } } }, "DeleteMemoryRecordInput":{ "type":"structure", "required":[ "memoryId", "memoryRecordId" ], "members":{ "memoryId":{ "shape":"MemoryId", "documentation":"The identifier of the AgentCore Memory resource from which to delete the memory record.
", "location":"uri", "locationName":"memoryId" }, "memoryRecordId":{ "shape":"MemoryRecordId", "documentation":"The identifier of the memory record to delete.
", "location":"uri", "locationName":"memoryRecordId" } } }, "DeleteMemoryRecordOutput":{ "type":"structure", "required":["memoryRecordId"], "members":{ "memoryRecordId":{ "shape":"MemoryRecordId", "documentation":"The identifier of the memory record that was deleted.
" } } }, "Document":{ "type":"structure", "members":{}, "document":true, "sensitive":true }, "Double":{ "type":"double", "box":true }, "DuplicateIdException":{ "type":"structure", "members":{ "message":{"shape":"NonBlankString"} }, "documentation":"An exception thrown when attempting to create a resource with an identifier that already exists.
", "error":{ "httpStatusCode":409, "senderFault":true }, "exception":true }, "EvaluateRequest":{ "type":"structure", "required":[ "evaluatorId", "evaluationInput" ], "members":{ "evaluatorId":{ "shape":"EvaluatorId", "documentation":" The unique identifier of the evaluator to use for scoring. Can be a built-in evaluator (e.g., Builtin.Helpfulness, Builtin.Correctness) or a custom evaluator ARN created through the control plane API.
The input data containing agent session spans to be evaluated. Includes a list of spans in OpenTelemetry format from supported frameworks like Strands (AgentCore Runtime) or LangGraph with OpenInference instrumentation.
" }, "evaluationTarget":{ "shape":"EvaluationTarget", "documentation":"The specific trace or span IDs to evaluate within the provided input. Allows targeting evaluation at different levels: individual tool calls, single request-response interactions (traces), or entire conversation sessions.
" } } }, "EvaluateResponse":{ "type":"structure", "required":["evaluationResults"], "members":{ "evaluationResults":{ "shape":"EvaluationResults", "documentation":"The detailed evaluation results containing scores, explanations, and metadata. Includes the evaluator information, numerical or categorical ratings based on the evaluator's rating scale, and token usage statistics for the evaluation process.
" } } }, "EvaluationErrorCode":{ "type":"string", "max":1024, "min":1 }, "EvaluationErrorMessage":{ "type":"string", "max":2048, "min":0 }, "EvaluationExplanation":{ "type":"string", "max":2048, "min":0, "sensitive":true }, "EvaluationInput":{ "type":"structure", "members":{ "sessionSpans":{ "shape":"Spans", "documentation":"The collection of spans representing agent execution traces within a session. Each span contains detailed information about tool calls, model interactions, and other agent activities that can be evaluated for quality and performance.
" } }, "documentation":"The input data structure containing agent session spans in OpenTelemetry format. Supports traces from frameworks like Strands (AgentCore Runtime) and LangGraph with OpenInference instrumentation for comprehensive evaluation.
", "union":true }, "EvaluationResultContent":{ "type":"structure", "required":[ "evaluatorArn", "evaluatorId", "evaluatorName", "context" ], "members":{ "evaluatorArn":{ "shape":"EvaluatorArn", "documentation":" The Amazon Resource Name (ARN) of the evaluator used to generate this result. For custom evaluators, this is the full ARN; for built-in evaluators, this follows the pattern Builtin.{EvaluatorName}.
The unique identifier of the evaluator that produced this result. This matches the evaluatorId provided in the evaluation request and can be used to identify which evaluator generated specific results.
The human-readable name of the evaluator used for this evaluation. For built-in evaluators, this is the descriptive name (e.g., \"Helpfulness\", \"Correctness\"); for custom evaluators, this is the user-defined name.
" }, "explanation":{ "shape":"EvaluationExplanation", "documentation":"The detailed explanation provided by the evaluator describing the reasoning behind the assigned score. This qualitative feedback helps understand why specific ratings were given and provides actionable insights for improvement.
" }, "context":{ "shape":"Context", "documentation":"The contextual information associated with this evaluation result, including span context details that identify the specific traces and sessions that were evaluated.
" }, "value":{ "shape":"Double", "documentation":"The numerical score assigned by the evaluator according to its configured rating scale. For numerical scales, this is a decimal value within the defined range. This field is not allowed for categorical scales.
" }, "label":{ "shape":"String", "documentation":"The categorical label assigned by the evaluator when using a categorical rating scale. This provides a human-readable description of the evaluation result (e.g., \"Excellent\", \"Good\", \"Poor\") corresponding to the numerical value. For numerical scales, this field is optional and provides a natural language explanation of what the value means (e.g., value 0.5 = \"Somewhat Helpful\").
" }, "tokenUsage":{ "shape":"TokenUsage", "documentation":"The token consumption statistics for this evaluation, including input tokens, output tokens, and total tokens used by the underlying language model during the evaluation process.
" }, "errorMessage":{ "shape":"EvaluationErrorMessage", "documentation":"The error message describing what went wrong if the evaluation failed. Provides detailed information about evaluation failures to help diagnose and resolve issues with evaluator configuration or input data.
" }, "errorCode":{ "shape":"EvaluationErrorCode", "documentation":"The error code indicating the type of failure that occurred during evaluation. Used to programmatically identify and handle different categories of evaluation errors.
" } }, "documentation":"The comprehensive result of an evaluation containing the score, explanation, evaluator metadata, and execution details. Provides both quantitative ratings and qualitative insights about agent performance.
" }, "EvaluationResults":{ "type":"list", "member":{"shape":"EvaluationResultContent"} }, "EvaluationTarget":{ "type":"structure", "members":{ "spanIds":{ "shape":"SpanIds", "documentation":"The list of specific span IDs to evaluate within the provided traces. Used to target evaluation at individual tool calls or specific operations within the agent's execution flow.
" }, "traceIds":{ "shape":"TraceIds", "documentation":"The list of trace IDs to evaluate, representing complete request-response interactions. Used to evaluate entire conversation turns or specific agent interactions within a session.
" } }, "documentation":"The specification of which trace or span IDs to evaluate within the provided input data. Allows precise targeting of evaluation at different levels: tool calls, traces, or sessions.
", "union":true }, "EvaluatorArn":{ "type":"string", "pattern":"arn:aws:bedrock-agentcore:[a-z0-9-]+:[0-9]{12}:evaluator\\/[a-zA-Z][a-zA-Z0-9-_]{0,99}-[a-zA-Z0-9]{10}$|^arn:aws:bedrock-agentcore:::evaluator/Builtin.[a-zA-Z0-9_-]+" }, "EvaluatorId":{ "type":"string", "pattern":"(Builtin.[a-zA-Z0-9_-]+|[a-zA-Z][a-zA-Z0-9-_]{0,99}-[a-zA-Z0-9]{10})" }, "EvaluatorName":{ "type":"string", "pattern":"(Builtin.[a-zA-Z0-9_-]+|[a-zA-Z][a-zA-Z0-9_]{0,47})" }, "Event":{ "type":"structure", "required":[ "memoryId", "actorId", "sessionId", "eventId", "eventTimestamp", "payload" ], "members":{ "memoryId":{ "shape":"MemoryId", "documentation":"The identifier of the AgentCore Memory resource containing the event.
" }, "actorId":{ "shape":"ActorId", "documentation":"The identifier of the actor associated with the event.
" }, "sessionId":{ "shape":"SessionId", "documentation":"The identifier of the session containing the event.
" }, "eventId":{ "shape":"EventId", "documentation":"The unique identifier of the event.
" }, "eventTimestamp":{ "shape":"Timestamp", "documentation":"The timestamp when the event occurred.
" }, "payload":{ "shape":"PayloadTypeList", "documentation":"The content payload of the event.
" }, "branch":{ "shape":"Branch", "documentation":"The branch information for the event.
" }, "metadata":{ "shape":"MetadataMap", "documentation":"Metadata associated with an event.
" } }, "documentation":"Contains information about an event in an AgentCore Memory resource.
" }, "EventId":{ "type":"string", "pattern":"[0-9]+#[a-fA-F0-9]+" }, "EventList":{ "type":"list", "member":{"shape":"Event"} }, "EventMetadataFilterExpression":{ "type":"structure", "required":[ "left", "operator" ], "members":{ "left":{ "shape":"LeftExpression", "documentation":"Left operand of the event metadata filter expression.
" }, "operator":{ "shape":"OperatorType", "documentation":"Operator applied to the event metadata filter expression.
" }, "right":{ "shape":"RightExpression", "documentation":"Right operand of the event metadata filter expression.
" } }, "documentation":"Filter expression for retrieving events based on metadata associated with an event.
" }, "EventMetadataFilterList":{ "type":"list", "member":{"shape":"EventMetadataFilterExpression"}, "max":5, "min":1 }, "ExtractionJob":{ "type":"structure", "required":["jobId"], "members":{ "jobId":{ "shape":"String", "documentation":"The unique identifier of the extraction job.
" } }, "documentation":"Represents the metadata of a memory extraction job such as the message identifiers that compose this job.
" }, "ExtractionJobFilterInput":{ "type":"structure", "members":{ "strategyId":{ "shape":"String", "documentation":"The memory strategy identifier to filter extraction jobs by. If specified, only extraction jobs with this strategy ID are returned.
" }, "sessionId":{ "shape":"String", "documentation":"The unique identifier of the session. If specified, only extraction jobs with this session ID are returned.
" }, "actorId":{ "shape":"String", "documentation":"The identifier of the actor. If specified, only extraction jobs with this actor ID are returned.
" }, "status":{ "shape":"ExtractionJobStatus", "documentation":"The status of the extraction job. If specified, only extraction jobs with this status are returned.
" } }, "documentation":"Filters for querying memory extraction jobs based on various criteria.
" }, "ExtractionJobMessages":{ "type":"structure", "members":{ "messagesList":{ "shape":"MessagesList", "documentation":"The list of messages that compose this extraction job.
" } }, "documentation":"The list of messages that compose this extraction job.
", "union":true }, "ExtractionJobMetadata":{ "type":"structure", "required":[ "jobID", "messages" ], "members":{ "jobID":{ "shape":"String", "documentation":"The unique identifier for the extraction job.
" }, "messages":{ "shape":"ExtractionJobMessages", "documentation":"The messages associated with the extraction job.
" }, "status":{ "shape":"ExtractionJobStatus", "documentation":"The current status of the extraction job.
" }, "failureReason":{ "shape":"String", "documentation":"The cause of failure, if the job did not complete successfully.
" }, "strategyId":{ "shape":"String", "documentation":"The identifier of the memory strategy for this extraction job.
" }, "sessionId":{ "shape":"String", "documentation":"The identifier of the session for this extraction job.
" }, "actorId":{ "shape":"String", "documentation":"The identifier of the actor for this extraction job.
" } }, "documentation":"Metadata information associated with this extraction job.
" }, "ExtractionJobMetadataList":{ "type":"list", "member":{"shape":"ExtractionJobMetadata"} }, "ExtractionJobStatus":{ "type":"string", "enum":["FAILED"] }, "FilterInput":{ "type":"structure", "members":{ "branch":{ "shape":"BranchFilter", "documentation":"The branch filter criteria to apply when listing events.
" }, "eventMetadata":{ "shape":"EventMetadataFilterList", "documentation":"Event metadata filter criteria to apply when retrieving events.
" } }, "documentation":"Contains filter criteria for listing events.
" }, "GetAgentCardRequest":{ "type":"structure", "required":["agentRuntimeArn"], "members":{ "runtimeSessionId":{ "shape":"SessionType", "documentation":"The session ID that the AgentCore Runtime agent is using.
", "idempotencyToken":true, "location":"header", "locationName":"X-Amzn-Bedrock-AgentCore-Runtime-Session-Id" }, "agentRuntimeArn":{ "shape":"String", "documentation":"The ARN of the AgentCore Runtime agent for which you want to get the A2A agent card.
", "location":"uri", "locationName":"agentRuntimeArn" }, "qualifier":{ "shape":"String", "documentation":"Optional qualifier to specify an agent alias, such as prodcode> or dev. If you don't provide a value, the DEFAULT alias is used.
The ID of the session associated with the AgentCore Runtime agent.
", "location":"header", "locationName":"X-Amzn-Bedrock-AgentCore-Runtime-Session-Id" }, "agentCard":{ "shape":"AgentCard", "documentation":"An agent card document that contains metadata and capabilities for an AgentCore Runtime agent.
" }, "statusCode":{ "shape":"HttpResponseCode", "documentation":"The status code of the request.
", "location":"statusCode" } }, "payload":"agentCard" }, "GetBrowserSessionRequest":{ "type":"structure", "required":[ "browserIdentifier", "sessionId" ], "members":{ "browserIdentifier":{ "shape":"String", "documentation":"The unique identifier of the browser associated with the session.
", "location":"uri", "locationName":"browserIdentifier" }, "sessionId":{ "shape":"BrowserSessionId", "documentation":"The unique identifier of the browser session to retrieve.
", "location":"querystring", "locationName":"sessionId" } } }, "GetBrowserSessionResponse":{ "type":"structure", "required":[ "browserIdentifier", "sessionId", "createdAt" ], "members":{ "browserIdentifier":{ "shape":"String", "documentation":"The identifier of the browser.
" }, "sessionId":{ "shape":"BrowserSessionId", "documentation":"The identifier of the browser session.
" }, "name":{ "shape":"Name", "documentation":"The name of the browser session.
" }, "createdAt":{ "shape":"DateTimestamp", "documentation":"The time at which the browser session was created.
" }, "viewPort":{"shape":"ViewPort"}, "extensions":{ "shape":"BrowserExtensions", "documentation":"The list of browser extensions that are configured in the browser session.
" }, "sessionTimeoutSeconds":{ "shape":"BrowserSessionTimeout", "documentation":"The timeout period for the browser session in seconds.
" }, "status":{ "shape":"BrowserSessionStatus", "documentation":"The current status of the browser session. Possible values include ACTIVE, STOPPING, and STOPPED.
" }, "streams":{ "shape":"BrowserSessionStream", "documentation":"The streams associated with this browser session. These include the automation stream and live view stream.
" }, "sessionReplayArtifact":{ "shape":"String", "documentation":"The artifact containing the session replay information.
" }, "lastUpdatedAt":{ "shape":"DateTimestamp", "documentation":"The time at which the browser session was last updated.
" } } }, "GetCodeInterpreterSessionRequest":{ "type":"structure", "required":[ "codeInterpreterIdentifier", "sessionId" ], "members":{ "codeInterpreterIdentifier":{ "shape":"String", "documentation":"The unique identifier of the code interpreter associated with the session.
", "location":"uri", "locationName":"codeInterpreterIdentifier" }, "sessionId":{ "shape":"CodeInterpreterSessionId", "documentation":"The unique identifier of the code interpreter session to retrieve.
", "location":"querystring", "locationName":"sessionId" } } }, "GetCodeInterpreterSessionResponse":{ "type":"structure", "required":[ "codeInterpreterIdentifier", "sessionId", "createdAt" ], "members":{ "codeInterpreterIdentifier":{ "shape":"String", "documentation":"The identifier of the code interpreter.
" }, "sessionId":{ "shape":"CodeInterpreterSessionId", "documentation":"The identifier of the code interpreter session.
" }, "name":{ "shape":"Name", "documentation":"The name of the code interpreter session.
" }, "createdAt":{ "shape":"DateTimestamp", "documentation":"The time at which the code interpreter session was created.
" }, "sessionTimeoutSeconds":{ "shape":"CodeInterpreterSessionTimeout", "documentation":"The timeout period for the code interpreter session in seconds.
" }, "status":{ "shape":"CodeInterpreterSessionStatus", "documentation":"The current status of the code interpreter session. Possible values include ACTIVE, STOPPING, and STOPPED.
" } } }, "GetEventInput":{ "type":"structure", "required":[ "memoryId", "sessionId", "actorId", "eventId" ], "members":{ "memoryId":{ "shape":"MemoryId", "documentation":"The identifier of the AgentCore Memory resource containing the event.
", "location":"uri", "locationName":"memoryId" }, "sessionId":{ "shape":"SessionId", "documentation":"The identifier of the session containing the event.
", "location":"uri", "locationName":"sessionId" }, "actorId":{ "shape":"ActorId", "documentation":"The identifier of the actor associated with the event.
", "location":"uri", "locationName":"actorId" }, "eventId":{ "shape":"EventId", "documentation":"The identifier of the event to retrieve.
", "location":"uri", "locationName":"eventId" } } }, "GetEventOutput":{ "type":"structure", "required":["event"], "members":{ "event":{ "shape":"Event", "documentation":"The requested event information.
" } } }, "GetMemoryRecordInput":{ "type":"structure", "required":[ "memoryId", "memoryRecordId" ], "members":{ "memoryId":{ "shape":"MemoryId", "documentation":"The identifier of the AgentCore Memory resource containing the memory record.
", "location":"uri", "locationName":"memoryId" }, "memoryRecordId":{ "shape":"MemoryRecordId", "documentation":"The identifier of the memory record to retrieve.
", "location":"uri", "locationName":"memoryRecordId" } } }, "GetMemoryRecordOutput":{ "type":"structure", "required":["memoryRecord"], "members":{ "memoryRecord":{ "shape":"MemoryRecord", "documentation":"The requested memory record.
" } } }, "GetResourceApiKeyRequest":{ "type":"structure", "required":[ "workloadIdentityToken", "resourceCredentialProviderName" ], "members":{ "workloadIdentityToken":{ "shape":"WorkloadIdentityTokenType", "documentation":"The identity token of the workload from which you want to retrieve the API key.
" }, "resourceCredentialProviderName":{ "shape":"CredentialProviderName", "documentation":"The credential provider name for the resource from which you are retrieving the API key.
" } } }, "GetResourceApiKeyResponse":{ "type":"structure", "required":["apiKey"], "members":{ "apiKey":{ "shape":"ApiKeyType", "documentation":"The API key associated with the resource requested.
" } } }, "GetResourceOauth2TokenRequest":{ "type":"structure", "required":[ "workloadIdentityToken", "resourceCredentialProviderName", "scopes", "oauth2Flow" ], "members":{ "workloadIdentityToken":{ "shape":"WorkloadIdentityTokenType", "documentation":"The identity token of the workload from which you want to retrieve the OAuth2 token.
" }, "resourceCredentialProviderName":{ "shape":"CredentialProviderName", "documentation":"The name of the resource's credential provider.
" }, "scopes":{ "shape":"ScopesListType", "documentation":"The OAuth scopes being requested.
" }, "oauth2Flow":{ "shape":"Oauth2FlowType", "documentation":"The type of flow to be performed.
" }, "sessionUri":{ "shape":"RequestUri", "documentation":"Unique identifier for the user's authentication session for retrieving OAuth2 tokens. This ID tracks the authorization flow state across multiple requests and responses during the OAuth2 authentication process.
" }, "resourceOauth2ReturnUrl":{ "shape":"ResourceOauth2ReturnUrlType", "documentation":"The callback URL to redirect to after the OAuth 2.0 token retrieval is complete. This URL must be one of the provided URLs configured for the workload identity.
" }, "forceAuthentication":{ "shape":"Boolean", "documentation":"Indicates whether to always initiate a new three-legged OAuth (3LO) flow, regardless of any existing session.
" }, "customParameters":{ "shape":"CustomRequestParametersType", "documentation":"A map of custom parameters to include in the authorization request to the resource credential provider. These parameters are in addition to the standard OAuth 2.0 flow parameters, and will not override them.
" }, "customState":{ "shape":"State", "documentation":"An opaque string that will be sent back to the callback URL provided in resourceOauth2ReturnUrl. This state should be used to protect the callback URL of your application against CSRF attacks by ensuring the response corresponds to the original request.
" } } }, "GetResourceOauth2TokenResponse":{ "type":"structure", "members":{ "authorizationUrl":{ "shape":"AuthorizationUrlType", "documentation":"The URL to initiate the authorization process, provided when the access token requires user authorization.
" }, "accessToken":{ "shape":"AccessTokenType", "documentation":"The OAuth 2.0 access token to use.
" }, "sessionUri":{ "shape":"RequestUri", "documentation":"Unique identifier for the user's authorization session for retrieving OAuth2 tokens. This matches the sessionId from the request and can be used to track the session state.
" }, "sessionStatus":{ "shape":"SessionStatus", "documentation":"Status indicating whether the user's authorization session is in progress or has failed. This helps determine the next steps in the OAuth2 authentication flow.
" } } }, "GetWorkloadAccessTokenForJWTRequest":{ "type":"structure", "required":[ "workloadName", "userToken" ], "members":{ "workloadName":{ "shape":"WorkloadIdentityNameType", "documentation":"The unique identifier for the registered workload.
" }, "userToken":{ "shape":"UserTokenType", "documentation":"The OAuth 2.0 token issued by the user's identity provider.
" } } }, "GetWorkloadAccessTokenForJWTResponse":{ "type":"structure", "required":["workloadAccessToken"], "members":{ "workloadAccessToken":{ "shape":"WorkloadIdentityTokenType", "documentation":"An opaque token representing the identity of both the workload and the user.
" } } }, "GetWorkloadAccessTokenForUserIdRequest":{ "type":"structure", "required":[ "workloadName", "userId" ], "members":{ "workloadName":{ "shape":"WorkloadIdentityNameType", "documentation":"The name of the workload from which you want to retrieve the access token.
" }, "userId":{ "shape":"UserIdType", "documentation":"The ID of the user for whom you are retrieving the access token.
" } } }, "GetWorkloadAccessTokenForUserIdResponse":{ "type":"structure", "required":["workloadAccessToken"], "members":{ "workloadAccessToken":{ "shape":"WorkloadIdentityTokenType", "documentation":"The access token for the specified workload.
" } } }, "GetWorkloadAccessTokenRequest":{ "type":"structure", "required":["workloadName"], "members":{ "workloadName":{ "shape":"WorkloadIdentityNameType", "documentation":"The unique identifier for the registered workload.
" } } }, "GetWorkloadAccessTokenResponse":{ "type":"structure", "required":["workloadAccessToken"], "members":{ "workloadAccessToken":{ "shape":"WorkloadIdentityTokenType", "documentation":"An opaque token representing the identity of both the workload and the user.
" } } }, "HttpResponseCode":{ "type":"integer", "box":true }, "InputContentBlock":{ "type":"structure", "required":["path"], "members":{ "path":{ "shape":"MaxLenString", "documentation":"The path to the input content.
" }, "text":{ "shape":"MaxLenString", "documentation":"The text input content.
" }, "blob":{ "shape":"Body", "documentation":"The binary input content.
" } }, "documentation":"A block of input content.
" }, "InputContentBlockList":{ "type":"list", "member":{"shape":"InputContentBlock"} }, "Integer":{ "type":"integer", "box":true }, "InternalServerException":{ "type":"structure", "members":{ "message":{"shape":"NonBlankString"} }, "documentation":"The exception that occurs when the service encounters an unexpected internal error. This is a temporary condition that will resolve itself with retries. We recommend implementing exponential backoff retry logic in your application.
", "error":{"httpStatusCode":500}, "exception":true, "fault":true }, "InvalidInputException":{ "type":"structure", "required":["message"], "members":{ "message":{"shape":"String"} }, "documentation":"The input fails to satisfy the constraints specified by AgentCore. Check your input values and try again.
", "error":{ "httpStatusCode":400, "senderFault":true }, "exception":true }, "InvokeAgentRuntimeRequest":{ "type":"structure", "required":[ "agentRuntimeArn", "payload" ], "members":{ "contentType":{ "shape":"MimeType", "documentation":"The MIME type of the input data in the payload. This tells the agent runtime how to interpret the payload data. Common values include application/json for JSON data.
", "location":"header", "locationName":"Content-Type" }, "accept":{ "shape":"MimeType", "documentation":"The desired MIME type for the response from the agent runtime. This tells the agent runtime what format to use for the response data. Common values include application/json for JSON data.
", "location":"header", "locationName":"Accept" }, "mcpSessionId":{ "shape":"StringType", "documentation":"The identifier of the MCP session.
", "location":"header", "locationName":"Mcp-Session-Id" }, "runtimeSessionId":{ "shape":"SessionType", "documentation":"The identifier of the runtime session.
", "idempotencyToken":true, "location":"header", "locationName":"X-Amzn-Bedrock-AgentCore-Runtime-Session-Id" }, "mcpProtocolVersion":{ "shape":"StringType", "documentation":"The version of the MCP protocol being used.
", "location":"header", "locationName":"Mcp-Protocol-Version" }, "runtimeUserId":{ "shape":"StringType", "documentation":"The identifier of the runtime user.
", "location":"header", "locationName":"X-Amzn-Bedrock-AgentCore-Runtime-User-Id" }, "traceId":{ "shape":"InvokeAgentRuntimeRequestTraceIdString", "documentation":"The trace identifier for request tracking.
", "location":"header", "locationName":"X-Amzn-Trace-Id" }, "traceParent":{ "shape":"InvokeAgentRuntimeRequestTraceParentString", "documentation":"The parent trace information for distributed tracing.
", "location":"header", "locationName":"traceparent" }, "traceState":{ "shape":"InvokeAgentRuntimeRequestTraceStateString", "documentation":"The trace state information for distributed tracing.
", "location":"header", "locationName":"tracestate" }, "baggage":{ "shape":"InvokeAgentRuntimeRequestBaggageString", "documentation":"Additional context information for distributed tracing.
", "location":"header", "locationName":"baggage" }, "agentRuntimeArn":{ "shape":"String", "documentation":"The Amazon Web Services Resource Name (ARN) of the agent runtime to invoke. The ARN uniquely identifies the agent runtime resource in Amazon Bedrock.
", "location":"uri", "locationName":"agentRuntimeArn" }, "qualifier":{ "shape":"String", "documentation":"The qualifier to use for the agent runtime. This can be a version number or an endpoint name that points to a specific version. If not specified, Amazon Bedrock uses the default version of the agent runtime.
", "location":"querystring", "locationName":"qualifier" }, "accountId":{ "shape":"InvokeAgentRuntimeRequestAccountIdString", "documentation":"The identifier of the Amazon Web Services account for the agent runtime resource.
", "location":"querystring", "locationName":"accountId" }, "payload":{ "shape":"Body", "documentation":"The input data to send to the agent runtime. The format of this data depends on the specific agent configuration and must match the specified content type. For most agents, this is a JSON object containing the user's request.
" } }, "payload":"payload" }, "InvokeAgentRuntimeRequestAccountIdString":{ "type":"string", "pattern":"[0-9]{12}" }, "InvokeAgentRuntimeRequestBaggageString":{ "type":"string", "max":8192, "min":0 }, "InvokeAgentRuntimeRequestTraceIdString":{ "type":"string", "max":128, "min":0 }, "InvokeAgentRuntimeRequestTraceParentString":{ "type":"string", "max":128, "min":0 }, "InvokeAgentRuntimeRequestTraceStateString":{ "type":"string", "max":512, "min":0 }, "InvokeAgentRuntimeResponse":{ "type":"structure", "required":["contentType"], "members":{ "runtimeSessionId":{ "shape":"SessionId", "documentation":"The identifier of the runtime session.
", "location":"header", "locationName":"X-Amzn-Bedrock-AgentCore-Runtime-Session-Id" }, "mcpSessionId":{ "shape":"SessionId", "documentation":"The identifier of the MCP session.
", "location":"header", "locationName":"Mcp-Session-Id" }, "mcpProtocolVersion":{ "shape":"String", "documentation":"The version of the MCP protocol being used.
", "location":"header", "locationName":"Mcp-Protocol-Version" }, "traceId":{ "shape":"String", "documentation":"The trace identifier for request tracking.
", "location":"header", "locationName":"X-Amzn-Trace-Id" }, "traceParent":{ "shape":"String", "documentation":"The parent trace information for distributed tracing.
", "location":"header", "locationName":"traceparent" }, "traceState":{ "shape":"String", "documentation":"The trace state information for distributed tracing.
", "location":"header", "locationName":"tracestate" }, "baggage":{ "shape":"String", "documentation":"Additional context information for distributed tracing.
", "location":"header", "locationName":"baggage" }, "contentType":{ "shape":"String", "documentation":"The MIME type of the response data. This indicates how to interpret the response data. Common values include application/json for JSON data.
", "location":"header", "locationName":"Content-Type" }, "response":{ "shape":"ResponseStream", "documentation":"The response data from the agent runtime. The format of this data depends on the specific agent configuration and the requested accept type. For most agents, this is a JSON object containing the agent's response to the user's request.
" }, "statusCode":{ "shape":"HttpResponseCode", "documentation":"The HTTP status code of the response. A status code of 200 indicates a successful operation. Other status codes indicate various error conditions.
", "location":"statusCode" } }, "payload":"response" }, "InvokeCodeInterpreterRequest":{ "type":"structure", "required":[ "codeInterpreterIdentifier", "name" ], "members":{ "codeInterpreterIdentifier":{ "shape":"String", "documentation":"The unique identifier of the code interpreter associated with the session. This must match the identifier used when creating the session with StartCodeInterpreterSession.
The unique identifier of the code interpreter session to use. This must be an active session created with StartCodeInterpreterSession. If the session has expired or been stopped, the request will fail.
The trace identifier for request tracking.
", "location":"header", "locationName":"X-Amzn-Trace-Id" }, "traceParent":{ "shape":"InvokeCodeInterpreterRequestTraceParentString", "documentation":"The parent trace information for distributed tracing.
", "location":"header", "locationName":"traceparent" }, "name":{ "shape":"ToolName", "documentation":"The name of the code interpreter to invoke.
" }, "arguments":{ "shape":"ToolArguments", "documentation":"The arguments for the code interpreter. This includes the code to execute and any additional parameters such as the programming language, whether to clear the execution context, and other execution options. The structure of this parameter depends on the specific code interpreter being used.
" } } }, "InvokeCodeInterpreterRequestTraceIdString":{ "type":"string", "max":1024, "min":0 }, "InvokeCodeInterpreterRequestTraceParentString":{ "type":"string", "max":1024, "min":0 }, "InvokeCodeInterpreterResponse":{ "type":"structure", "required":["stream"], "members":{ "sessionId":{ "shape":"CodeInterpreterSessionId", "documentation":"The identifier of the code interpreter session.
", "location":"header", "locationName":"x-amzn-code-interpreter-session-id" }, "stream":{ "shape":"CodeInterpreterStreamOutput", "documentation":"The stream containing the results of the code execution. This includes output, errors, and execution status.
" } }, "payload":"stream" }, "LeftExpression":{ "type":"structure", "members":{ "metadataKey":{ "shape":"MetadataKey", "documentation":"Key associated with the metadata in an event.
" } }, "documentation":"Left expression of the event metadata filter.
", "union":true }, "ListActorsInput":{ "type":"structure", "required":["memoryId"], "members":{ "memoryId":{ "shape":"MemoryId", "documentation":"The identifier of the AgentCore Memory resource for which to list actors.
", "location":"uri", "locationName":"memoryId" }, "maxResults":{ "shape":"MaxResults", "documentation":"The maximum number of results to return in a single call. The default value is 20.
" }, "nextToken":{ "shape":"PaginationToken", "documentation":"The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
" } } }, "ListActorsOutput":{ "type":"structure", "required":["actorSummaries"], "members":{ "actorSummaries":{ "shape":"ActorSummaryList", "documentation":"The list of actor summaries.
" }, "nextToken":{ "shape":"PaginationToken", "documentation":"The token to use in a subsequent request to get the next set of results. This value is null when there are no more results to return.
" } } }, "ListBrowserSessionsRequest":{ "type":"structure", "required":["browserIdentifier"], "members":{ "browserIdentifier":{ "shape":"String", "documentation":"The unique identifier of the browser to list sessions for. If specified, only sessions for this browser are returned. If not specified, sessions for all browsers are returned.
", "location":"uri", "locationName":"browserIdentifier" }, "maxResults":{ "shape":"MaxResults", "documentation":"The maximum number of results to return in a single call. The default value is 10. Valid values range from 1 to 100. To retrieve the remaining results, make another call with the returned nextToken value.
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results. If not specified, Amazon Bedrock returns the first page of results.
" }, "status":{ "shape":"BrowserSessionStatus", "documentation":"The status of the browser sessions to list. Valid values include ACTIVE, STOPPING, and STOPPED. If not specified, sessions with any status are returned.
" } } }, "ListBrowserSessionsResponse":{ "type":"structure", "required":["items"], "members":{ "items":{ "shape":"BrowserSessionSummaries", "documentation":"The list of browser sessions that match the specified criteria.
" }, "nextToken":{ "shape":"NextToken", "documentation":"The token to use in a subsequent ListBrowserSessions request to get the next set of results.
The unique identifier of the code interpreter to list sessions for. If specified, only sessions for this code interpreter are returned. If not specified, sessions for all code interpreters are returned.
", "location":"uri", "locationName":"codeInterpreterIdentifier" }, "maxResults":{ "shape":"MaxResults", "documentation":"The maximum number of results to return in a single call. The default value is 10. Valid values range from 1 to 100. To retrieve the remaining results, make another call with the returned nextToken value.
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results. If not specified, Amazon Bedrock returns the first page of results.
" }, "status":{ "shape":"CodeInterpreterSessionStatus", "documentation":"The status of the code interpreter sessions to list. Valid values include ACTIVE, STOPPING, and STOPPED. If not specified, sessions with any status are returned.
" } } }, "ListCodeInterpreterSessionsResponse":{ "type":"structure", "required":["items"], "members":{ "items":{ "shape":"CodeInterpreterSessionSummaries", "documentation":"The list of code interpreter sessions that match the specified criteria.
" }, "nextToken":{ "shape":"NextToken", "documentation":"The token to use in a subsequent ListCodeInterpreterSessions request to get the next set of results.
The identifier of the AgentCore Memory resource for which to list events.
", "location":"uri", "locationName":"memoryId" }, "sessionId":{ "shape":"SessionId", "documentation":"The identifier of the session for which to list events.
", "location":"uri", "locationName":"sessionId" }, "actorId":{ "shape":"ActorId", "documentation":"The identifier of the actor for which to list events.
", "location":"uri", "locationName":"actorId" }, "includePayloads":{ "shape":"Boolean", "documentation":"Specifies whether to include event payloads in the response. Set to true to include payloads, or false to exclude them.
" }, "filter":{ "shape":"FilterInput", "documentation":"Filter criteria to apply when listing events.
" }, "maxResults":{ "shape":"MaxResults", "documentation":"The maximum number of results to return in a single call. The default value is 20.
" }, "nextToken":{ "shape":"PaginationToken", "documentation":"The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
" } } }, "ListEventsOutput":{ "type":"structure", "required":["events"], "members":{ "events":{ "shape":"EventList", "documentation":"The list of events that match the specified criteria.
" }, "nextToken":{ "shape":"PaginationToken", "documentation":"The token to use in a subsequent request to get the next set of results. This value is null when there are no more results to return.
" } } }, "ListMemoryExtractionJobsInput":{ "type":"structure", "required":["memoryId"], "members":{ "memoryId":{ "shape":"MemoryId", "documentation":"The unique identifier of the memory to list extraction jobs for.
", "location":"uri", "locationName":"memoryId" }, "maxResults":{ "shape":"ListMemoryExtractionJobsInputMaxResultsInteger", "documentation":"The maximum number of results to return in a single call. The default value is 20.
" }, "filter":{ "shape":"ExtractionJobFilterInput", "documentation":"Filter criteria to apply when listing extraction jobs.
" }, "nextToken":{ "shape":"PaginationToken", "documentation":"The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
" } } }, "ListMemoryExtractionJobsInputMaxResultsInteger":{ "type":"integer", "box":true, "max":50, "min":1 }, "ListMemoryExtractionJobsOutput":{ "type":"structure", "required":["jobs"], "members":{ "jobs":{ "shape":"ExtractionJobMetadataList", "documentation":"List of extraction job metadata matching the specified criteria.
" }, "nextToken":{ "shape":"PaginationToken", "documentation":"Token to retrieve the next page of results, if available.
" } } }, "ListMemoryRecordsInput":{ "type":"structure", "required":[ "memoryId", "namespace" ], "members":{ "memoryId":{ "shape":"MemoryId", "documentation":"The identifier of the AgentCore Memory resource for which to list memory records.
", "location":"uri", "locationName":"memoryId" }, "namespace":{ "shape":"Namespace", "documentation":"The namespace to filter memory records by. If specified, only memory records in this namespace are returned.
" }, "memoryStrategyId":{ "shape":"MemoryStrategyId", "documentation":"The memory strategy identifier to filter memory records by. If specified, only memory records with this strategy ID are returned.
" }, "maxResults":{ "shape":"MaxResults", "documentation":"The maximum number of results to return in a single call. The default value is 20.
" }, "nextToken":{ "shape":"PaginationToken", "documentation":"The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
" } } }, "ListMemoryRecordsOutput":{ "type":"structure", "required":["memoryRecordSummaries"], "members":{ "memoryRecordSummaries":{ "shape":"MemoryRecordSummaryList", "documentation":"The list of memory record summaries that match the specified criteria.
" }, "nextToken":{ "shape":"PaginationToken", "documentation":"The token to use in a subsequent request to get the next set of results. This value is null when there are no more results to return.
" } } }, "ListSessionsInput":{ "type":"structure", "required":[ "memoryId", "actorId" ], "members":{ "memoryId":{ "shape":"MemoryId", "documentation":"The identifier of the AgentCore Memory resource for which to list sessions.
", "location":"uri", "locationName":"memoryId" }, "actorId":{ "shape":"ActorId", "documentation":"The identifier of the actor for which to list sessions.
", "location":"uri", "locationName":"actorId" }, "maxResults":{ "shape":"MaxResults", "documentation":"The maximum number of results to return in a single call. The default value is 20.
" }, "nextToken":{ "shape":"PaginationToken", "documentation":"The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
" } } }, "ListSessionsOutput":{ "type":"structure", "required":["sessionSummaries"], "members":{ "sessionSummaries":{ "shape":"SessionSummaryList", "documentation":"The list of session summaries that match the specified criteria.
" }, "nextToken":{ "shape":"PaginationToken", "documentation":"The token to use in a subsequent request to get the next set of results. This value is null when there are no more results to return.
" } } }, "LiveViewStream":{ "type":"structure", "members":{ "streamEndpoint":{ "shape":"BrowserStreamEndpoint", "documentation":"The endpoint URL for the live view stream. This URL is used to establish a connection to receive visual updates from the browser session.
" } }, "documentation":"The configuration for a stream that provides a visual representation of a browser session in Amazon Bedrock. This stream enables agents to observe the current state of the browser, including rendered web pages, visual elements, and the results of interactions.
" }, "Long":{ "type":"long", "box":true }, "MaxLenString":{ "type":"string", "max":100000000, "min":0 }, "MaxResults":{ "type":"integer", "box":true, "max":100, "min":1 }, "MemoryContent":{ "type":"structure", "members":{ "text":{ "shape":"MemoryContentTextString", "documentation":"The text content of the memory record.
" } }, "documentation":"Contains the content of a memory record.
", "union":true }, "MemoryContentTextString":{ "type":"string", "max":16000, "min":1, "sensitive":true }, "MemoryId":{ "type":"string", "min":12, "pattern":"[a-zA-Z][a-zA-Z0-9-_]{0,99}-[a-zA-Z0-9]{10}" }, "MemoryMetadataFilterExpression":{ "type":"structure", "required":[ "left", "operator" ], "members":{ "left":{"shape":"LeftExpression"}, "operator":{ "shape":"OperatorType", "documentation":"The relationship between the metadata key and value to match when applying the metadata filter.
" }, "right":{"shape":"RightExpression"} }, "documentation":"Filters to apply to metadata associated with a memory. Specify the metadata key and value in the left and right fields and use the operator field to define the relationship to match.
The unique identifier of the memory record.
" }, "content":{ "shape":"MemoryContent", "documentation":"The content of the memory record.
" }, "memoryStrategyId":{ "shape":"MemoryStrategyId", "documentation":"The identifier of the memory strategy associated with this record.
" }, "namespaces":{ "shape":"NamespacesList", "documentation":"The namespaces associated with this memory record. Namespaces help organize and categorize memory records.
" }, "createdAt":{ "shape":"Timestamp", "documentation":"The timestamp when the memory record was created.
" }, "metadata":{ "shape":"MetadataMap", "documentation":"A map of metadata key-value pairs associated with a memory record.
" } }, "documentation":"Contains information about a memory record in an AgentCore Memory resource.
" }, "MemoryRecordCreateInput":{ "type":"structure", "required":[ "requestIdentifier", "namespaces", "content", "timestamp" ], "members":{ "requestIdentifier":{ "shape":"RequestIdentifier", "documentation":"A client-provided identifier for tracking this specific record creation request.
" }, "namespaces":{ "shape":"NamespacesList", "documentation":"A list of namespace identifiers that categorize or group the memory record.
" }, "content":{ "shape":"MemoryContent", "documentation":"The content to be stored within the memory record.
" }, "timestamp":{ "shape":"Timestamp", "documentation":"Time at which the memory record was created.
" }, "memoryStrategyId":{ "shape":"MemoryStrategyId", "documentation":"The ID of the memory strategy that defines how this memory record is grouped.
" } }, "documentation":"Input structure to create a new memory record.
" }, "MemoryRecordDeleteInput":{ "type":"structure", "required":["memoryRecordId"], "members":{ "memoryRecordId":{ "shape":"MemoryRecordId", "documentation":"The unique ID of the memory record to be deleted.
" } }, "documentation":"Input structure to delete an existing memory record.
" }, "MemoryRecordId":{ "type":"string", "max":50, "min":40, "pattern":"mem-[a-zA-Z0-9-_]*" }, "MemoryRecordOutput":{ "type":"structure", "required":[ "memoryRecordId", "status" ], "members":{ "memoryRecordId":{ "shape":"MemoryRecordId", "documentation":"The unique ID associated to the memory record.
" }, "status":{ "shape":"MemoryRecordStatus", "documentation":"The status of the memory record operation (e.g., SUCCEEDED, FAILED).
" }, "requestIdentifier":{ "shape":"RequestIdentifier", "documentation":"The client-provided identifier that was used to track this record operation.
" }, "errorCode":{ "shape":"Integer", "documentation":"The error code returned when the memory record operation fails.
" }, "errorMessage":{ "shape":"String", "documentation":"A human-readable error message describing why the memory record operation failed.
" } }, "documentation":"Output information returned after processing a memory record operation.
" }, "MemoryRecordStatus":{ "type":"string", "enum":[ "SUCCEEDED", "FAILED" ] }, "MemoryRecordSummary":{ "type":"structure", "required":[ "memoryRecordId", "content", "memoryStrategyId", "namespaces", "createdAt" ], "members":{ "memoryRecordId":{ "shape":"MemoryRecordId", "documentation":"The unique identifier of the memory record.
" }, "content":{ "shape":"MemoryContent", "documentation":"The content of the memory record.
" }, "memoryStrategyId":{ "shape":"MemoryStrategyId", "documentation":"The identifier of the memory strategy associated with this record.
" }, "namespaces":{ "shape":"NamespacesList", "documentation":"The namespaces associated with this memory record.
" }, "createdAt":{ "shape":"Timestamp", "documentation":"The timestamp when the memory record was created.
" }, "score":{ "shape":"Double", "documentation":"The relevance score of the memory record when returned as part of a search result. Higher values indicate greater relevance to the search query.
" }, "metadata":{ "shape":"MetadataMap", "documentation":"A map of metadata key-value pairs associated with a memory record.
" } }, "documentation":"Contains summary information about a memory record.
" }, "MemoryRecordSummaryList":{ "type":"list", "member":{"shape":"MemoryRecordSummary"} }, "MemoryRecordUpdateInput":{ "type":"structure", "required":[ "memoryRecordId", "timestamp" ], "members":{ "memoryRecordId":{ "shape":"MemoryRecordId", "documentation":"The unique ID of the memory record to be updated.
" }, "timestamp":{ "shape":"Timestamp", "documentation":"Time at which the memory record was updated
" }, "content":{ "shape":"MemoryContent", "documentation":"The content to be stored within the memory record.
" }, "namespaces":{ "shape":"NamespacesList", "documentation":"The updated list of namespace identifiers for categorizing the memory record.
" }, "memoryStrategyId":{ "shape":"MemoryStrategyId", "documentation":"The updated ID of the memory strategy that defines how this memory record is grouped.
" } }, "documentation":"Input structure to update an existing memory record.
" }, "MemoryRecordsCreateInputList":{ "type":"list", "member":{"shape":"MemoryRecordCreateInput"}, "max":100, "min":0 }, "MemoryRecordsDeleteInputList":{ "type":"list", "member":{"shape":"MemoryRecordDeleteInput"}, "max":100, "min":0 }, "MemoryRecordsOutputList":{ "type":"list", "member":{"shape":"MemoryRecordOutput"} }, "MemoryRecordsUpdateInputList":{ "type":"list", "member":{"shape":"MemoryRecordUpdateInput"}, "max":100, "min":0 }, "MemoryStrategyId":{ "type":"string", "max":100, "min":1, "pattern":"[a-zA-Z0-9][a-zA-Z0-9-_]*" }, "MessageMetadata":{ "type":"structure", "required":[ "eventId", "messageIndex" ], "members":{ "eventId":{ "shape":"String", "documentation":"The identifier of the event associated with this message.
" }, "messageIndex":{ "shape":"Integer", "documentation":"The position of this message within that event’s ordered list of messages.
" } }, "documentation":"Metadata information associated with this message.
" }, "MessagesList":{ "type":"list", "member":{"shape":"MessageMetadata"} }, "MetadataKey":{ "type":"string", "max":128, "min":1, "pattern":"[a-zA-Z0-9\\s._:/=+@-]*" }, "MetadataMap":{ "type":"map", "key":{"shape":"MetadataKey"}, "value":{"shape":"MetadataValue"}, "max":15, "min":0 }, "MetadataValue":{ "type":"structure", "members":{ "stringValue":{ "shape":"MetadataValueStringValueString", "documentation":"Value associated with the eventMetadata key.
Value associated with the eventMetadata key.
The conversational content of the payload.
" }, "blob":{ "shape":"Document", "documentation":"The binary content of the payload.
" } }, "documentation":"Contains the payload content for an event.
", "union":true }, "PayloadTypeList":{ "type":"list", "member":{"shape":"PayloadType"}, "max":100, "min":0 }, "ProgrammingLanguage":{ "type":"string", "enum":[ "python", "javascript", "typescript" ] }, "RequestIdentifier":{ "type":"string", "max":80, "min":1, "pattern":"[a-zA-Z0-9_-]+" }, "RequestUri":{ "type":"string", "max":1024, "min":1, "pattern":"urn:ietf:params:oauth:request_uri:[a-zA-Z0-9-._~]+" }, "ResourceContent":{ "type":"structure", "required":["type"], "members":{ "type":{ "shape":"ResourceContentType", "documentation":"The type of resource content.
" }, "uri":{ "shape":"String", "documentation":"The URI of the resource content.
" }, "mimeType":{ "shape":"String", "documentation":"The MIME type of the resource content.
" }, "text":{ "shape":"String", "documentation":"The text resource content.
" }, "blob":{ "shape":"Blob", "documentation":"The binary resource content.
" } }, "documentation":"Contains information about resource content.
" }, "ResourceContentType":{ "type":"string", "enum":[ "text", "blob" ] }, "ResourceLocation":{ "type":"structure", "members":{ "s3":{ "shape":"S3Location", "documentation":"The Amazon S3 location of the resource. Use this when the resource is stored in an Amazon S3 bucket.
" } }, "documentation":"The location of the browser extension.
", "union":true }, "ResourceNotFoundException":{ "type":"structure", "members":{ "message":{"shape":"NonBlankString"} }, "documentation":"The exception that occurs when the specified resource does not exist. This can happen when using an invalid identifier or when trying to access a resource that has been deleted.
", "error":{ "httpStatusCode":404, "senderFault":true }, "exception":true }, "ResourceOauth2ReturnUrlType":{ "type":"string", "max":2048, "min":1, "pattern":"\\w+:(\\/?\\/?)[^\\s]+" }, "ResponseStream":{ "type":"blob", "sensitive":true, "streaming":true }, "RetrieveMemoryRecordsInput":{ "type":"structure", "required":[ "memoryId", "namespace", "searchCriteria" ], "members":{ "memoryId":{ "shape":"MemoryId", "documentation":"The identifier of the AgentCore Memory resource from which to retrieve memory records.
", "location":"uri", "locationName":"memoryId" }, "namespace":{ "shape":"Namespace", "documentation":"The namespace to filter memory records by.
" }, "searchCriteria":{ "shape":"SearchCriteria", "documentation":"The search criteria to use for finding relevant memory records. This includes the search query, memory strategy ID, and other search parameters.
" }, "nextToken":{ "shape":"PaginationToken", "documentation":"The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
" }, "maxResults":{ "shape":"MaxResults", "documentation":"The maximum number of results to return in a single call. The default value is 20.
" } } }, "RetrieveMemoryRecordsOutput":{ "type":"structure", "required":["memoryRecordSummaries"], "members":{ "memoryRecordSummaries":{ "shape":"MemoryRecordSummaryList", "documentation":"The list of memory record summaries that match the search criteria, ordered by relevance.
" }, "nextToken":{ "shape":"PaginationToken", "documentation":"The token to use in a subsequent request to get the next set of results. This value is null when there are no more results to return.
" } } }, "RetryableConflictException":{ "type":"structure", "required":["message"], "members":{ "message":{"shape":"String"} }, "documentation":"The exception that occurs when there is a retryable conflict performing an operation. This is a temporary condition that may resolve itself with retries. We recommend implementing exponential backoff retry logic in your application.
", "error":{ "httpStatusCode":409, "senderFault":true }, "exception":true, "retryable":{"throttling":false} }, "RightExpression":{ "type":"structure", "members":{ "metadataValue":{ "shape":"MetadataValue", "documentation":"Value associated with the key in eventMetadata.
Right expression of the eventMetadatafilter.
The exception that occurs when there is an error in the runtime client. This can happen due to network issues, invalid configuration, or other client-side problems. Check the error message for specific details about the error.
", "error":{ "httpStatusCode":424, "senderFault":true }, "exception":true }, "S3Location":{ "type":"structure", "required":[ "bucket", "prefix" ], "members":{ "bucket":{ "shape":"S3LocationBucketString", "documentation":"The name of the Amazon S3 bucket where the resource is stored.
" }, "prefix":{ "shape":"S3LocationPrefixString", "documentation":"The name of the Amazon S3 prefix/key where the resource is stored.
" }, "versionId":{ "shape":"S3LocationVersionIdString", "documentation":"The name of the Amazon S3 version ID where the resource is stored (Optional).
" } }, "documentation":"The Amazon S3 location configuration of a resource.
" }, "S3LocationBucketString":{ "type":"string", "max":63, "min":3, "pattern":"[a-z0-9][a-z0-9.-]*[a-z0-9]" }, "S3LocationPrefixString":{ "type":"string", "max":1024, "min":1 }, "S3LocationVersionIdString":{ "type":"string", "max":1024, "min":1 }, "ScopeType":{ "type":"string", "max":128, "min":1 }, "ScopesListType":{ "type":"list", "member":{"shape":"ScopeType"} }, "SearchCriteria":{ "type":"structure", "required":["searchQuery"], "members":{ "searchQuery":{ "shape":"SearchCriteriaSearchQueryString", "documentation":"The search query to use for finding relevant memory records.
" }, "memoryStrategyId":{ "shape":"MemoryStrategyId", "documentation":"The memory strategy identifier to filter memory records by.
" }, "topK":{ "shape":"SearchCriteriaTopKInteger", "documentation":"The maximum number of top-scoring memory records to return. This value is used for semantic search ranking.
" }, "metadataFilters":{ "shape":"MemoryMetadataFilterList", "documentation":"Filters to apply to metadata associated with a memory.
" } }, "documentation":"Contains search criteria for retrieving memory records.
" }, "SearchCriteriaSearchQueryString":{ "type":"string", "max":10000, "min":1, "sensitive":true }, "SearchCriteriaTopKInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ServiceException":{ "type":"structure", "required":["message"], "members":{ "message":{"shape":"String"} }, "documentation":"The service encountered an internal error. Try your request again later.
", "error":{"httpStatusCode":500}, "exception":true, "fault":true }, "ServiceQuotaExceededException":{ "type":"structure", "members":{ "message":{"shape":"NonBlankString"} }, "documentation":"The exception that occurs when the request would cause a service quota to be exceeded. Review your service quotas and either reduce your request rate or request a quota increase.
", "error":{ "httpStatusCode":402, "senderFault":true }, "exception":true }, "SessionId":{ "type":"string", "max":100, "min":1, "pattern":"[a-zA-Z0-9][a-zA-Z0-9-_]*" }, "SessionStatus":{ "type":"string", "enum":[ "IN_PROGRESS", "FAILED" ] }, "SessionSummary":{ "type":"structure", "required":[ "sessionId", "actorId", "createdAt" ], "members":{ "sessionId":{ "shape":"SessionId", "documentation":"The unique identifier of the session.
" }, "actorId":{ "shape":"ActorId", "documentation":"The identifier of the actor associated with the session.
" }, "createdAt":{ "shape":"Timestamp", "documentation":"The timestamp when the session was created.
" } }, "documentation":"Contains summary information about a session in an AgentCore Memory resource.
" }, "SessionSummaryList":{ "type":"list", "member":{"shape":"SessionSummary"} }, "SessionType":{ "type":"string", "max":256, "min":33 }, "Span":{ "type":"structure", "members":{}, "document":true }, "SpanContext":{ "type":"structure", "required":["sessionId"], "members":{ "sessionId":{ "shape":"String", "documentation":" The unique identifier of the session containing this span. Sessions represent complete conversation flows and are detected using configurable SessionTimeoutMinutes (default 15 minutes).
The unique identifier of the trace containing this span. Traces represent individual request-response interactions within a session and group related spans together.
" }, "spanId":{ "shape":"String", "documentation":"The unique identifier of the specific span being referenced. Spans represent individual operations like tool calls, model invocations, or other discrete actions within the agent's execution.
" } }, "documentation":"The contextual information that uniquely identifies a span within the distributed tracing system. Contains session, trace, and span identifiers used to correlate evaluation results with specific agent execution points.
" }, "SpanId":{ "type":"string", "max":16, "min":16 }, "SpanIds":{ "type":"list", "member":{"shape":"SpanId"}, "max":10, "min":1 }, "Spans":{ "type":"list", "member":{"shape":"Span"}, "max":1000, "min":1, "sensitive":true }, "StartBrowserSessionRequest":{ "type":"structure", "required":["browserIdentifier"], "members":{ "traceId":{ "shape":"StartBrowserSessionRequestTraceIdString", "documentation":"The trace identifier for request tracking.
", "location":"header", "locationName":"X-Amzn-Trace-Id" }, "traceParent":{ "shape":"StartBrowserSessionRequestTraceParentString", "documentation":"The parent trace information for distributed tracing.
", "location":"header", "locationName":"traceparent" }, "browserIdentifier":{ "shape":"String", "documentation":"The unique identifier of the browser to use for this session. This identifier specifies which browser environment to initialize for the session.
", "location":"uri", "locationName":"browserIdentifier" }, "name":{ "shape":"Name", "documentation":"The name of the browser session. This name helps you identify and manage the session. The name does not need to be unique.
" }, "sessionTimeoutSeconds":{ "shape":"BrowserSessionTimeout", "documentation":"The time in seconds after which the session automatically terminates if there is no activity. The default value is 3600 seconds (1 hour). The minimum allowed value is 60 seconds, and the maximum allowed value is 28800 seconds (8 hours).
" }, "viewPort":{ "shape":"ViewPort", "documentation":"The dimensions of the browser viewport for this session. This determines the visible area of the web content and affects how web pages are rendered. If not specified, Amazon Bedrock uses a default viewport size.
" }, "extensions":{ "shape":"BrowserExtensions", "documentation":"A list of browser extensions to load into the browser session.
" }, "clientToken":{ "shape":"ClientToken", "documentation":"A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error. This parameter helps prevent the creation of duplicate sessions if there are temporary network issues.
", "idempotencyToken":true } } }, "StartBrowserSessionRequestTraceIdString":{ "type":"string", "max":1024, "min":0 }, "StartBrowserSessionRequestTraceParentString":{ "type":"string", "max":1024, "min":0 }, "StartBrowserSessionResponse":{ "type":"structure", "required":[ "browserIdentifier", "sessionId", "createdAt" ], "members":{ "browserIdentifier":{ "shape":"String", "documentation":"The identifier of the browser.
" }, "sessionId":{ "shape":"BrowserSessionId", "documentation":"The unique identifier of the created browser session.
" }, "createdAt":{ "shape":"DateTimestamp", "documentation":"The timestamp when the browser session was created.
" }, "streams":{ "shape":"BrowserSessionStream", "documentation":"The streams associated with this browser session. These include the automation stream and live view stream.
" } } }, "StartCodeInterpreterSessionRequest":{ "type":"structure", "required":["codeInterpreterIdentifier"], "members":{ "traceId":{ "shape":"StartCodeInterpreterSessionRequestTraceIdString", "documentation":"The trace identifier for request tracking.
", "location":"header", "locationName":"X-Amzn-Trace-Id" }, "traceParent":{ "shape":"StartCodeInterpreterSessionRequestTraceParentString", "documentation":"The parent trace information for distributed tracing.
", "location":"header", "locationName":"traceparent" }, "codeInterpreterIdentifier":{ "shape":"String", "documentation":"The unique identifier of the code interpreter to use for this session. This identifier specifies which code interpreter environment to initialize for the session.
", "location":"uri", "locationName":"codeInterpreterIdentifier" }, "name":{ "shape":"Name", "documentation":"The name of the code interpreter session. This name helps you identify and manage the session. The name does not need to be unique.
" }, "sessionTimeoutSeconds":{ "shape":"CodeInterpreterSessionTimeout", "documentation":"The time in seconds after which the session automatically terminates if there is no activity. The default value is 900 seconds (15 minutes). The minimum allowed value is 60 seconds, and the maximum allowed value is 28800 seconds (8 hours).
" }, "clientToken":{ "shape":"ClientToken", "documentation":"A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error. This parameter helps prevent the creation of duplicate sessions if there are temporary network issues.
", "idempotencyToken":true } } }, "StartCodeInterpreterSessionRequestTraceIdString":{ "type":"string", "max":1024, "min":0 }, "StartCodeInterpreterSessionRequestTraceParentString":{ "type":"string", "max":1024, "min":0 }, "StartCodeInterpreterSessionResponse":{ "type":"structure", "required":[ "codeInterpreterIdentifier", "sessionId", "createdAt" ], "members":{ "codeInterpreterIdentifier":{ "shape":"String", "documentation":"The identifier of the code interpreter.
" }, "sessionId":{ "shape":"CodeInterpreterSessionId", "documentation":"The unique identifier of the created code interpreter session.
" }, "createdAt":{ "shape":"DateTimestamp", "documentation":"The time at which the code interpreter session was created.
" } } }, "StartMemoryExtractionJobInput":{ "type":"structure", "required":[ "memoryId", "extractionJob" ], "members":{ "memoryId":{ "shape":"MemoryId", "documentation":"The unique identifier of the memory for which to start extraction jobs.
", "location":"uri", "locationName":"memoryId" }, "extractionJob":{ "shape":"ExtractionJob", "documentation":"Extraction job to start in this operation.
" }, "clientToken":{ "shape":"String", "documentation":"A unique, case-sensitive identifier to ensure idempotent processing of the request.
", "idempotencyToken":true } } }, "StartMemoryExtractionJobOutput":{ "type":"structure", "required":["jobId"], "members":{ "jobId":{ "shape":"String", "documentation":"Extraction Job ID that was attempted to start.
" } } }, "State":{ "type":"string", "max":4096, "min":1, "sensitive":true }, "StopBrowserSessionRequest":{ "type":"structure", "required":[ "browserIdentifier", "sessionId" ], "members":{ "traceId":{ "shape":"StopBrowserSessionRequestTraceIdString", "documentation":"The trace identifier for request tracking.
", "location":"header", "locationName":"X-Amzn-Trace-Id" }, "traceParent":{ "shape":"StopBrowserSessionRequestTraceParentString", "documentation":"The parent trace information for distributed tracing.
", "location":"header", "locationName":"traceparent" }, "browserIdentifier":{ "shape":"String", "documentation":"The unique identifier of the browser associated with the session.
", "location":"uri", "locationName":"browserIdentifier" }, "sessionId":{ "shape":"BrowserSessionId", "documentation":"The unique identifier of the browser session to stop.
", "location":"querystring", "locationName":"sessionId" }, "clientToken":{ "shape":"ClientToken", "documentation":"A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error.
", "idempotencyToken":true } } }, "StopBrowserSessionRequestTraceIdString":{ "type":"string", "max":1024, "min":0 }, "StopBrowserSessionRequestTraceParentString":{ "type":"string", "max":1024, "min":0 }, "StopBrowserSessionResponse":{ "type":"structure", "required":[ "browserIdentifier", "sessionId", "lastUpdatedAt" ], "members":{ "browserIdentifier":{ "shape":"String", "documentation":"The identifier of the browser.
" }, "sessionId":{ "shape":"BrowserSessionId", "documentation":"The identifier of the browser session.
" }, "lastUpdatedAt":{ "shape":"DateTimestamp", "documentation":"The time at which the browser session was last updated.
" } } }, "StopCodeInterpreterSessionRequest":{ "type":"structure", "required":[ "codeInterpreterIdentifier", "sessionId" ], "members":{ "traceId":{ "shape":"StopCodeInterpreterSessionRequestTraceIdString", "documentation":"The trace identifier for request tracking.
", "location":"header", "locationName":"X-Amzn-Trace-Id" }, "traceParent":{ "shape":"StopCodeInterpreterSessionRequestTraceParentString", "documentation":"The parent trace information for distributed tracing.
", "location":"header", "locationName":"traceparent" }, "codeInterpreterIdentifier":{ "shape":"String", "documentation":"The unique identifier of the code interpreter associated with the session.
", "location":"uri", "locationName":"codeInterpreterIdentifier" }, "sessionId":{ "shape":"CodeInterpreterSessionId", "documentation":"The unique identifier of the code interpreter session to stop.
", "location":"querystring", "locationName":"sessionId" }, "clientToken":{ "shape":"ClientToken", "documentation":"A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error.
", "idempotencyToken":true } } }, "StopCodeInterpreterSessionRequestTraceIdString":{ "type":"string", "max":1024, "min":0 }, "StopCodeInterpreterSessionRequestTraceParentString":{ "type":"string", "max":1024, "min":0 }, "StopCodeInterpreterSessionResponse":{ "type":"structure", "required":[ "codeInterpreterIdentifier", "sessionId", "lastUpdatedAt" ], "members":{ "codeInterpreterIdentifier":{ "shape":"String", "documentation":"The identifier of the code interpreter.
" }, "sessionId":{ "shape":"CodeInterpreterSessionId", "documentation":"The identifier of the code interpreter session.
" }, "lastUpdatedAt":{ "shape":"DateTimestamp", "documentation":"The timestamp when the code interpreter session was last updated.
" } } }, "StopRuntimeSessionRequest":{ "type":"structure", "required":[ "runtimeSessionId", "agentRuntimeArn" ], "members":{ "runtimeSessionId":{ "shape":"SessionType", "documentation":"The ID of the session that you want to stop.
", "location":"header", "locationName":"X-Amzn-Bedrock-AgentCore-Runtime-Session-Id" }, "agentRuntimeArn":{ "shape":"String", "documentation":"The ARN of the agent that contains the session that you want to stop.
", "location":"uri", "locationName":"agentRuntimeArn" }, "qualifier":{ "shape":"String", "documentation":"Optional qualifier to specify an agent alias, such as prodcode> or dev. If you don't provide a value, the DEFAULT alias is used.
Idempotent token used to identify the request. If you use the same token with multiple requests, the same response is returned. Use ClientToken to prevent the same request from being processed more than once.
", "idempotencyToken":true } } }, "StopRuntimeSessionResponse":{ "type":"structure", "members":{ "runtimeSessionId":{ "shape":"SessionId", "documentation":"The ID of the session that you requested to stop.
", "location":"header", "locationName":"X-Amzn-Bedrock-AgentCore-Runtime-Session-Id" }, "statusCode":{ "shape":"HttpResponseCode", "documentation":"The status code of the request to stop the session.
", "location":"statusCode" } } }, "StreamUpdate":{ "type":"structure", "members":{ "automationStreamUpdate":{ "shape":"AutomationStreamUpdate", "documentation":"The update to an automation stream.
" } }, "documentation":"Contains information about an update to a stream.
", "union":true }, "String":{"type":"string"}, "StringList":{ "type":"list", "member":{"shape":"MaxLenString"} }, "StringType":{ "type":"string", "max":1024, "min":1 }, "TaskStatus":{ "type":"string", "enum":[ "submitted", "working", "completed", "canceled", "failed" ] }, "ThrottledException":{ "type":"structure", "required":["message"], "members":{ "message":{"shape":"String"} }, "documentation":"The request was denied due to request throttling. Reduce the frequency of requests and try again.
", "error":{ "httpStatusCode":429, "senderFault":true }, "exception":true }, "ThrottlingException":{ "type":"structure", "members":{ "message":{"shape":"NonBlankString"} }, "documentation":"The exception that occurs when the request was denied due to request throttling. This happens when you exceed the allowed request rate for an operation. Reduce the frequency of requests or implement exponential backoff retry logic in your application.
", "error":{ "httpStatusCode":429, "senderFault":true }, "exception":true }, "Timestamp":{"type":"timestamp"}, "TokenUsage":{ "type":"structure", "members":{ "inputTokens":{ "shape":"Integer", "documentation":"The number of tokens consumed for input processing during the evaluation. Includes tokens from the evaluation prompt, agent traces, and any additional context provided to the evaluator model.
" }, "outputTokens":{ "shape":"Integer", "documentation":"The number of tokens generated by the evaluator model in its response. Includes tokens for the score, explanation, and any additional output produced during the evaluation process.
" }, "totalTokens":{ "shape":"Integer", "documentation":"The total number of tokens consumed during the evaluation, calculated as the sum of input and output tokens. Used for cost calculation and rate limiting within the service limits.
" } }, "documentation":"The token consumption statistics for language model operations during evaluation. Provides detailed breakdown of input, output, and total tokens used for cost tracking and performance monitoring.
" }, "ToolArguments":{ "type":"structure", "members":{ "code":{ "shape":"MaxLenString", "documentation":"The code to execute in a code interpreter session. This is the source code in the specified programming language that will be executed by the code interpreter.
" }, "language":{ "shape":"ProgrammingLanguage", "documentation":"The programming language of the code to execute. This tells the code interpreter which language runtime to use for execution. Common values include 'python', 'javascript', and 'r'.
" }, "clearContext":{ "shape":"Boolean", "documentation":"Whether to clear the context for the tool.
" }, "command":{ "shape":"MaxLenString", "documentation":"The command to execute with the tool.
" }, "path":{ "shape":"MaxLenString", "documentation":"The path for the tool operation.
" }, "paths":{ "shape":"StringList", "documentation":"The paths for the tool operation.
" }, "content":{ "shape":"InputContentBlockList", "documentation":"The content for the tool operation.
" }, "directoryPath":{ "shape":"MaxLenString", "documentation":"The directory path for the tool operation.
" }, "taskId":{ "shape":"MaxLenString", "documentation":"The identifier of the task for the tool operation.
" } }, "documentation":"The collection of arguments that specify the operation to perform and its parameters when invoking a tool in Amazon Bedrock. Different tools require different arguments, and this structure provides a flexible way to pass the appropriate arguments to each tool type.
" }, "ToolName":{ "type":"string", "enum":[ "executeCode", "executeCommand", "readFiles", "listFiles", "removeFiles", "writeFiles", "startCommandExecution", "getTask", "stopTask" ] }, "ToolResultStructuredContent":{ "type":"structure", "members":{ "taskId":{ "shape":"String", "documentation":"The identifier of the task that produced the result.
" }, "taskStatus":{ "shape":"TaskStatus", "documentation":"The status of the task that produced the result.
" }, "stdout":{ "shape":"String", "documentation":"The standard output from the tool execution.
" }, "stderr":{ "shape":"String", "documentation":"The standard error output from the tool execution.
" }, "exitCode":{ "shape":"Integer", "documentation":"The exit code from the tool execution.
" }, "executionTime":{ "shape":"Double", "documentation":"The execution time of the tool operation in milliseconds.
" } }, "documentation":"Contains structured content from a tool result.
" }, "TraceId":{ "type":"string", "max":32, "min":32 }, "TraceIds":{ "type":"list", "member":{"shape":"TraceId"}, "max":10, "min":1 }, "UnauthorizedException":{ "type":"structure", "members":{ "message":{"shape":"NonBlankString"} }, "documentation":"This exception is thrown when the JWT bearer token is invalid or not found for OAuth bearer token based access
", "error":{ "httpStatusCode":401, "senderFault":true }, "exception":true }, "UpdateBrowserStreamRequest":{ "type":"structure", "required":[ "browserIdentifier", "sessionId", "streamUpdate" ], "members":{ "browserIdentifier":{ "shape":"String", "documentation":"The identifier of the browser.
", "location":"uri", "locationName":"browserIdentifier" }, "sessionId":{ "shape":"BrowserSessionId", "documentation":"The identifier of the browser session.
", "location":"querystring", "locationName":"sessionId" }, "streamUpdate":{ "shape":"StreamUpdate", "documentation":"The update to apply to the browser stream.
" }, "clientToken":{ "shape":"ClientToken", "documentation":"A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error.
", "idempotencyToken":true } } }, "UpdateBrowserStreamResponse":{ "type":"structure", "required":[ "browserIdentifier", "sessionId", "streams", "updatedAt" ], "members":{ "browserIdentifier":{ "shape":"String", "documentation":"The identifier of the browser.
" }, "sessionId":{ "shape":"BrowserSessionId", "documentation":"The identifier of the browser session.
" }, "streams":{"shape":"BrowserSessionStream"}, "updatedAt":{ "shape":"DateTimestamp", "documentation":"The time at which the browser stream was updated.
" } } }, "UserIdType":{ "type":"string", "max":128, "min":1 }, "UserIdentifier":{ "type":"structure", "members":{ "userToken":{ "shape":"UserTokenType", "documentation":"The OAuth2.0 token issued by the user’s identity provider
" }, "userId":{ "shape":"UserIdType", "documentation":"The ID of the user for whom you have retrieved a workload access token for
" } }, "documentation":"The OAuth2.0 token or user ID that was used to generate the workload access token used for initiating the user authorization flow to retrieve OAuth2.0 tokens.
", "union":true }, "UserTokenType":{ "type":"string", "max":131072, "min":1, "pattern":"[A-Za-z0-9-_=]+.[A-Za-z0-9-_=]+.[A-Za-z0-9-_=]+", "sensitive":true }, "ValidationException":{ "type":"structure", "required":[ "message", "reason" ], "members":{ "message":{"shape":"String"}, "reason":{"shape":"ValidationExceptionReason"}, "fieldList":{"shape":"ValidationExceptionFieldList"} }, "documentation":"The exception that occurs when the input fails to satisfy the constraints specified by the service. Check the error message for details about which input parameter is invalid and correct your request.
", "error":{ "httpStatusCode":400, "senderFault":true }, "exception":true }, "ValidationExceptionField":{ "type":"structure", "required":[ "name", "message" ], "members":{ "name":{ "shape":"String", "documentation":"The name of the field.
" }, "message":{ "shape":"String", "documentation":"A message describing why this field failed validation.
" } }, "documentation":"Stores information about a field passed inside a request that resulted in an exception.
" }, "ValidationExceptionFieldList":{ "type":"list", "member":{"shape":"ValidationExceptionField"} }, "ValidationExceptionReason":{ "type":"string", "enum":[ "CannotParse", "FieldValidationFailed", "IdempotentParameterMismatchException", "EventInOtherSession", "ResourceConflict" ] }, "ViewPort":{ "type":"structure", "required":[ "width", "height" ], "members":{ "width":{ "shape":"ViewPortWidth", "documentation":"The width of the viewport in pixels. This value determines the horizontal dimension of the visible area. Valid values range from 800 to 1920 pixels.
" }, "height":{ "shape":"ViewPortHeight", "documentation":"The height of the viewport in pixels. This value determines the vertical dimension of the visible area. Valid values range from 600 to 1080 pixels.
" } }, "documentation":"The configuration that defines the dimensions of a browser viewport in a browser session. The viewport determines the visible area of web content and affects how web pages are rendered and displayed. Proper viewport configuration ensures that web content is displayed correctly for the agent's browsing tasks.
" }, "ViewPortHeight":{ "type":"integer", "box":true, "max":2160, "min":240 }, "ViewPortWidth":{ "type":"integer", "box":true, "max":3840, "min":320 }, "WorkloadIdentityNameType":{ "type":"string", "max":255, "min":3, "pattern":"[A-Za-z0-9_.-]+" }, "WorkloadIdentityTokenType":{ "type":"string", "max":131072, "min":1, "sensitive":true } }, "documentation":"Welcome to the Amazon Bedrock AgentCore Data Plane API reference. Data Plane actions process and handle data or workloads within Amazon Web Services services.
" }