Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1492497398.3 KB

Creates a new pentest configuration in an agent space. A pentest defines the security test parameters, including target assets, risk type exclusions, and logging configuration.

post/CreatePentest

Request body

titlestring required

The title of the pentest.

agentSpaceIdstring required

The unique identifier of the agent space to create the pentest in.

excludeRiskTypesRiskType[]

The list of risk types to exclude from the pentest.

serviceRolestring

ARN of an IAM role that the service can assume to access customer resources.

codeRemediationStrategy'AUTOMATIC' | 'DISABLED'

Strategy for automated code remediation.

disableManagedSkillsSkillType[]

A list of skill types.

Response

Success

pentestIdstring

The unique identifier of the created pentest.

titlestring

The title of the pentest.

createdAtstring date-time

The date and time the pentest was created, in UTC format.

updatedAtstring date-time

The date and time the pentest was last updated, in UTC format.

excludeRiskTypesRiskType[]

The list of risk types excluded from the pentest.

serviceRolestring

The IAM service role used for the pentest.

agentSpaceIdstring

The unique identifier of the agent space that contains the pentest.