v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141531,219979.8 KB

Operation to create a harness.

post/harnesses

Request body

harnessNamestring required

The name of the harness. Must start with a letter and contain only alphanumeric characters and underscores.

clientTokenstring

A unique, case-sensitive identifier to ensure idempotency of the request.

executionRoleArnstring required

The ARN of the IAM role that the harness assumes when running. This role must have permissions for the services the agent needs to access, such as Amazon Bedrock for model invocation.

environmentVariablesobject

Environment variables to set in the harness runtime environment.

allowedToolsHarnessAllowedTool[]

The tools that the agent is allowed to use. Supports glob patterns such as * for all tools, @builtin for all built-in tools, or @serverName/toolName for specific MCP server tools.

maxIterationsinteger

The maximum number of iterations the agent loop can execute per invocation.

maxTokensinteger

The maximum total number of output tokens the agent can generate across all model calls within a single invocation.

timeoutSecondsinteger

The maximum duration in seconds for the agent loop execution per invocation.

tagsobject

Tags to apply to the harness resource.

Response

Success