Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1465766489.0 KB

Operation to invoke a Harness.

post/harnesses/invoke#harnessArn&X-Amzn-Bedrock-AgentCore-Runtime-Session-Id

Query parameters

harnessArnstring required

The ARN of the harness to invoke.

qualifierstring

The endpoint name to invoke. If omitted, the DEFAULT endpoint is used.

Headers

X-Amzn-Bedrock-AgentCore-Runtime-Session-Idstring required

The session ID for the invocation. Use the same session ID across requests to continue a conversation.

X-Amzn-Bedrock-AgentCore-Runtime-User-Idstring

An identifier for the end user making the request. This value is passed through to the runtime container.

Request body

allowedToolsHarnessAllowedTool[]

The tools that the agent is allowed to use for this invocation. If specified, overrides the harness default.

maxIterationsinteger

The maximum number of iterations the agent loop can execute. If specified, overrides the harness default.

maxTokensinteger

The maximum number of tokens the agent can generate per iteration. If specified, overrides the harness default.

timeoutSecondsinteger

The maximum duration in seconds for the agent loop execution. If specified, overrides the harness default.

actorIdstring

The actor ID for memory operations. Overrides the actor ID configured on the harness.

Response

Success