Uploads an artifact to an agent space. Artifacts provide additional context for security testing, such as architecture diagrams, API specifications, or configuration files.
" }, "BatchDeletePentests":{ "name":"BatchDeletePentests", "http":{ "method":"POST", "requestUri":"/BatchDeletePentests", "responseCode":200 }, "input":{"shape":"BatchDeletePentestsInput"}, "output":{"shape":"BatchDeletePentestsOutput"}, "documentation":"Deletes one or more pentests from an agent space.
" }, "BatchGetAgentSpaces":{ "name":"BatchGetAgentSpaces", "http":{ "method":"POST", "requestUri":"/BatchGetAgentSpaces", "responseCode":200 }, "input":{"shape":"BatchGetAgentSpacesInput"}, "output":{"shape":"BatchGetAgentSpacesOutput"}, "documentation":"Retrieves information about one or more agent spaces.
", "readonly":true }, "BatchGetArtifactMetadata":{ "name":"BatchGetArtifactMetadata", "http":{ "method":"POST", "requestUri":"/BatchGetArtifactMetadata", "responseCode":200 }, "input":{"shape":"BatchGetArtifactMetadataInput"}, "output":{"shape":"BatchGetArtifactMetadataOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"AccessDeniedException"} ], "documentation":"Retrieves metadata for one or more artifacts in an agent space.
" }, "BatchGetFindings":{ "name":"BatchGetFindings", "http":{ "method":"POST", "requestUri":"/BatchGetFindings", "responseCode":200 }, "input":{"shape":"BatchGetFindingsInput"}, "output":{"shape":"BatchGetFindingsOutput"}, "documentation":"Retrieves information about one or more security findings in an agent space.
" }, "BatchGetPentestJobTasks":{ "name":"BatchGetPentestJobTasks", "http":{ "method":"POST", "requestUri":"/BatchGetPentestJobTasks", "responseCode":200 }, "input":{"shape":"BatchGetPentestJobTasksInput"}, "output":{"shape":"BatchGetPentestJobTasksOutput"}, "documentation":"Retrieves information about one or more tasks within a pentest job.
" }, "BatchGetPentestJobs":{ "name":"BatchGetPentestJobs", "http":{ "method":"POST", "requestUri":"/BatchGetPentestJobs", "responseCode":200 }, "input":{"shape":"BatchGetPentestJobsInput"}, "output":{"shape":"BatchGetPentestJobsOutput"}, "documentation":"Retrieves information about one or more pentest jobs in an agent space.
" }, "BatchGetPentests":{ "name":"BatchGetPentests", "http":{ "method":"POST", "requestUri":"/BatchGetPentests", "responseCode":200 }, "input":{"shape":"BatchGetPentestsInput"}, "output":{"shape":"BatchGetPentestsOutput"}, "documentation":"Retrieves information about one or more pentests in an agent space.
" }, "BatchGetTargetDomains":{ "name":"BatchGetTargetDomains", "http":{ "method":"POST", "requestUri":"/BatchGetTargetDomains", "responseCode":200 }, "input":{"shape":"BatchGetTargetDomainsInput"}, "output":{"shape":"BatchGetTargetDomainsOutput"}, "documentation":"Retrieves information about one or more target domains.
", "readonly":true }, "CreateAgentSpace":{ "name":"CreateAgentSpace", "http":{ "method":"POST", "requestUri":"/CreateAgentSpace", "responseCode":200 }, "input":{"shape":"CreateAgentSpaceInput"}, "output":{"shape":"CreateAgentSpaceOutput"}, "documentation":"Creates a new agent space. An agent space is a dedicated workspace for securing a specific application.
" }, "CreateApplication":{ "name":"CreateApplication", "http":{ "method":"POST", "requestUri":"/CreateApplication", "responseCode":200 }, "input":{"shape":"CreateApplicationRequest"}, "output":{"shape":"CreateApplicationResponse"}, "documentation":"Creates a new application. An application is the top-level organizational unit that supports IAM Identity Center integration.
" }, "CreateIntegration":{ "name":"CreateIntegration", "http":{ "method":"POST", "requestUri":"/CreateIntegration", "responseCode":201 }, "input":{"shape":"CreateIntegrationInput"}, "output":{"shape":"CreateIntegrationOutput"}, "errors":[ {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerException"}, {"shape":"ValidationException"}, {"shape":"ConflictException"}, {"shape":"ThrottlingException"}, {"shape":"AccessDeniedException"} ], "documentation":"Creates a new integration with a third-party provider, such as GitHub, for code review and remediation.
" }, "CreateMembership":{ "name":"CreateMembership", "http":{ "method":"POST", "requestUri":"/CreateMembership", "responseCode":200 }, "input":{"shape":"CreateMembershipRequest"}, "output":{"shape":"CreateMembershipResponse"}, "documentation":"Creates a new membership, granting a user access to an agent space within an application.
" }, "CreatePentest":{ "name":"CreatePentest", "http":{ "method":"POST", "requestUri":"/CreatePentest", "responseCode":200 }, "input":{"shape":"CreatePentestInput"}, "output":{"shape":"CreatePentestOutput"}, "documentation":"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.
" }, "CreateTargetDomain":{ "name":"CreateTargetDomain", "http":{ "method":"POST", "requestUri":"/CreateTargetDomain", "responseCode":200 }, "input":{"shape":"CreateTargetDomainInput"}, "output":{"shape":"CreateTargetDomainOutput"}, "documentation":"Creates a new target domain for penetration testing. A target domain is a web domain that must be registered and verified before it can be tested.
" }, "DeleteAgentSpace":{ "name":"DeleteAgentSpace", "http":{ "method":"POST", "requestUri":"/DeleteAgentSpace", "responseCode":200 }, "input":{"shape":"DeleteAgentSpaceInput"}, "output":{"shape":"DeleteAgentSpaceOutput"}, "documentation":"Deletes an agent space and all of its associated resources, including pentests, findings, and artifacts.
", "idempotent":true }, "DeleteApplication":{ "name":"DeleteApplication", "http":{ "method":"POST", "requestUri":"/DeleteApplication", "responseCode":200 }, "input":{"shape":"DeleteApplicationRequest"}, "documentation":"Deletes an application and its associated configuration, including IAM Identity Center settings.
", "idempotent":true }, "DeleteArtifact":{ "name":"DeleteArtifact", "http":{ "method":"POST", "requestUri":"/DeleteArtifact", "responseCode":200 }, "input":{"shape":"DeleteArtifactInput"}, "output":{"shape":"DeleteArtifactOutput"}, "errors":[ {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"}, {"shape":"AccessDeniedException"} ], "documentation":"Deletes an artifact from an agent space.
" }, "DeleteIntegration":{ "name":"DeleteIntegration", "http":{ "method":"POST", "requestUri":"/DeleteIntegration", "responseCode":200 }, "input":{"shape":"DeleteIntegrationInput"}, "output":{"shape":"DeleteIntegrationOutput"}, "errors":[ {"shape":"ResourceNotFoundException"}, {"shape":"ValidationException"}, {"shape":"InternalServerException"}, {"shape":"ConflictException"}, {"shape":"ThrottlingException"}, {"shape":"AccessDeniedException"} ], "documentation":"Deletes an integration with a third-party provider.
", "idempotent":true }, "DeleteMembership":{ "name":"DeleteMembership", "http":{ "method":"POST", "requestUri":"/DeleteMembership", "responseCode":200 }, "input":{"shape":"DeleteMembershipRequest"}, "output":{"shape":"DeleteMembershipResponse"}, "documentation":"Deletes a membership, revoking a user's access to an agent space.
" }, "DeleteTargetDomain":{ "name":"DeleteTargetDomain", "http":{ "method":"POST", "requestUri":"/DeleteTargetDomain", "responseCode":200 }, "input":{"shape":"DeleteTargetDomainInput"}, "output":{"shape":"DeleteTargetDomainOutput"}, "documentation":"Deletes a target domain registration. After deletion, the domain can no longer be used for penetration testing.
", "idempotent":true }, "GetApplication":{ "name":"GetApplication", "http":{ "method":"POST", "requestUri":"/GetApplication", "responseCode":200 }, "input":{"shape":"GetApplicationRequest"}, "output":{"shape":"GetApplicationResponse"}, "documentation":"Retrieves information about an application.
", "readonly":true }, "GetArtifact":{ "name":"GetArtifact", "http":{ "method":"POST", "requestUri":"/GetArtifact", "responseCode":200 }, "input":{"shape":"GetArtifactInput"}, "output":{"shape":"GetArtifactOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"AccessDeniedException"} ], "documentation":"Retrieves an artifact from an agent space.
" }, "GetIntegration":{ "name":"GetIntegration", "http":{ "method":"POST", "requestUri":"/GetIntegration", "responseCode":200 }, "input":{"shape":"GetIntegrationInput"}, "output":{"shape":"GetIntegrationOutput"}, "errors":[ {"shape":"ResourceNotFoundException"}, {"shape":"ValidationException"}, {"shape":"InternalServerException"}, {"shape":"ThrottlingException"}, {"shape":"AccessDeniedException"} ], "documentation":"Retrieves information about an integration.
", "readonly":true }, "InitiateProviderRegistration":{ "name":"InitiateProviderRegistration", "http":{ "method":"POST", "requestUri":"/oauth2/provider/register", "responseCode":200 }, "input":{"shape":"InitiateProviderRegistrationInput"}, "output":{"shape":"InitiateProviderRegistrationOutput"}, "errors":[ {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerException"}, {"shape":"ValidationException"}, {"shape":"ConflictException"}, {"shape":"ThrottlingException"}, {"shape":"AccessDeniedException"} ], "documentation":"Initiates the OAuth registration flow with a third-party provider. Returns a redirect URL and CSRF state token for completing the authorization.
" }, "ListAgentSpaces":{ "name":"ListAgentSpaces", "http":{ "method":"POST", "requestUri":"/ListAgentSpaces", "responseCode":200 }, "input":{"shape":"ListAgentSpacesInput"}, "output":{"shape":"ListAgentSpacesOutput"}, "documentation":"Returns a paginated list of agent space summaries in your account.
", "readonly":true }, "ListApplications":{ "name":"ListApplications", "http":{ "method":"POST", "requestUri":"/ListApplications", "responseCode":200 }, "input":{"shape":"ListApplicationsRequest"}, "output":{"shape":"ListApplicationsResponse"}, "documentation":"Returns a paginated list of application summaries in your account.
", "readonly":true }, "ListArtifacts":{ "name":"ListArtifacts", "http":{ "method":"POST", "requestUri":"/ListArtifacts", "responseCode":200 }, "input":{"shape":"ListArtifactsInput"}, "output":{"shape":"ListArtifactsOutput"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"}, {"shape":"AccessDeniedException"} ], "documentation":"Returns a paginated list of artifact summaries for the specified agent space.
", "readonly":true }, "ListDiscoveredEndpoints":{ "name":"ListDiscoveredEndpoints", "http":{ "method":"POST", "requestUri":"/ListDiscoveredEndpoints", "responseCode":200 }, "input":{"shape":"ListDiscoveredEndpointsInput"}, "output":{"shape":"ListDiscoveredEndpointsOutput"}, "documentation":"Returns a paginated list of endpoints discovered during a pentest job execution.
" }, "ListFindings":{ "name":"ListFindings", "http":{ "method":"POST", "requestUri":"/ListFindings", "responseCode":200 }, "input":{"shape":"ListFindingsInput"}, "output":{"shape":"ListFindingsOutput"}, "documentation":"Lists the security findings for a pentest job.
" }, "ListIntegratedResources":{ "name":"ListIntegratedResources", "http":{ "method":"POST", "requestUri":"/ListIntegratedResources", "responseCode":200 }, "input":{"shape":"ListIntegratedResourcesInput"}, "output":{"shape":"ListIntegratedResourcesOutput"}, "errors":[ {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"}, {"shape":"AccessDeniedException"} ], "documentation":"Lists the integrated resources for an agent space, optionally filtered by integration or resource type.
" }, "ListIntegrations":{ "name":"ListIntegrations", "http":{ "method":"POST", "requestUri":"/ListIntegrations", "responseCode":200 }, "input":{"shape":"ListIntegrationsInput"}, "output":{"shape":"ListIntegrationsOutput"}, "errors":[ {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"}, {"shape":"AccessDeniedException"} ], "documentation":"Lists the integrations in your account, optionally filtered by provider or provider type.
", "readonly":true }, "ListMemberships":{ "name":"ListMemberships", "http":{ "method":"POST", "requestUri":"/ListMemberships", "responseCode":200 }, "input":{"shape":"ListMembershipsRequest"}, "output":{"shape":"ListMembershipsResponse"}, "documentation":"Returns a paginated list of membership summaries for the specified agent space within an application.
" }, "ListPentestJobTasks":{ "name":"ListPentestJobTasks", "http":{ "method":"POST", "requestUri":"/ListPentestJobTasks", "responseCode":200 }, "input":{"shape":"ListPentestJobTasksInput"}, "output":{"shape":"ListPentestJobTasksOutput"}, "documentation":"Returns a paginated list of task summaries for the specified pentest job, optionally filtered by step name or category.
" }, "ListPentestJobsForPentest":{ "name":"ListPentestJobsForPentest", "http":{ "method":"POST", "requestUri":"/ListPentestJobsForPentest", "responseCode":200 }, "input":{"shape":"ListPentestJobsForPentestInput"}, "output":{"shape":"ListPentestJobsForPentestOutput"}, "documentation":"Returns a paginated list of pentest job summaries for the specified pentest configuration.
" }, "ListPentests":{ "name":"ListPentests", "http":{ "method":"POST", "requestUri":"/ListPentests", "responseCode":200 }, "input":{"shape":"ListPentestsInput"}, "output":{"shape":"ListPentestsOutput"}, "documentation":"Returns a paginated list of pentest summaries for the specified agent space.
" }, "ListTagsForResource":{ "name":"ListTagsForResource", "http":{ "method":"GET", "requestUri":"/tags/{resourceArn}", "responseCode":200 }, "input":{"shape":"ListTagsForResourceInput"}, "output":{"shape":"ListTagsForResourceOutput"}, "documentation":"Returns the tags associated with the specified resource.
", "readonly":true }, "ListTargetDomains":{ "name":"ListTargetDomains", "http":{ "method":"POST", "requestUri":"/ListTargetDomains", "responseCode":200 }, "input":{"shape":"ListTargetDomainsInput"}, "output":{"shape":"ListTargetDomainsOutput"}, "documentation":"Returns a paginated list of target domain summaries in your account.
", "readonly":true }, "StartCodeRemediation":{ "name":"StartCodeRemediation", "http":{ "method":"POST", "requestUri":"/StartCodeRemediation", "responseCode":200 }, "input":{"shape":"StartCodeRemediationInput"}, "output":{"shape":"StartCodeRemediationOutput"}, "documentation":"Initiates code remediation for one or more security findings. This creates pull requests in integrated repositories to fix the identified vulnerabilities.
" }, "StartPentestJob":{ "name":"StartPentestJob", "http":{ "method":"POST", "requestUri":"/StartPentestJob", "responseCode":200 }, "input":{"shape":"StartPentestJobInput"}, "output":{"shape":"StartPentestJobOutput"}, "documentation":"Starts a new pentest job for a pentest configuration. The job executes the security tests defined in the pentest.
" }, "StopPentestJob":{ "name":"StopPentestJob", "http":{ "method":"POST", "requestUri":"/StopPentestJob", "responseCode":200 }, "input":{"shape":"StopPentestJobInput"}, "output":{"shape":"StopPentestJobOutput"}, "documentation":"Stops a running pentest job. The job transitions to a stopping state and then to stopped after cleanup completes.
" }, "TagResource":{ "name":"TagResource", "http":{ "method":"POST", "requestUri":"/tags/{resourceArn}", "responseCode":204 }, "input":{"shape":"TagResourceInput"}, "output":{"shape":"TagResourceOutput"}, "documentation":"Adds tags to a resource.
" }, "UntagResource":{ "name":"UntagResource", "http":{ "method":"DELETE", "requestUri":"/tags/{resourceArn}", "responseCode":204 }, "input":{"shape":"UntagResourceInput"}, "output":{"shape":"UntagResourceOutput"}, "documentation":"Removes tags from a resource.
", "idempotent":true }, "UpdateAgentSpace":{ "name":"UpdateAgentSpace", "http":{ "method":"POST", "requestUri":"/UpdateAgentSpace", "responseCode":200 }, "input":{"shape":"UpdateAgentSpaceInput"}, "output":{"shape":"UpdateAgentSpaceOutput"}, "documentation":"Updates the configuration of an existing agent space, including its name, description, AWS resources, target domains, and code review settings.
" }, "UpdateApplication":{ "name":"UpdateApplication", "http":{ "method":"POST", "requestUri":"/UpdateApplication", "responseCode":200 }, "input":{"shape":"UpdateApplicationRequest"}, "output":{"shape":"UpdateApplicationResponse"}, "documentation":"Updates the configuration of an existing application, including the IAM role and default KMS key.
", "idempotent":true }, "UpdateFinding":{ "name":"UpdateFinding", "http":{ "method":"POST", "requestUri":"/UpdateFinding", "responseCode":200 }, "input":{"shape":"UpdateFindingInput"}, "output":{"shape":"UpdateFindingOutput"}, "documentation":"Updates the status or risk level of a security finding.
" }, "UpdateIntegratedResources":{ "name":"UpdateIntegratedResources", "http":{ "method":"POST", "requestUri":"/UpdateIntegratedResources", "responseCode":200 }, "input":{"shape":"UpdateIntegratedResourcesInput"}, "output":{"shape":"UpdateIntegratedResourcesOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerException"}, {"shape":"ConflictException"}, {"shape":"ThrottlingException"}, {"shape":"AccessDeniedException"} ], "documentation":"Updates the integrated resources for an agent space, including their capabilities.
" }, "UpdatePentest":{ "name":"UpdatePentest", "http":{ "method":"POST", "requestUri":"/UpdatePentest", "responseCode":200 }, "input":{"shape":"UpdatePentestInput"}, "output":{"shape":"UpdatePentestOutput"}, "documentation":"Updates an existing pentest configuration.
" }, "UpdateTargetDomain":{ "name":"UpdateTargetDomain", "http":{ "method":"POST", "requestUri":"/UpdateTargetDomain", "responseCode":200 }, "input":{"shape":"UpdateTargetDomainInput"}, "output":{"shape":"UpdateTargetDomainOutput"}, "documentation":"Updates the verification method for a target domain.
" }, "VerifyTargetDomain":{ "name":"VerifyTargetDomain", "http":{ "method":"POST", "requestUri":"/VerifyTargetDomain", "responseCode":200 }, "input":{"shape":"VerifyTargetDomainInput"}, "output":{"shape":"VerifyTargetDomainOutput"}, "documentation":"Initiates verification of a target domain. This checks whether the domain ownership verification token has been properly configured.
" } }, "shapes":{ "AWSResources":{ "type":"structure", "members":{ "vpcs":{ "shape":"VpcConfigs", "documentation":"The VPC configurations associated with the agent space.
" }, "logGroups":{ "shape":"LogGroupArns", "documentation":"The Amazon Resource Names (ARNs) of the CloudWatch log groups associated with the agent space.
" }, "s3Buckets":{ "shape":"S3BucketArns", "documentation":"The Amazon Resource Names (ARNs) of the S3 buckets associated with the agent space.
" }, "secretArns":{ "shape":"SecretArns", "documentation":"The Amazon Resource Names (ARNs) of the Secrets Manager secrets associated with the agent space.
" }, "lambdaFunctionArns":{ "shape":"LambdaFunctionArns", "documentation":"The Amazon Resource Names (ARNs) of the Lambda functions associated with the agent space.
" }, "iamRoles":{ "shape":"IamRoles", "documentation":"The IAM roles associated with the agent space.
" } }, "documentation":"The AWS resources associated with an agent space, including VPCs, log groups, S3 buckets, secrets, Lambda functions, and IAM roles.
" }, "AccessDeniedException":{ "type":"structure", "required":["message"], "members":{ "message":{ "shape":"String", "documentation":"Error description.
" } }, "documentation":"You do not have sufficient access to perform this action.
", "error":{ "httpStatusCode":403, "senderFault":true }, "exception":true }, "AccessType":{ "type":"string", "documentation":"Defines the visibility level of provider resources. PRIVATE indicates restricted access, while PUBLIC indicates open access.
", "enum":[ "PRIVATE", "PUBLIC" ] }, "Actor":{ "type":"structure", "members":{ "identifier":{ "shape":"String", "documentation":"The unique identifier for the actor.
" }, "uris":{ "shape":"UriList", "documentation":"The list of URIs that the actor targets during testing.
" }, "authentication":{ "shape":"Authentication", "documentation":"The authentication configuration for the actor.
" }, "description":{ "shape":"String", "documentation":"A description of the actor.
" } }, "documentation":"Represents an actor used during penetration testing. An actor defines a user or entity that interacts with the target application, including authentication credentials and target URIs.
" }, "ActorList":{ "type":"list", "member":{"shape":"Actor"} }, "AddArtifactInput":{ "type":"structure", "required":[ "agentSpaceId", "artifactContent", "artifactType", "fileName" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the agent space to add the artifact to.
" }, "artifactContent":{ "shape":"Blob", "documentation":"The binary content of the artifact to upload.
" }, "artifactType":{ "shape":"ArtifactType", "documentation":"The file type of the artifact. Valid values include TXT, PNG, JPEG, MD, PDF, DOCX, DOC, JSON, and YAML.
" }, "fileName":{ "shape":"String", "documentation":"The file name of the artifact.
" } } }, "AddArtifactOutput":{ "type":"structure", "required":["artifactId"], "members":{ "artifactId":{ "shape":"ArtifactId", "documentation":"The unique identifier assigned to the uploaded artifact.
" } } }, "AgentName":{ "type":"string", "documentation":"Name of an agent space.
" }, "AgentSpace":{ "type":"structure", "required":[ "agentSpaceId", "name" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the agent space.
" }, "name":{ "shape":"String", "documentation":"The name of the agent space.
" }, "description":{ "shape":"String", "documentation":"A description of the agent space.
" }, "awsResources":{ "shape":"AWSResources", "documentation":"The AWS resources associated with the agent space.
" }, "targetDomainIds":{ "shape":"TargetDomainIdList", "documentation":"The list of target domain identifiers associated with the agent space.
" }, "codeReviewSettings":{ "shape":"CodeReviewSettings", "documentation":"The code review settings for the agent space.
" }, "kmsKeyId":{ "shape":"KmsKeyId", "documentation":"The identifier of the AWS KMS key used to encrypt data in the agent space.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the agent space was created, in UTC format.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the agent space was last updated, in UTC format.
" } }, "documentation":"Represents an agent space, which is a dedicated workspace for securing a specific application. An agent space contains the configuration, resources, and settings needed for security testing.
" }, "AgentSpaceId":{ "type":"string", "documentation":"Unique identifier of the agent space.
" }, "AgentSpaceIdList":{ "type":"list", "member":{"shape":"AgentSpaceId"} }, "AgentSpaceList":{ "type":"list", "member":{"shape":"AgentSpace"} }, "AgentSpaceSummary":{ "type":"structure", "required":[ "agentSpaceId", "name" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the agent space.
" }, "name":{ "shape":"String", "documentation":"The name of the agent space.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the agent space was created, in UTC format.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the agent space was last updated, in UTC format.
" } }, "documentation":"Contains summary information about an agent space.
" }, "AgentSpaceSummaryList":{ "type":"list", "member":{"shape":"AgentSpaceSummary"} }, "ApplicationDomain":{ "type":"string", "documentation":"Domain where the application is available.
" }, "ApplicationId":{ "type":"string", "documentation":"Application identifier.
" }, "ApplicationSummary":{ "type":"structure", "required":[ "applicationId", "applicationName", "domain" ], "members":{ "applicationId":{ "shape":"ApplicationId", "documentation":"The unique identifier of the application.
" }, "applicationName":{ "shape":"String", "documentation":"The name of the application.
" }, "domain":{ "shape":"ApplicationDomain", "documentation":"The domain associated with the application.
" }, "defaultKmsKeyId":{ "shape":"DefaultKmsKeyId", "documentation":"The identifier of the default AWS KMS key used to encrypt data for the application.
" } }, "documentation":"Contains summary information about an application.
" }, "ApplicationSummaryList":{ "type":"list", "member":{"shape":"ApplicationSummary"}, "documentation":"List of application summaries.
" }, "Artifact":{ "type":"structure", "required":[ "contents", "type" ], "members":{ "contents":{ "shape":"String", "documentation":"The content of the artifact.
" }, "type":{ "shape":"ArtifactType", "documentation":"The file type of the artifact.
" } }, "documentation":"Represents an artifact that provides context for security testing, such as documentation, diagrams, or configuration files.
" }, "ArtifactId":{ "type":"string", "documentation":"The id of the artifact.
" }, "ArtifactIds":{ "type":"list", "member":{"shape":"ArtifactId"} }, "ArtifactMetadataItem":{ "type":"structure", "required":[ "agentSpaceId", "artifactId", "fileName", "updatedAt" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the agent space that contains the artifact.
" }, "artifactId":{ "shape":"ArtifactId", "documentation":"The unique identifier of the artifact.
" }, "fileName":{ "shape":"String", "documentation":"The file name of the artifact.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the artifact was last updated, in UTC format.
" } }, "documentation":"Contains metadata about an artifact.
" }, "ArtifactMetadataList":{ "type":"list", "member":{"shape":"ArtifactMetadataItem"}, "documentation":"List of metadata objects containing artifacts details.
" }, "ArtifactSummary":{ "type":"structure", "required":[ "artifactId", "fileName", "artifactType" ], "members":{ "artifactId":{ "shape":"ArtifactId", "documentation":"The unique identifier of the artifact.
" }, "fileName":{ "shape":"String", "documentation":"The file name of the artifact.
" }, "artifactType":{ "shape":"ArtifactType", "documentation":"The file type of the artifact.
" } }, "documentation":"Contains summary information about an artifact.
" }, "ArtifactSummaryList":{ "type":"list", "member":{"shape":"ArtifactSummary"}, "documentation":"List of artifact summaries.
" }, "ArtifactType":{ "type":"string", "documentation":"Supported file extension types for artifacts.
", "enum":[ "TXT", "PNG", "JPEG", "MD", "PDF", "DOCX", "DOC", "JSON", "YAML" ] }, "Assets":{ "type":"structure", "members":{ "endpoints":{ "shape":"EndpointList", "documentation":"The list of endpoints to test during the pentest.
" }, "actors":{ "shape":"ActorList", "documentation":"The list of actors used during penetration testing.
" }, "documents":{ "shape":"DocumentList", "documentation":"The list of documents that provide context for the pentest.
" }, "sourceCode":{ "shape":"SourceCodeRepositoryList", "documentation":"The list of source code repositories to analyze during the pentest.
" }, "integratedRepositories":{ "shape":"IntegratedRepositoryList", "documentation":"The list of integrated repositories associated with the pentest.
" } }, "documentation":"The collection of assets used in a pentest configuration, including endpoints, actors, documents, source code repositories, and integrated repositories.
" }, "AuthCode":{ "type":"string", "documentation":"Authorization code from OAuth flow.
" }, "Authentication":{ "type":"structure", "members":{ "providerType":{ "shape":"AuthenticationProviderType", "documentation":"The type of authentication provider. Valid values include SECRETS_MANAGER, AWS_LAMBDA, AWS_IAM_ROLE, and AWS_INTERNAL.
" }, "value":{ "shape":"String", "documentation":"The authentication value, such as a secret ARN, Lambda function ARN, or IAM role ARN, depending on the provider type.
" } }, "documentation":"The authentication configuration for an actor, specifying the provider type and credentials.
" }, "AuthenticationProviderType":{ "type":"string", "documentation":"Type of authentication provider.
", "enum":[ "SECRETS_MANAGER", "AWS_LAMBDA", "AWS_IAM_ROLE", "AWS_INTERNAL" ] }, "BatchDeletePentestsInput":{ "type":"structure", "required":[ "pentestIds", "agentSpaceId" ], "members":{ "pentestIds":{ "shape":"PentestIdList", "documentation":"The list of pentest identifiers to delete.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space that contains the pentests to delete.
" } }, "documentation":"Input for deleting multiple pentests.
" }, "BatchDeletePentestsOutput":{ "type":"structure", "members":{ "deleted":{ "shape":"PentestList", "documentation":"The list of pentests that were successfully deleted.
" }, "failed":{ "shape":"DeletePentestFailureList", "documentation":"The list of pentests that failed to delete, including the reason for each failure.
" } }, "documentation":"Output for the BatchDeletePentests operation.
" }, "BatchGetAgentSpacesInput":{ "type":"structure", "required":["agentSpaceIds"], "members":{ "agentSpaceIds":{ "shape":"AgentSpaceIdList", "documentation":"The list of agent space identifiers to retrieve.
" } }, "documentation":"Input for batch retrieving agent spaces.
" }, "BatchGetAgentSpacesOutput":{ "type":"structure", "members":{ "agentSpaces":{ "shape":"AgentSpaceList", "documentation":"The list of agent spaces that were found.
" }, "notFound":{ "shape":"AgentSpaceIdList", "documentation":"The list of agent space identifiers that were not found.
" } }, "documentation":"Output for the BatchGetAgentSpaces operation.
" }, "BatchGetArtifactMetadataInput":{ "type":"structure", "required":[ "agentSpaceId", "artifactIds" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the agent space that contains the artifacts.
" }, "artifactIds":{ "shape":"ArtifactIds", "documentation":"The list of artifact identifiers to retrieve metadata for.
" } } }, "BatchGetArtifactMetadataOutput":{ "type":"structure", "required":["artifactMetadataList"], "members":{ "artifactMetadataList":{ "shape":"ArtifactMetadataList", "documentation":"The list of artifact metadata items that were found.
" } } }, "BatchGetFindingsInput":{ "type":"structure", "required":[ "findingIds", "agentSpaceId" ], "members":{ "findingIds":{ "shape":"FindingIdList", "documentation":"The list of finding identifiers to retrieve.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space that contains the findings.
" } }, "documentation":"Input for BatchGetFindings operation.
" }, "BatchGetFindingsOutput":{ "type":"structure", "members":{ "findings":{ "shape":"FindingList", "documentation":"The list of findings that were found.
" }, "notFound":{ "shape":"FindingIdList", "documentation":"The list of finding identifiers that were not found.
" } }, "documentation":"Output for the BatchGetFindings operation.
" }, "BatchGetPentestJobTasksInput":{ "type":"structure", "required":[ "agentSpaceId", "taskIds" ], "members":{ "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space that contains the tasks.
" }, "taskIds":{ "shape":"TaskIdList", "documentation":"The list of task identifiers to retrieve.
" } }, "documentation":"Input for retrieving multiple tasks associated with a pentest job.
" }, "BatchGetPentestJobTasksOutput":{ "type":"structure", "members":{ "tasks":{ "shape":"TaskList", "documentation":"The list of tasks that were found.
" }, "notFound":{ "shape":"TaskIdList", "documentation":"The list of task identifiers that were not found.
" } }, "documentation":"Output for the BatchGetPentestJobTasks operation.
" }, "BatchGetPentestJobsInput":{ "type":"structure", "required":[ "pentestJobIds", "agentSpaceId" ], "members":{ "pentestJobIds":{ "shape":"PentestJobIdList", "documentation":"The list of pentest job identifiers to retrieve.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space that contains the pentest jobs.
" } }, "documentation":"Input for BatchGetPentestJobs operation.
" }, "BatchGetPentestJobsOutput":{ "type":"structure", "members":{ "pentestJobs":{ "shape":"PentestJobList", "documentation":"The list of pentest jobs that were found.
" }, "notFound":{ "shape":"PentestJobIdList", "documentation":"The list of pentest job identifiers that were not found.
" } }, "documentation":"Output for the BatchGetPentestJobs operation.
" }, "BatchGetPentestsInput":{ "type":"structure", "required":[ "pentestIds", "agentSpaceId" ], "members":{ "pentestIds":{ "shape":"PentestIdList", "documentation":"The list of pentest identifiers to retrieve.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space that contains the pentests.
" } }, "documentation":"Input for retrieving multiple pentests by their IDs.
" }, "BatchGetPentestsOutput":{ "type":"structure", "members":{ "pentests":{ "shape":"PentestList", "documentation":"The list of pentests that were found.
" }, "notFound":{ "shape":"PentestIdList", "documentation":"The list of pentest identifiers that were not found.
" } }, "documentation":"Output for the BatchGetPentests operation.
" }, "BatchGetTargetDomainsInput":{ "type":"structure", "required":["targetDomainIds"], "members":{ "targetDomainIds":{ "shape":"TargetDomainIdList", "documentation":"The list of target domain identifiers to retrieve.
" } }, "documentation":"Input for batch retrieving target domains.
" }, "BatchGetTargetDomainsOutput":{ "type":"structure", "members":{ "targetDomains":{ "shape":"TargetDomainList", "documentation":"The list of target domains that were found.
" }, "notFound":{ "shape":"TargetDomainIdList", "documentation":"The list of target domain identifiers that were not found.
" } }, "documentation":"Output for the BatchGetTargetDomains operation.
" }, "Blob":{"type":"blob"}, "Boolean":{ "type":"boolean", "box":true }, "Category":{ "type":"structure", "members":{ "name":{ "shape":"String", "documentation":"The name of the category.
" }, "isPrimary":{ "shape":"Boolean", "documentation":"Indicates whether this is the primary category for the task.
" } }, "documentation":"Represents a category assigned to a security testing task.
" }, "CategoryList":{ "type":"list", "member":{"shape":"Category"} }, "CloudWatchLog":{ "type":"structure", "members":{ "logGroup":{ "shape":"String", "documentation":"The name of the CloudWatch log group.
" }, "logStream":{ "shape":"String", "documentation":"The name of the CloudWatch log stream.
" } }, "documentation":"The Amazon CloudWatch Logs configuration for pentest job logging.
" }, "CodeRemediationStrategy":{ "type":"string", "documentation":"Strategy for automated code remediation.
", "enum":[ "AUTOMATIC", "DISABLED" ] }, "CodeRemediationTask":{ "type":"structure", "required":["status"], "members":{ "status":{ "shape":"CodeRemediationTaskStatus", "documentation":"The current status of the code remediation task.
" }, "statusReason":{ "shape":"String", "documentation":"The reason for the current status of the code remediation task.
" }, "taskDetails":{ "shape":"CodeRemediationTaskDetailsList", "documentation":"The list of details for the code remediation task, including repository name, code diff link, and pull request link.
" } }, "documentation":"Represents a code remediation task that was initiated to fix a security finding.
" }, "CodeRemediationTaskDetails":{ "type":"structure", "members":{ "repoName":{ "shape":"String", "documentation":"The name of the repository where the remediation was applied.
" }, "codeDiffLink":{ "shape":"String", "documentation":"The link to the code diff for the remediation.
" }, "pullRequestLink":{ "shape":"String", "documentation":"The link to the pull request created for the remediation.
" } }, "documentation":"Contains details about a code remediation task, including links to the code diff and pull request.
" }, "CodeRemediationTaskDetailsList":{ "type":"list", "member":{"shape":"CodeRemediationTaskDetails"} }, "CodeRemediationTaskStatus":{ "type":"string", "documentation":"Code remediation task status.
", "enum":[ "IN_PROGRESS", "COMPLETED", "FAILED" ] }, "CodeReviewSettings":{ "type":"structure", "required":[ "controlsScanning", "generalPurposeScanning" ], "members":{ "controlsScanning":{ "shape":"Boolean", "documentation":"Indicates whether controls scanning is enabled for code reviews.
" }, "generalPurposeScanning":{ "shape":"Boolean", "documentation":"Indicates whether general-purpose scanning is enabled for code reviews.
" } }, "documentation":"The code review settings for an agent space, controlling which types of scanning are enabled.
" }, "ConfidenceLevel":{ "type":"string", "documentation":"Finding confidence level.
", "enum":[ "FALSE_POSITIVE", "UNCONFIRMED", "LOW", "MEDIUM", "HIGH" ] }, "ConflictException":{ "type":"structure", "required":["message"], "members":{ "message":{ "shape":"String", "documentation":"Error description.
" } }, "documentation":"The request could not be completed due to a conflict with the current state of the resource.
", "error":{ "httpStatusCode":409, "senderFault":true }, "exception":true }, "ContextType":{ "type":"string", "documentation":"Category of execution context.
", "enum":[ "ERROR", "CLIENT_ERROR", "WARNING", "INFO" ] }, "CreateAgentSpaceInput":{ "type":"structure", "required":["name"], "members":{ "name":{ "shape":"AgentName", "documentation":"The name of the agent space.
" }, "description":{ "shape":"String", "documentation":"A description of the agent space.
" }, "awsResources":{ "shape":"AWSResources", "documentation":"The AWS resources to associate with the agent space.
" }, "targetDomainIds":{ "shape":"TargetDomainIdList", "documentation":"The list of target domain identifiers to associate with the agent space.
" }, "codeReviewSettings":{ "shape":"CodeReviewSettings", "documentation":"The code review settings for the agent space.
" }, "kmsKeyId":{ "shape":"KmsKeyId", "documentation":"The identifier of the AWS KMS key to use for encrypting data in the agent space.
" }, "tags":{ "shape":"TagMap", "documentation":"The tags to associate with the agent space.
" } }, "documentation":"Input for creating a new agent space.
" }, "CreateAgentSpaceOutput":{ "type":"structure", "required":[ "agentSpaceId", "name" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the created agent space.
" }, "name":{ "shape":"AgentName", "documentation":"The name of the agent space.
" }, "description":{ "shape":"String", "documentation":"The description of the agent space.
" }, "awsResources":{ "shape":"AWSResources", "documentation":"The AWS resources associated with the agent space.
" }, "targetDomainIds":{ "shape":"TargetDomainIdList", "documentation":"The list of target domain identifiers associated with the agent space.
" }, "codeReviewSettings":{ "shape":"CodeReviewSettings", "documentation":"The code review settings for the agent space.
" }, "kmsKeyId":{ "shape":"KmsKeyId", "documentation":"The identifier of the AWS KMS key used to encrypt data in the agent space.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the agent space was created, in UTC format.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the agent space was last updated, in UTC format.
" } }, "documentation":"Output for the CreateAgentSpace operation.
" }, "CreateApplicationRequest":{ "type":"structure", "members":{ "idcInstanceArn":{ "shape":"IdCInstanceArn", "documentation":"The Amazon Resource Name (ARN) of the IAM Identity Center instance to associate with the application.
" }, "roleArn":{ "shape":"RoleArn", "documentation":"The Amazon Resource Name (ARN) of the IAM role to associate with the application.
" }, "defaultKmsKeyId":{ "shape":"DefaultKmsKeyId", "documentation":"The identifier of the default AWS KMS key to use for encrypting data in the application.
" }, "tags":{ "shape":"TagMap", "documentation":"The tags to associate with the application.
" } } }, "CreateApplicationResponse":{ "type":"structure", "required":["applicationId"], "members":{ "applicationId":{ "shape":"ApplicationId", "documentation":"The unique identifier of the created application.
" } } }, "CreateIntegrationInput":{ "type":"structure", "required":[ "provider", "input", "integrationDisplayName" ], "members":{ "provider":{ "shape":"Provider", "documentation":"The integration provider. Currently, only GITHUB is supported.
" }, "input":{ "shape":"ProviderInput", "documentation":"The provider-specific input required to create the integration.
" }, "integrationDisplayName":{ "shape":"String", "documentation":"The display name for the integration.
" }, "kmsKeyId":{ "shape":"KmsKeyId", "documentation":"The identifier of the AWS KMS key to use for encrypting data associated with the integration.
" }, "tags":{ "shape":"TagMap", "documentation":"The tags to associate with the integration.
" } } }, "CreateIntegrationOutput":{ "type":"structure", "required":["integrationId"], "members":{ "integrationId":{ "shape":"IntegrationId", "documentation":"The unique identifier of the created integration.
" } } }, "CreateMembershipRequest":{ "type":"structure", "required":[ "applicationId", "agentSpaceId", "membershipId", "memberType" ], "members":{ "applicationId":{ "shape":"ApplicationId", "documentation":"The unique identifier of the application that contains the agent space.
" }, "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the agent space to grant access to.
" }, "membershipId":{ "shape":"MembershipId", "documentation":"The unique identifier for the membership.
" }, "memberType":{ "shape":"MembershipType", "documentation":"The type of member. Currently, only USER is supported.
" }, "config":{ "shape":"MembershipConfig", "documentation":"The configuration for the membership, such as the user role.
" } }, "documentation":"Request structure for adding a single member to an agent space.
" }, "CreateMembershipResponse":{ "type":"structure", "members":{}, "documentation":"Response structure for adding a single member to an agent space.
" }, "CreatePentestInput":{ "type":"structure", "required":[ "title", "agentSpaceId" ], "members":{ "title":{ "shape":"String", "documentation":"The title of the pentest.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space to create the pentest in.
" }, "assets":{ "shape":"Assets", "documentation":"The assets to include in the pentest, such as endpoints, actors, documents, and source code.
" }, "excludeRiskTypes":{ "shape":"RiskTypeList", "documentation":"The list of risk types to exclude from the pentest.
" }, "serviceRole":{ "shape":"ServiceRole", "documentation":"The IAM service role to use for the pentest.
" }, "logConfig":{ "shape":"CloudWatchLog", "documentation":"The CloudWatch Logs configuration for the pentest.
" }, "vpcConfig":{ "shape":"VpcConfig", "documentation":"The VPC configuration for the pentest.
" }, "networkTrafficConfig":{ "shape":"NetworkTrafficConfig", "documentation":"The network traffic configuration for the pentest, including custom headers and traffic rules.
" }, "codeRemediationStrategy":{ "shape":"CodeRemediationStrategy", "documentation":"The code remediation strategy for the pentest. Valid values are AUTOMATIC and DISABLED.
" } }, "documentation":"Input for creating a new pentest.
" }, "CreatePentestOutput":{ "type":"structure", "members":{ "pentestId":{ "shape":"String", "documentation":"The unique identifier of the created pentest.
" }, "title":{ "shape":"String", "documentation":"The title of the pentest.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the pentest was created, in UTC format.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the pentest was last updated, in UTC format.
" }, "assets":{ "shape":"Assets", "documentation":"The assets included in the pentest.
" }, "excludeRiskTypes":{ "shape":"RiskTypeList", "documentation":"The list of risk types excluded from the pentest.
" }, "serviceRole":{ "shape":"ServiceRole", "documentation":"The IAM service role used for the pentest.
" }, "logConfig":{ "shape":"CloudWatchLog", "documentation":"The CloudWatch Logs configuration for the pentest.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space that contains the pentest.
" } }, "documentation":"Output for the CreatePentest operation.
" }, "CreateTargetDomainInput":{ "type":"structure", "required":[ "targetDomainName", "verificationMethod" ], "members":{ "targetDomainName":{ "shape":"String", "documentation":"The domain name to register as a target domain.
" }, "verificationMethod":{ "shape":"DomainVerificationMethod", "documentation":"The method to use for verifying domain ownership. Valid values are DNS_TXT, HTTP_ROUTE, and PRIVATE_VPC.
" }, "tags":{ "shape":"TagMap", "documentation":"The tags to associate with the target domain.
" } }, "documentation":"Input for creating a new target domain.
" }, "CreateTargetDomainOutput":{ "type":"structure", "required":[ "targetDomainId", "domainName", "verificationStatus" ], "members":{ "targetDomainId":{ "shape":"TargetDomainId", "documentation":"The unique identifier of the created target domain.
" }, "domainName":{ "shape":"String", "documentation":"The domain name of the target domain.
" }, "verificationStatus":{ "shape":"TargetDomainStatus", "documentation":"The current verification status of the target domain.
" }, "verificationStatusReason":{ "shape":"String", "documentation":"The reason for the current target domain verification status.
" }, "verificationDetails":{ "shape":"VerificationDetails", "documentation":"The verification details for the target domain, including the verification token and instructions.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the target domain was created, in UTC format.
" }, "verifiedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the target domain was verified, in UTC format.
" } }, "documentation":"Output for the CreateTargetDomain operation.
" }, "CsrfState":{ "type":"string", "documentation":"CSRF state token for OAuth security.
" }, "CustomHeader":{ "type":"structure", "members":{ "name":{ "shape":"String", "documentation":"The name of the custom header.
" }, "value":{ "shape":"String", "documentation":"The value of the custom header.
" } }, "documentation":"A custom HTTP header to include in network traffic during penetration testing.
" }, "CustomHeaderList":{ "type":"list", "member":{"shape":"CustomHeader"}, "documentation":"List of custom headers.
" }, "DNSRecordType":{ "type":"string", "documentation":"Type of DNS record.
", "enum":["TXT"] }, "DefaultKmsKeyId":{ "type":"string", "documentation":"Identifier of a KMS key. Can be a key ID, key ARN, alias name, or alias ARN.
" }, "DeleteAgentSpaceInput":{ "type":"structure", "required":["agentSpaceId"], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the agent space to delete.
" } }, "documentation":"Input for deleting an agent space.
" }, "DeleteAgentSpaceOutput":{ "type":"structure", "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the deleted agent space.
" } }, "documentation":"Output for the DeleteAgentSpace operation.
" }, "DeleteApplicationRequest":{ "type":"structure", "required":["applicationId"], "members":{ "applicationId":{ "shape":"ApplicationId", "documentation":"The unique identifier of the application to delete.
" } } }, "DeleteArtifactInput":{ "type":"structure", "required":[ "agentSpaceId", "artifactId" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the agent space that contains the artifact.
" }, "artifactId":{ "shape":"ArtifactId", "documentation":"The unique identifier of the artifact to delete.
" } } }, "DeleteArtifactOutput":{ "type":"structure", "members":{} }, "DeleteIntegrationInput":{ "type":"structure", "required":["integrationId"], "members":{ "integrationId":{ "shape":"IntegrationId", "documentation":"The unique identifier of the integration to delete.
" } } }, "DeleteIntegrationOutput":{ "type":"structure", "members":{} }, "DeleteMembershipRequest":{ "type":"structure", "required":[ "applicationId", "agentSpaceId", "membershipId" ], "members":{ "applicationId":{ "shape":"ApplicationId", "documentation":"The unique identifier of the application that contains the agent space.
" }, "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the agent space to revoke access from.
" }, "membershipId":{ "shape":"MembershipId", "documentation":"The unique identifier of the membership to delete.
" }, "memberType":{ "shape":"MembershipType", "documentation":"The type of member to remove.
" } }, "documentation":"Request structure for removing a single member from an agent space.
" }, "DeleteMembershipResponse":{ "type":"structure", "members":{}, "documentation":"Response structure for removing a single member from an agent space.
" }, "DeletePentestFailure":{ "type":"structure", "members":{ "pentestId":{ "shape":"String", "documentation":"The unique identifier of the pentest that failed to delete.
" }, "reason":{ "shape":"String", "documentation":"The reason the pentest failed to delete.
" } }, "documentation":"Contains information about a pentest that failed to delete.
" }, "DeletePentestFailureList":{ "type":"list", "member":{"shape":"DeletePentestFailure"} }, "DeleteTargetDomainInput":{ "type":"structure", "required":["targetDomainId"], "members":{ "targetDomainId":{ "shape":"TargetDomainId", "documentation":"The unique identifier of the target domain to delete.
" } }, "documentation":"Input for deleting a target domain.
" }, "DeleteTargetDomainOutput":{ "type":"structure", "members":{ "targetDomainId":{ "shape":"TargetDomainId", "documentation":"The unique identifier of the deleted target domain.
" } }, "documentation":"Output for the DeleteTargetDomain operation.
" }, "DiscoveredEndpoint":{ "type":"structure", "required":[ "uri", "pentestJobId", "taskId", "agentSpaceId" ], "members":{ "uri":{ "shape":"String", "documentation":"The URI of the discovered endpoint.
" }, "pentestJobId":{ "shape":"String", "documentation":"The unique identifier of the pentest job that discovered the endpoint.
" }, "taskId":{ "shape":"String", "documentation":"The unique identifier of the task that discovered the endpoint.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space associated with the discovered endpoint.
" }, "evidence":{ "shape":"String", "documentation":"The evidence that led to the discovery of the endpoint.
" }, "operation":{ "shape":"String", "documentation":"The HTTP operation associated with the discovered endpoint.
" }, "description":{ "shape":"String", "documentation":"A description of the discovered endpoint.
" } }, "documentation":"Represents an endpoint discovered during a pentest job.
" }, "DiscoveredEndpointList":{ "type":"list", "member":{"shape":"DiscoveredEndpoint"} }, "DnsVerification":{ "type":"structure", "members":{ "token":{ "shape":"String", "documentation":"The verification token to include in the DNS record value.
" }, "dnsRecordName":{ "shape":"String", "documentation":"The name of the DNS record to create for verification.
" }, "dnsRecordType":{ "shape":"DNSRecordType", "documentation":"The type of DNS record to create. Currently, only TXT is supported.
" } }, "documentation":"Contains DNS verification details for a target domain, including the DNS record to create for domain ownership verification.
" }, "DocumentInfo":{ "type":"structure", "members":{ "s3Location":{ "shape":"String", "documentation":"The Amazon S3 location of the document.
" }, "artifactId":{ "shape":"String", "documentation":"The unique identifier of the artifact associated with the document.
" } }, "documentation":"Represents a document that provides context for security testing.
" }, "DocumentList":{ "type":"list", "member":{"shape":"DocumentInfo"} }, "DomainVerificationMethod":{ "type":"string", "documentation":"Method used to verify domain ownership.
", "enum":[ "DNS_TXT", "HTTP_ROUTE", "PRIVATE_VPC" ] }, "Endpoint":{ "type":"structure", "members":{ "uri":{ "shape":"String", "documentation":"The URI of the endpoint.
" } }, "documentation":"Represents a target endpoint for penetration testing.
" }, "EndpointList":{ "type":"list", "member":{"shape":"Endpoint"} }, "ErrorCode":{ "type":"string", "documentation":"Error code for pentest job failure.
", "enum":[ "CLIENT_ERROR", "INTERNAL_ERROR", "STOPPED_BY_USER" ] }, "ErrorInformation":{ "type":"structure", "members":{ "code":{ "shape":"ErrorCode", "documentation":"The error code. Valid values include CLIENT_ERROR, INTERNAL_ERROR, and STOPPED_BY_USER.
" }, "message":{ "shape":"String", "documentation":"A message describing the error.
" } }, "documentation":"Contains error information for a pentest job that encountered an error.
" }, "ExecutionContext":{ "type":"structure", "members":{ "contextType":{ "shape":"ContextType", "documentation":"The type of context. Valid values include ERROR, CLIENT_ERROR, WARNING, and INFO.
" }, "context":{ "shape":"String", "documentation":"The context message.
" }, "timestamp":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the context was recorded, in UTC format.
" } }, "documentation":"Contains contextual information about the execution of a pentest job, such as errors, warnings, or informational messages.
" }, "ExecutionContextList":{ "type":"list", "member":{"shape":"ExecutionContext"} }, "Finding":{ "type":"structure", "required":[ "findingId", "agentSpaceId" ], "members":{ "findingId":{ "shape":"String", "documentation":"The unique identifier of the finding.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space associated with the finding.
" }, "pentestId":{ "shape":"String", "documentation":"The unique identifier of the pentest associated with the finding.
" }, "pentestJobId":{ "shape":"String", "documentation":"The unique identifier of the pentest job that produced the finding.
" }, "taskId":{ "shape":"String", "documentation":"The unique identifier of the task that produced the finding.
" }, "name":{ "shape":"String", "documentation":"The name of the finding.
" }, "description":{ "shape":"String", "documentation":"A description of the finding.
" }, "status":{ "shape":"FindingStatus", "documentation":"The current status of the finding. Valid values include ACTIVE, RESOLVED, ACCEPTED, and FALSE_POSITIVE.
" }, "riskType":{ "shape":"String", "documentation":"The type of security risk identified by the finding.
" }, "riskLevel":{ "shape":"RiskLevel", "documentation":"The risk level of the finding. Valid values include UNKNOWN, INFORMATIONAL, LOW, MEDIUM, HIGH, and CRITICAL.
" }, "riskScore":{ "shape":"String", "documentation":"The numerical risk score of the finding.
" }, "reasoning":{ "shape":"String", "documentation":"The reasoning behind the finding, explaining why it was identified as a vulnerability.
" }, "confidence":{ "shape":"ConfidenceLevel", "documentation":"The confidence level of the finding. Valid values include FALSE_POSITIVE, UNCONFIRMED, LOW, MEDIUM, and HIGH.
" }, "attackScript":{ "shape":"String", "documentation":"The attack script used to reproduce the finding.
" }, "codeRemediationTask":{ "shape":"CodeRemediationTask", "documentation":"The code remediation task associated with the finding, if code remediation was initiated.
" }, "lastUpdatedBy":{ "shape":"String", "documentation":"The identifier of the entity that last updated the finding.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the finding was created, in UTC format.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the finding was last updated, in UTC format.
" } }, "documentation":"Represents a security finding discovered during a pentest job. A finding contains details about a vulnerability, including its risk level, confidence, and remediation status.
" }, "FindingIdList":{ "type":"list", "member":{"shape":"String"} }, "FindingList":{ "type":"list", "member":{"shape":"Finding"}, "documentation":"List of findings.
" }, "FindingStatus":{ "type":"string", "documentation":"Finding status.
", "enum":[ "ACTIVE", "RESOLVED", "ACCEPTED", "FALSE_POSITIVE" ] }, "FindingSummary":{ "type":"structure", "required":[ "findingId", "agentSpaceId" ], "members":{ "findingId":{ "shape":"String", "documentation":"The unique identifier of the finding.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space associated with the finding.
" }, "pentestId":{ "shape":"String", "documentation":"The unique identifier of the pentest associated with the finding.
" }, "pentestJobId":{ "shape":"String", "documentation":"The unique identifier of the pentest job that produced the finding.
" }, "name":{ "shape":"String", "documentation":"The name of the finding.
" }, "status":{ "shape":"FindingStatus", "documentation":"The current status of the finding.
" }, "riskType":{ "shape":"String", "documentation":"The type of security risk identified by the finding.
" }, "riskLevel":{ "shape":"RiskLevel", "documentation":"The risk level of the finding.
" }, "confidence":{ "shape":"ConfidenceLevel", "documentation":"The confidence level of the finding.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the finding was created, in UTC format.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the finding was last updated, in UTC format.
" } }, "documentation":"Contains summary information about a security finding.
" }, "FindingSummaryList":{ "type":"list", "member":{"shape":"FindingSummary"}, "documentation":"List of finding summaries.
" }, "GetApplicationRequest":{ "type":"structure", "required":["applicationId"], "members":{ "applicationId":{ "shape":"ApplicationId", "documentation":"The unique identifier of the application to retrieve.
" } } }, "GetApplicationResponse":{ "type":"structure", "required":[ "applicationId", "domain" ], "members":{ "applicationId":{ "shape":"ApplicationId", "documentation":"The unique identifier of the application.
" }, "domain":{ "shape":"ApplicationDomain", "documentation":"The domain associated with the application.
" }, "applicationName":{ "shape":"String", "documentation":"The name of the application.
" }, "idcConfiguration":{ "shape":"IdCConfiguration", "documentation":"The IAM Identity Center configuration for the application.
" }, "roleArn":{ "shape":"RoleArn", "documentation":"The Amazon Resource Name (ARN) of the IAM role associated with the application.
" }, "defaultKmsKeyId":{ "shape":"DefaultKmsKeyId", "documentation":"The identifier of the default AWS KMS key used to encrypt data for the application.
" } } }, "GetArtifactInput":{ "type":"structure", "required":[ "agentSpaceId", "artifactId" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the agent space that contains the artifact.
" }, "artifactId":{ "shape":"ArtifactId", "documentation":"The unique identifier of the artifact to retrieve.
" } } }, "GetArtifactOutput":{ "type":"structure", "required":[ "agentSpaceId", "artifactId", "artifact", "fileName", "updatedAt" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the agent space that contains the artifact.
" }, "artifactId":{ "shape":"ArtifactId", "documentation":"The unique identifier of the artifact.
" }, "artifact":{ "shape":"Artifact", "documentation":"The artifact content and type.
" }, "fileName":{ "shape":"String", "documentation":"The file name of the artifact.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the artifact was last updated, in UTC format.
" } } }, "GetIntegrationInput":{ "type":"structure", "required":["integrationId"], "members":{ "integrationId":{ "shape":"IntegrationId", "documentation":"The unique identifier of the integration to retrieve.
" } } }, "GetIntegrationOutput":{ "type":"structure", "required":[ "integrationId", "installationId", "provider", "providerType" ], "members":{ "integrationId":{ "shape":"IntegrationId", "documentation":"The unique identifier of the integration.
" }, "installationId":{ "shape":"String", "documentation":"The installation identifier from the integration provider.
" }, "provider":{ "shape":"Provider", "documentation":"The integration provider.
" }, "providerType":{ "shape":"ProviderType", "documentation":"The type of the integration provider.
" }, "displayName":{ "shape":"String", "documentation":"The display name of the integration.
" }, "kmsKeyId":{ "shape":"KmsKeyId", "documentation":"The identifier of the AWS KMS key used to encrypt data associated with the integration.
" } } }, "GitHubIntegrationInput":{ "type":"structure", "required":[ "code", "state" ], "members":{ "code":{ "shape":"AuthCode", "documentation":"The OAuth authorization code received from GitHub.
" }, "state":{ "shape":"CsrfState", "documentation":"The CSRF state token for validating the OAuth flow.
" }, "organizationName":{ "shape":"String", "documentation":"The name of the GitHub organization to integrate with.
" } }, "documentation":"The input required to create a GitHub integration, including the OAuth authorization code and CSRF state.
" }, "GitHubOwner":{ "type":"string", "documentation":"Name of the GitHub Account or Organization.
" }, "GitHubRepositoryMetadata":{ "type":"structure", "required":[ "name", "providerResourceId", "owner" ], "members":{ "name":{ "shape":"ProviderResourceName", "documentation":"The name of the GitHub repository.
" }, "providerResourceId":{ "shape":"ProviderResourceId", "documentation":"The provider-specific resource identifier for the GitHub repository.
" }, "owner":{ "shape":"GitHubOwner", "documentation":"The owner of the GitHub repository.
" }, "accessType":{ "shape":"AccessType", "documentation":"The access type of the GitHub repository. Valid values are PRIVATE and PUBLIC.
" } }, "documentation":"Contains metadata about a GitHub repository that is integrated with the service.
" }, "GitHubRepositoryResource":{ "type":"structure", "required":[ "name", "owner" ], "members":{ "name":{ "shape":"ProviderResourceName", "documentation":"The name of the GitHub repository.
" }, "owner":{ "shape":"GitHubOwner", "documentation":"The owner of the GitHub repository.
" } }, "documentation":"Represents a GitHub repository resource used in an integration.
" }, "GitHubResourceCapabilities":{ "type":"structure", "members":{ "leaveComments":{ "shape":"Boolean", "documentation":"Indicates whether the integration can leave comments on pull requests.
" }, "remediateCode":{ "shape":"Boolean", "documentation":"Indicates whether the integration can create code remediation pull requests.
" } }, "documentation":"The capabilities enabled for a GitHub resource integration.
" }, "HttpVerification":{ "type":"structure", "members":{ "token":{ "shape":"String", "documentation":"The verification token to serve at the specified route path.
" }, "routePath":{ "shape":"String", "documentation":"The HTTP route path where the verification token must be served.
" } }, "documentation":"Contains HTTP route verification details for a target domain, including the route path and token to serve for domain ownership verification.
" }, "IamRoles":{ "type":"list", "member":{"shape":"ServiceRole"} }, "IdCApplicationArn":{ "type":"string", "documentation":"ARN of the IAM Identity Center application associated with this application.
" }, "IdCConfiguration":{ "type":"structure", "members":{ "idcApplicationArn":{ "shape":"IdCApplicationArn", "documentation":"The Amazon Resource Name (ARN) of the IAM Identity Center application.
" }, "idcInstanceArn":{ "shape":"IdCInstanceArn", "documentation":"The Amazon Resource Name (ARN) of the IAM Identity Center instance.
" } }, "documentation":"The IAM Identity Center configuration for an application.
" }, "IdCInstanceArn":{ "type":"string", "documentation":"ARN of the IAM Identity Center instance used for user authentication.
" }, "InitiateProviderRegistrationInput":{ "type":"structure", "required":["provider"], "members":{ "provider":{ "shape":"Provider", "documentation":"The provider to initiate registration with. Currently, only GITHUB is supported.
" } } }, "InitiateProviderRegistrationOutput":{ "type":"structure", "required":[ "redirectTo", "csrfState" ], "members":{ "redirectTo":{ "shape":"Location", "documentation":"The URL to redirect the user to for completing the OAuth authorization.
" }, "csrfState":{ "shape":"CsrfState", "documentation":"The CSRF state token to use when completing the OAuth flow.
" } } }, "IntegratedRepository":{ "type":"structure", "required":[ "integrationId", "providerResourceId" ], "members":{ "integrationId":{ "shape":"String", "documentation":"The unique identifier of the integration that provides access to the repository.
" }, "providerResourceId":{ "shape":"String", "documentation":"The provider-specific resource identifier for the repository.
" } }, "documentation":"Represents a code repository that is integrated with the service through a third-party provider.
" }, "IntegratedRepositoryList":{ "type":"list", "member":{"shape":"IntegratedRepository"} }, "IntegratedResource":{ "type":"structure", "members":{ "githubRepository":{ "shape":"GitHubRepositoryResource", "documentation":"The GitHub repository resource information.
" } }, "documentation":"Represents an integrated resource from a third-party provider. This is a union type that contains provider-specific resource information.
", "union":true }, "IntegratedResourceInputItem":{ "type":"structure", "required":["resource"], "members":{ "resource":{ "shape":"IntegratedResource", "documentation":"The integrated resource to update.
" }, "capabilities":{ "shape":"ProviderResourceCapabilities", "documentation":"The capabilities to enable for the integrated resource.
" } }, "documentation":"Represents an input item for updating integrated resources, including the resource and its capabilities.
" }, "IntegratedResourceInputItemList":{ "type":"list", "member":{"shape":"IntegratedResourceInputItem"}, "documentation":"List of integrated resources.
" }, "IntegratedResourceMetadata":{ "type":"structure", "members":{ "githubRepository":{ "shape":"GitHubRepositoryMetadata", "documentation":"The GitHub repository metadata.
" } }, "documentation":"Contains metadata about an integrated resource. This is a union type that contains provider-specific metadata.
", "union":true }, "IntegratedResourceSummary":{ "type":"structure", "required":[ "integrationId", "resource" ], "members":{ "integrationId":{ "shape":"IntegrationId", "documentation":"The unique identifier of the integration that provides access to the resource.
" }, "resource":{ "shape":"IntegratedResourceMetadata", "documentation":"The metadata for the integrated resource.
" }, "capabilities":{ "shape":"ProviderResourceCapabilities", "documentation":"The capabilities enabled for the integrated resource.
" } }, "documentation":"Contains summary information about an integrated resource.
" }, "IntegratedResourceSummaryList":{ "type":"list", "member":{"shape":"IntegratedResourceSummary"}, "documentation":"List of integrated resource items.
" }, "IntegrationFilter":{ "type":"structure", "members":{ "provider":{ "shape":"Provider", "documentation":"Filter integrations by provider.
" }, "providerType":{ "shape":"ProviderType", "documentation":"Filter integrations by provider type.
" } }, "documentation":"A filter for listing integrations. This is a union type where you can filter by provider or provider type.
", "union":true }, "IntegrationId":{ "type":"string", "documentation":"Unique identifier for an integration.
" }, "IntegrationSummary":{ "type":"structure", "required":[ "integrationId", "installationId", "provider", "providerType", "displayName" ], "members":{ "integrationId":{ "shape":"String", "documentation":"The unique identifier of the integration.
" }, "installationId":{ "shape":"String", "documentation":"The installation identifier from the integration provider.
" }, "provider":{ "shape":"Provider", "documentation":"The integration provider.
" }, "providerType":{ "shape":"ProviderType", "documentation":"The type of the integration provider.
" }, "displayName":{ "shape":"String", "documentation":"The display name of the integration.
" } }, "documentation":"Contains summary information about an integration.
" }, "IntegrationSummaryList":{ "type":"list", "member":{"shape":"IntegrationSummary"}, "documentation":"List of integration summaries.
" }, "InternalServerException":{ "type":"structure", "required":["message"], "members":{ "message":{ "shape":"String", "documentation":"Error description.
" } }, "documentation":"An unexpected error occurred during the processing of your request.
", "error":{"httpStatusCode":500}, "exception":true, "fault":true }, "JobStatus":{ "type":"string", "documentation":"Status of a pentest job.
", "enum":[ "IN_PROGRESS", "STOPPING", "STOPPED", "FAILED", "COMPLETED" ] }, "KmsKeyId":{ "type":"string", "documentation":"Identifier of a KMS key. Can be a key ID, key ARN, alias name, or alias ARN.
" }, "LambdaFunctionArn":{ "type":"string", "documentation":"Lambda function ARN or name for agent space AWS resources.
" }, "LambdaFunctionArns":{ "type":"list", "member":{"shape":"LambdaFunctionArn"} }, "ListAgentSpacesInput":{ "type":"structure", "members":{ "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" }, "maxResults":{ "shape":"MaxResults", "documentation":"The maximum number of results to return in a single call.
" } }, "documentation":"Input for listing agent spaces.
" }, "ListAgentSpacesOutput":{ "type":"structure", "members":{ "agentSpaceSummaries":{ "shape":"AgentSpaceSummaryList", "documentation":"The list of agent space summaries.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" } }, "documentation":"Output for the ListAgentSpaces operation.
" }, "ListApplicationsRequest":{ "type":"structure", "members":{ "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" }, "maxResults":{ "shape":"MaxResults", "documentation":"The maximum number of results to return in a single call.
" } } }, "ListApplicationsResponse":{ "type":"structure", "required":["applicationSummaries"], "members":{ "applicationSummaries":{ "shape":"ApplicationSummaryList", "documentation":"The list of application summaries.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" } } }, "ListArtifactsInput":{ "type":"structure", "required":["agentSpaceId"], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the agent space to list artifacts for.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" }, "maxResults":{ "shape":"MaxResults", "documentation":"The maximum number of results to return in a single call.
" } } }, "ListArtifactsOutput":{ "type":"structure", "required":["artifactSummaries"], "members":{ "artifactSummaries":{ "shape":"ArtifactSummaryList", "documentation":"The list of artifact summaries.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" } } }, "ListDiscoveredEndpointsInput":{ "type":"structure", "required":[ "pentestJobId", "agentSpaceId" ], "members":{ "maxResults":{ "shape":"MaxResults", "documentation":"The maximum number of results to return in a single call.
" }, "pentestJobId":{ "shape":"String", "documentation":"The unique identifier of the pentest job to list discovered endpoints for.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space.
" }, "prefix":{ "shape":"String", "documentation":"A prefix to filter discovered endpoints by URI.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" } }, "documentation":"Input for ListDiscoveredEndpoints operation.
" }, "ListDiscoveredEndpointsOutput":{ "type":"structure", "members":{ "discoveredEndpoints":{ "shape":"DiscoveredEndpointList", "documentation":"The list of discovered endpoints.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" } }, "documentation":"Output for the ListDiscoveredEndpoints operation.
" }, "ListFindingsInput":{ "type":"structure", "required":[ "pentestJobId", "agentSpaceId" ], "members":{ "maxResults":{ "shape":"MaxResults", "documentation":"The maximum number of results to return in a single call.
" }, "pentestJobId":{ "shape":"String", "documentation":"The unique identifier of the pentest job to list findings for.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" }, "riskType":{ "shape":"String", "documentation":"Filter findings by risk type.
" }, "riskLevel":{ "shape":"RiskLevel", "documentation":"Filter findings by risk level.
" }, "status":{ "shape":"FindingStatus", "documentation":"Filter findings by status.
" }, "confidence":{ "shape":"ConfidenceLevel", "documentation":"Filter findings by confidence level.
" }, "name":{ "shape":"String", "documentation":"Filter findings by name.
" } }, "documentation":"Input for ListFindings operation with filtering support.
" }, "ListFindingsOutput":{ "type":"structure", "members":{ "findingsSummaries":{ "shape":"FindingSummaryList", "documentation":"The list of finding summaries.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" } }, "documentation":"Output for the ListFindings operation.
" }, "ListIntegratedResourcesInput":{ "type":"structure", "required":["agentSpaceId"], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the agent space to list integrated resources for.
" }, "integrationId":{ "shape":"IntegrationId", "documentation":"The unique identifier of the integration to filter by.
" }, "resourceType":{ "shape":"ResourceType", "documentation":"The type of resource to filter by.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" }, "maxResults":{ "shape":"MaxResults", "documentation":"The maximum number of results to return in a single call.
" } } }, "ListIntegratedResourcesOutput":{ "type":"structure", "required":["integratedResourceSummaries"], "members":{ "integratedResourceSummaries":{ "shape":"IntegratedResourceSummaryList", "documentation":"The list of integrated resource summaries.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" } } }, "ListIntegrationsInput":{ "type":"structure", "members":{ "filter":{ "shape":"IntegrationFilter", "documentation":"A filter to apply to the list of integrations.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" }, "maxResults":{ "shape":"MaxResults", "documentation":"The maximum number of results to return in a single call.
" } } }, "ListIntegrationsOutput":{ "type":"structure", "required":["integrationSummaries"], "members":{ "integrationSummaries":{ "shape":"IntegrationSummaryList", "documentation":"The list of integration summaries.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" } } }, "ListMembershipsRequest":{ "type":"structure", "required":[ "applicationId", "agentSpaceId" ], "members":{ "applicationId":{ "shape":"ApplicationId", "documentation":"The unique identifier of the application that contains the agent space.
" }, "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the agent space to list memberships for.
" }, "memberType":{ "shape":"MembershipTypeFilter", "documentation":"Filter memberships by member type.
" }, "maxResults":{ "shape":"MaxResults", "documentation":"The maximum number of results to return in a single call.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" } }, "documentation":"Request structure for listing agent space members.
" }, "ListMembershipsResponse":{ "type":"structure", "required":["membershipSummaries"], "members":{ "membershipSummaries":{ "shape":"MembershipSummaryList", "documentation":"The list of membership summaries.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" } }, "documentation":"Response structure for listing members associated to an agent space.
" }, "ListPentestJobTasksInput":{ "type":"structure", "required":["agentSpaceId"], "members":{ "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space.
" }, "maxResults":{ "shape":"MaxResults", "documentation":"The maximum number of results to return in a single call.
" }, "pentestJobId":{ "shape":"String", "documentation":"The unique identifier of the pentest job to list tasks for.
" }, "stepName":{ "shape":"StepName", "documentation":"Filter tasks by step name. Valid values include PREFLIGHT, STATIC_ANALYSIS, PENTEST, and FINALIZING.
" }, "categoryName":{ "shape":"String", "documentation":"Filter tasks by category name.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" } }, "documentation":"Input for listing tasks associated with a pentest job.
" }, "ListPentestJobTasksOutput":{ "type":"structure", "members":{ "taskSummaries":{ "shape":"TaskSummaryList", "documentation":"The list of task summaries.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" } }, "documentation":"Output for the ListPentestJobTasks operation.
" }, "ListPentestJobsForPentestInput":{ "type":"structure", "required":[ "pentestId", "agentSpaceId" ], "members":{ "maxResults":{ "shape":"MaxResults", "documentation":"The maximum number of results to return in a single call.
" }, "pentestId":{ "shape":"String", "documentation":"The unique identifier of the pentest to list jobs for.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" } }, "documentation":"Input for ListPentestJobsForPentest operation.
" }, "ListPentestJobsForPentestOutput":{ "type":"structure", "members":{ "pentestJobSummaries":{ "shape":"PentestJobSummaryList", "documentation":"The list of pentest job summaries.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" } }, "documentation":"Output for the ListPentestJobsForPentest operation.
" }, "ListPentestsInput":{ "type":"structure", "required":["agentSpaceId"], "members":{ "maxResults":{ "shape":"MaxResults", "documentation":"The maximum number of results to return in a single call.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space to list pentests for.
" } }, "documentation":"Input for listing pentests with optional filtering.
" }, "ListPentestsOutput":{ "type":"structure", "members":{ "pentestSummaries":{ "shape":"PentestSummaryList", "documentation":"The list of pentest summaries.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" } }, "documentation":"Output for the ListPentests operation.
" }, "ListTagsForResourceInput":{ "type":"structure", "required":["resourceArn"], "members":{ "resourceArn":{ "shape":"ResourceArn", "documentation":"The Amazon Resource Name (ARN) of the resource to list tags for.
", "location":"uri", "locationName":"resourceArn" } }, "documentation":"Input for ListTagsForResource operation.
" }, "ListTagsForResourceOutput":{ "type":"structure", "members":{ "tags":{ "shape":"TagMap", "documentation":"The tags associated with the resource.
" } }, "documentation":"Output for ListTagsForResource operation.
" }, "ListTargetDomainsInput":{ "type":"structure", "members":{ "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" }, "maxResults":{ "shape":"MaxResults", "documentation":"The maximum number of results to return in a single call.
" } }, "documentation":"Input for listing target domains.
" }, "ListTargetDomainsOutput":{ "type":"structure", "members":{ "targetDomainSummaries":{ "shape":"TargetDomainSummaryList", "documentation":"The list of target domain summaries.
" }, "nextToken":{ "shape":"NextToken", "documentation":"A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request.
" } }, "documentation":"Output for the ListTargetDomains operation.
" }, "Location":{ "type":"string", "documentation":"Location URL for OAuth redirect.
" }, "LogGroupArn":{ "type":"string", "documentation":"Log group ARN or name for agent space AWS resources.
" }, "LogGroupArns":{ "type":"list", "member":{"shape":"LogGroupArn"} }, "LogLocation":{ "type":"structure", "members":{ "logType":{ "shape":"LogType", "documentation":"The type of log storage. Currently, only CLOUDWATCH is supported.
" }, "cloudWatchLog":{ "shape":"CloudWatchLog", "documentation":"The CloudWatch Logs location for the task logs.
" } }, "documentation":"The log location for a task, specifying where task execution logs are stored.
" }, "LogType":{ "type":"string", "documentation":"Type of log storage.
", "enum":["CLOUDWATCH"] }, "MaxResults":{ "type":"integer", "documentation":"Maximum results for pagination.
", "box":true }, "MemberMetadata":{ "type":"structure", "members":{ "user":{ "shape":"UserMetadata", "documentation":"The user metadata for the member.
" } }, "documentation":"Contains metadata about a member. This is a union type that contains member-type-specific metadata.
", "union":true }, "MembershipConfig":{ "type":"structure", "members":{ "user":{ "shape":"UserConfig", "documentation":"The user configuration for the membership.
" } }, "documentation":"The configuration for a membership. This is a union type that contains member-type-specific configuration.
", "union":true }, "MembershipId":{ "type":"string", "documentation":"Member identifier.
" }, "MembershipSummary":{ "type":"structure", "required":[ "membershipId", "applicationId", "agentSpaceId", "memberType", "createdAt", "updatedAt", "createdBy", "updatedBy" ], "members":{ "membershipId":{ "shape":"MembershipId", "documentation":"The unique identifier of the membership.
" }, "applicationId":{ "shape":"ApplicationId", "documentation":"The unique identifier of the application.
" }, "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the agent space.
" }, "memberType":{ "shape":"MembershipType", "documentation":"The type of member.
" }, "config":{ "shape":"MembershipConfig", "documentation":"The configuration for the membership.
" }, "metadata":{ "shape":"MemberMetadata", "documentation":"The metadata for the member.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the membership was created, in UTC format.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the membership was last updated, in UTC format.
" }, "createdBy":{ "shape":"String", "documentation":"The identifier of the entity that created the membership.
" }, "updatedBy":{ "shape":"String", "documentation":"The identifier of the entity that last updated the membership.
" } }, "documentation":"Contains summary information about a membership.
" }, "MembershipSummaryList":{ "type":"list", "member":{"shape":"MembershipSummary"}, "documentation":"List of membership summaries.
" }, "MembershipType":{ "type":"string", "documentation":"Type of membership.
", "enum":["USER"] }, "MembershipTypeFilter":{ "type":"string", "documentation":"Filter for member type in list operations.
", "enum":[ "USER", "ALL" ] }, "NetworkTrafficConfig":{ "type":"structure", "members":{ "rules":{ "shape":"NetworkTrafficRuleList", "documentation":"The list of network traffic rules that control which URLs are allowed or denied during testing.
" }, "customHeaders":{ "shape":"CustomHeaderList", "documentation":"The list of custom HTTP headers to include in network traffic during testing.
" } }, "documentation":"The network traffic configuration for a pentest, including custom headers and traffic rules.
" }, "NetworkTrafficRule":{ "type":"structure", "members":{ "effect":{ "shape":"NetworkTrafficRuleEffect", "documentation":"The effect of the rule. Valid values are ALLOW and DENY.
" }, "pattern":{ "shape":"String", "documentation":"The URL pattern to match for the rule.
" }, "networkTrafficRuleType":{ "shape":"NetworkTrafficRuleType", "documentation":"The type of the network traffic rule. Currently, only URL is supported.
" } }, "documentation":"A rule that controls network traffic during penetration testing by allowing or denying traffic to specific URL patterns.
" }, "NetworkTrafficRuleEffect":{ "type":"string", "documentation":"Effect of a network traffic rule.
", "enum":[ "ALLOW", "DENY" ] }, "NetworkTrafficRuleList":{ "type":"list", "member":{"shape":"NetworkTrafficRule"}, "documentation":"List of network traffic rules.
" }, "NetworkTrafficRuleType":{ "type":"string", "documentation":"Type of network traffic rule.
", "enum":["URL"] }, "NextToken":{ "type":"string", "documentation":"Pagination token.
" }, "Pentest":{ "type":"structure", "required":[ "pentestId", "agentSpaceId", "title", "assets" ], "members":{ "pentestId":{ "shape":"String", "documentation":"The unique identifier of the pentest.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space that contains the pentest.
" }, "title":{ "shape":"String", "documentation":"The title of the pentest.
" }, "assets":{ "shape":"Assets", "documentation":"The assets included in the pentest.
" }, "excludeRiskTypes":{ "shape":"RiskTypeList", "documentation":"The list of risk types excluded from the pentest.
" }, "serviceRole":{ "shape":"ServiceRole", "documentation":"The IAM service role used for the pentest.
" }, "logConfig":{ "shape":"CloudWatchLog", "documentation":"The CloudWatch Logs configuration for the pentest.
" }, "vpcConfig":{ "shape":"VpcConfig", "documentation":"The VPC configuration for the pentest.
" }, "networkTrafficConfig":{ "shape":"NetworkTrafficConfig", "documentation":"The network traffic configuration for the pentest.
" }, "codeRemediationStrategy":{ "shape":"CodeRemediationStrategy", "documentation":"The code remediation strategy for the pentest.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the pentest was created, in UTC format.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the pentest was last updated, in UTC format.
" } }, "documentation":"Represents a pentest configuration that defines the parameters for security testing, including target assets, risk type exclusions, and infrastructure settings.
" }, "PentestIdList":{ "type":"list", "member":{"shape":"String"} }, "PentestJob":{ "type":"structure", "members":{ "pentestJobId":{ "shape":"String", "documentation":"The unique identifier of the pentest job.
" }, "pentestId":{ "shape":"String", "documentation":"The unique identifier of the pentest associated with the job.
" }, "title":{ "shape":"String", "documentation":"The title of the pentest job.
" }, "overview":{ "shape":"String", "documentation":"An overview of the pentest job results.
" }, "status":{ "shape":"JobStatus", "documentation":"The current status of the pentest job.
" }, "endpoints":{ "shape":"EndpointList", "documentation":"The list of endpoints being tested in the pentest job.
" }, "actors":{ "shape":"ActorList", "documentation":"The list of actors used during the pentest job.
" }, "documents":{ "shape":"DocumentList", "documentation":"The list of documents providing context for the pentest job.
" }, "sourceCode":{ "shape":"SourceCodeRepositoryList", "documentation":"The list of source code repositories analyzed during the pentest job.
" }, "excludePaths":{ "shape":"EndpointList", "documentation":"The list of paths excluded from the pentest job.
" }, "allowedDomains":{ "shape":"EndpointList", "documentation":"The list of domains allowed during the pentest job.
" }, "excludeRiskTypes":{ "shape":"RiskTypeList", "documentation":"The list of risk types excluded from the pentest job.
" }, "steps":{ "shape":"StepList", "documentation":"The list of steps in the pentest job execution.
" }, "executionContext":{ "shape":"ExecutionContextList", "documentation":"The execution context messages for the pentest job.
" }, "serviceRole":{ "shape":"ServiceRole", "documentation":"The IAM service role used for the pentest job.
" }, "logConfig":{ "shape":"CloudWatchLog", "documentation":"The CloudWatch Logs configuration for the pentest job.
" }, "vpcConfig":{ "shape":"VpcConfig", "documentation":"The VPC configuration for the pentest job.
" }, "networkTrafficConfig":{ "shape":"NetworkTrafficConfig", "documentation":"The network traffic configuration for the pentest job.
" }, "errorInformation":{ "shape":"ErrorInformation", "documentation":"Error information if the pentest job encountered an error.
" }, "integratedRepositories":{ "shape":"IntegratedRepositoryList", "documentation":"The list of integrated repositories associated with the pentest job.
" }, "codeRemediationStrategy":{ "shape":"CodeRemediationStrategy", "documentation":"The code remediation strategy for the pentest job.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the pentest job was created, in UTC format.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the pentest job was last updated, in UTC format.
" } }, "documentation":"Represents a pentest job, which is an execution instance of a pentest. A pentest job progresses through preflight, static analysis, pentest, and finalizing steps.
" }, "PentestJobIdList":{ "type":"list", "member":{"shape":"String"} }, "PentestJobList":{ "type":"list", "member":{"shape":"PentestJob"} }, "PentestJobSummary":{ "type":"structure", "required":[ "pentestJobId", "pentestId" ], "members":{ "pentestJobId":{ "shape":"String", "documentation":"The unique identifier of the pentest job.
" }, "pentestId":{ "shape":"String", "documentation":"The unique identifier of the pentest associated with the job.
" }, "title":{ "shape":"String", "documentation":"The title of the pentest job.
" }, "status":{ "shape":"JobStatus", "documentation":"The current status of the pentest job.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the pentest job was created, in UTC format.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the pentest job was last updated, in UTC format.
" } }, "documentation":"Contains summary information about a pentest job.
" }, "PentestJobSummaryList":{ "type":"list", "member":{"shape":"PentestJobSummary"} }, "PentestList":{ "type":"list", "member":{"shape":"Pentest"} }, "PentestSummary":{ "type":"structure", "required":[ "pentestId", "agentSpaceId", "title" ], "members":{ "pentestId":{ "shape":"String", "documentation":"The unique identifier of the pentest.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space that contains the pentest.
" }, "title":{ "shape":"String", "documentation":"The title of the pentest.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the pentest was created, in UTC format.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the pentest was last updated, in UTC format.
" } }, "documentation":"Contains summary information about a pentest.
" }, "PentestSummaryList":{ "type":"list", "member":{"shape":"PentestSummary"} }, "Provider":{ "type":"string", "documentation":"Third-party provider type.
", "enum":["GITHUB"] }, "ProviderInput":{ "type":"structure", "members":{ "github":{ "shape":"GitHubIntegrationInput", "documentation":"The GitHub-specific input for creating an integration.
" } }, "documentation":"The provider-specific input for creating an integration. This is a union type that contains provider-specific configuration.
", "union":true }, "ProviderResourceCapabilities":{ "type":"structure", "members":{ "github":{ "shape":"GitHubResourceCapabilities", "documentation":"The GitHub-specific resource capabilities.
" } }, "documentation":"The capabilities for an integrated resource from a third-party provider. This is a union type that contains provider-specific capabilities.
", "union":true }, "ProviderResourceId":{ "type":"string", "documentation":"Provider Id of the resource e.g. GitHub repository id, etc.
" }, "ProviderResourceName":{ "type":"string", "documentation":"Name of the resource e.g. repository name, etc.
" }, "ProviderType":{ "type":"string", "documentation":"Type of provider integration.
", "enum":[ "SOURCE_CODE", "DOCUMENTATION" ] }, "ResourceArn":{ "type":"string", "documentation":"ARN of a taggable resource.
" }, "ResourceNotFoundException":{ "type":"structure", "required":["message"], "members":{ "message":{ "shape":"String", "documentation":"Error description.
" } }, "documentation":"The specified resource was not found. Verify that the resource identifier is correct and that the resource exists in the specified agent space or account.
", "error":{ "httpStatusCode":404, "senderFault":true }, "exception":true }, "ResourceType":{ "type":"string", "documentation":"Type of resource.
", "enum":["CODE_REPOSITORY"] }, "RiskLevel":{ "type":"string", "documentation":"Risk severity level.
", "enum":[ "UNKNOWN", "INFORMATIONAL", "LOW", "MEDIUM", "HIGH", "CRITICAL" ] }, "RiskType":{ "type":"string", "documentation":"Type of security risk.
", "enum":[ "CROSS_SITE_SCRIPTING", "DEFAULT_CREDENTIALS", "INSECURE_DIRECT_OBJECT_REFERENCE", "PRIVILEGE_ESCALATION", "SERVER_SIDE_TEMPLATE_INJECTION", "COMMAND_INJECTION", "CODE_INJECTION", "SQL_INJECTION", "ARBITRARY_FILE_UPLOAD", "INSECURE_DESERIALIZATION", "LOCAL_FILE_INCLUSION", "INFORMATION_DISCLOSURE", "PATH_TRAVERSAL", "SERVER_SIDE_REQUEST_FORGERY", "JSON_WEB_TOKEN_VULNERABILITIES", "XML_EXTERNAL_ENTITY", "FILE_DELETION", "OTHER", "GRAPHQL_VULNERABILITIES", "BUSINESS_LOGIC_VULNERABILITIES", "CRYPTOGRAPHIC_VULNERABILITIES", "DENIAL_OF_SERVICE", "FILE_ACCESS", "FILE_CREATION", "DATABASE_MODIFICATION", "DATABASE_ACCESS", "OUTBOUND_SERVICE_REQUEST", "UNKNOWN" ] }, "RiskTypeList":{ "type":"list", "member":{"shape":"RiskType"} }, "RoleArn":{ "type":"string", "documentation":"ARN of the IAM role that the application uses to access AWS resources on your behalf.
" }, "S3BucketArn":{ "type":"string", "documentation":"S3 bucket ARN or name for agent space AWS resources.
" }, "S3BucketArns":{ "type":"list", "member":{"shape":"S3BucketArn"} }, "SecretArn":{ "type":"string", "documentation":"Secret ARN or name for agent space AWS resources.
" }, "SecretArns":{ "type":"list", "member":{"shape":"SecretArn"} }, "SecurityGroupArn":{ "type":"string", "documentation":"ARN or ID of a security group.
" }, "SecurityGroupArns":{ "type":"list", "member":{"shape":"SecurityGroupArn"}, "documentation":"A list of one or more security group ARNs or IDs in the customer VPC.
" }, "SensitiveEmail":{ "type":"string", "documentation":"Sensitive email address.
" }, "ServiceRole":{ "type":"string", "documentation":"ARN of an IAM role that the service can assume to access customer resources.
" }, "SourceCodeRepository":{ "type":"structure", "members":{ "s3Location":{ "shape":"String", "documentation":"The Amazon S3 location of the source code repository archive.
" } }, "documentation":"Represents a source code repository used for security analysis during a pentest.
" }, "SourceCodeRepositoryList":{ "type":"list", "member":{"shape":"SourceCodeRepository"} }, "StartCodeRemediationInput":{ "type":"structure", "required":[ "agentSpaceId", "pentestJobId", "findingIds" ], "members":{ "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space.
" }, "pentestJobId":{ "shape":"String", "documentation":"The unique identifier of the pentest job that produced the findings.
" }, "findingIds":{ "shape":"FindingIdList", "documentation":"The list of finding identifiers to initiate code remediation for.
" } }, "documentation":"Input for the StartCodeRemediation operation.
" }, "StartCodeRemediationOutput":{ "type":"structure", "members":{}, "documentation":"Output for the StartCodeRemediation operation.
" }, "StartPentestJobInput":{ "type":"structure", "required":[ "agentSpaceId", "pentestId" ], "members":{ "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space.
" }, "pentestId":{ "shape":"String", "documentation":"The unique identifier of the pentest to start a job for.
" } }, "documentation":"Input for starting the execution of a pentest.
" }, "StartPentestJobOutput":{ "type":"structure", "members":{ "title":{ "shape":"String", "documentation":"The title of the pentest job.
" }, "status":{ "shape":"JobStatus", "documentation":"The current status of the pentest job.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the pentest job was created, in UTC format.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the pentest job was last updated, in UTC format.
" }, "pentestId":{ "shape":"String", "documentation":"The unique identifier of the pentest.
" }, "pentestJobId":{ "shape":"String", "documentation":"The unique identifier of the started pentest job.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space.
" } }, "documentation":"Output for the StartPentestJob operation.
" }, "Step":{ "type":"structure", "members":{ "name":{ "shape":"StepName", "documentation":"The name of the step. Valid values include PREFLIGHT, STATIC_ANALYSIS, PENTEST, and FINALIZING.
" }, "status":{ "shape":"StepStatus", "documentation":"The current status of the step.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the step was created, in UTC format.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the step was last updated, in UTC format.
" } }, "documentation":"Represents a step in the pentest job execution pipeline. Steps include preflight, static analysis, pentest, and finalizing.
" }, "StepList":{ "type":"list", "member":{"shape":"Step"}, "documentation":"List of pentest job steps.
" }, "StepName":{ "type":"string", "documentation":"Pentest job step names.
", "enum":[ "PREFLIGHT", "STATIC_ANALYSIS", "PENTEST", "FINALIZING" ] }, "StepStatus":{ "type":"string", "documentation":"Pentest job step status.
", "enum":[ "NOT_STARTED", "IN_PROGRESS", "COMPLETED", "FAILED", "STOPPED" ] }, "StopPentestJobInput":{ "type":"structure", "required":[ "agentSpaceId", "pentestJobId" ], "members":{ "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space.
" }, "pentestJobId":{ "shape":"String", "documentation":"The unique identifier of the pentest job to stop.
" } }, "documentation":"Input for stopping the execution of a pentest.
" }, "StopPentestJobOutput":{ "type":"structure", "members":{}, "documentation":"Output for the StopPentestJob operation.
" }, "String":{"type":"string"}, "SubnetArn":{ "type":"string", "documentation":"ARN or ID of a subnet.
" }, "SubnetArns":{ "type":"list", "member":{"shape":"SubnetArn"}, "documentation":"A list of one or more subnet ARNs or IDs in the customer VPC.
" }, "SyntheticTimestamp_date_time":{ "type":"timestamp", "timestampFormat":"iso8601" }, "TagKey":{ "type":"string", "documentation":"Key for a resource tag.
" }, "TagKeyList":{ "type":"list", "member":{"shape":"TagKey"}, "documentation":"List of tag keys.
" }, "TagMap":{ "type":"map", "key":{"shape":"TagKey"}, "value":{"shape":"TagValue"}, "documentation":"Map of tags for a resource.
" }, "TagResourceInput":{ "type":"structure", "required":[ "resourceArn", "tags" ], "members":{ "resourceArn":{ "shape":"ResourceArn", "documentation":"The Amazon Resource Name (ARN) of the resource to tag.
", "location":"uri", "locationName":"resourceArn" }, "tags":{ "shape":"TagMap", "documentation":"The tags to add to the resource.
" } }, "documentation":"Input for TagResource operation.
" }, "TagResourceOutput":{ "type":"structure", "members":{}, "documentation":"Output for TagResource operation.
" }, "TagValue":{ "type":"string", "documentation":"Value for a resource tag.
" }, "TargetDomain":{ "type":"structure", "required":[ "targetDomainId", "domainName" ], "members":{ "targetDomainId":{ "shape":"TargetDomainId", "documentation":"The unique identifier of the target domain.
" }, "domainName":{ "shape":"String", "documentation":"The domain name of the target domain.
" }, "verificationStatus":{ "shape":"TargetDomainStatus", "documentation":"The current verification status of the target domain.
" }, "verificationStatusReason":{ "shape":"String", "documentation":"The reason for the current target domain verification status.
" }, "verificationDetails":{ "shape":"VerificationDetails", "documentation":"The verification details for the target domain.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the target domain was created, in UTC format.
" }, "verifiedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the target domain was verified, in UTC format.
" } }, "documentation":"Represents a target domain registered for penetration testing. A target domain must be verified through DNS TXT or HTTP route verification before it can be used in pentests.
" }, "TargetDomainId":{ "type":"string", "documentation":"Unique identifier of the target domain.
" }, "TargetDomainIdList":{ "type":"list", "member":{"shape":"String"}, "documentation":"List of target domain IDs.
" }, "TargetDomainList":{ "type":"list", "member":{"shape":"TargetDomain"}, "documentation":"List of target domains.
" }, "TargetDomainStatus":{ "type":"string", "documentation":"Verification status of a target domain.
", "enum":[ "PENDING", "VERIFIED", "FAILED", "UNREACHABLE" ] }, "TargetDomainSummary":{ "type":"structure", "required":[ "targetDomainId", "domainName" ], "members":{ "targetDomainId":{ "shape":"TargetDomainId", "documentation":"The unique identifier of the target domain.
" }, "domainName":{ "shape":"String", "documentation":"The domain name of the target domain.
" }, "verificationStatus":{ "shape":"TargetDomainStatus", "documentation":"The current verification status of the target domain.
" } }, "documentation":"Contains summary information about a target domain.
" }, "TargetDomainSummaryList":{ "type":"list", "member":{"shape":"TargetDomainSummary"} }, "Task":{ "type":"structure", "required":["taskId"], "members":{ "taskId":{ "shape":"String", "documentation":"The unique identifier of the task.
" }, "pentestId":{ "shape":"String", "documentation":"The unique identifier of the pentest associated with the task.
" }, "pentestJobId":{ "shape":"String", "documentation":"The unique identifier of the pentest job that contains the task.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space.
" }, "title":{ "shape":"String", "documentation":"The title of the task.
" }, "description":{ "shape":"String", "documentation":"A description of the task.
" }, "categories":{ "shape":"CategoryList", "documentation":"The list of categories assigned to the task.
" }, "riskType":{ "shape":"RiskType", "documentation":"The type of security risk the task is testing for.
" }, "targetEndpoint":{ "shape":"Endpoint", "documentation":"The target endpoint being tested by the task.
" }, "executionStatus":{ "shape":"TaskExecutionStatus", "documentation":"The current execution status of the task.
" }, "logsLocation":{ "shape":"LogLocation", "documentation":"The location of the task execution logs.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the task was created, in UTC format.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the task was last updated, in UTC format.
" } }, "documentation":"Represents an individual security test task within a pentest job. Each task targets a specific risk type or endpoint and executes independently.
" }, "TaskExecutionStatus":{ "type":"string", "documentation":"Execution status of a task.
", "enum":[ "IN_PROGRESS", "ABORTED", "COMPLETED", "INTERNAL_ERROR", "FAILED" ] }, "TaskIdList":{ "type":"list", "member":{"shape":"String"} }, "TaskList":{ "type":"list", "member":{"shape":"Task"} }, "TaskSummary":{ "type":"structure", "required":["taskId"], "members":{ "taskId":{ "shape":"String", "documentation":"The unique identifier of the task.
" }, "pentestId":{ "shape":"String", "documentation":"The unique identifier of the pentest associated with the task.
" }, "pentestJobId":{ "shape":"String", "documentation":"The unique identifier of the pentest job that contains the task.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space.
" }, "title":{ "shape":"String", "documentation":"The title of the task.
" }, "riskType":{ "shape":"RiskType", "documentation":"The type of security risk the task is testing for.
" }, "executionStatus":{ "shape":"TaskExecutionStatus", "documentation":"The current execution status of the task.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the task was created, in UTC format.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the task was last updated, in UTC format.
" } }, "documentation":"Contains summary information about a task.
" }, "TaskSummaryList":{ "type":"list", "member":{"shape":"TaskSummary"} }, "ThrottlingException":{ "type":"structure", "required":["message"], "members":{ "message":{ "shape":"String", "documentation":"Error description.
" }, "serviceCode":{ "shape":"String", "documentation":"Service code for throttling limit.
" }, "quotaCode":{ "shape":"String", "documentation":"Quota code for throttling limit.
" } }, "documentation":"The request was denied due to request throttling.
", "error":{ "httpStatusCode":429, "senderFault":true }, "exception":true }, "UntagResourceInput":{ "type":"structure", "required":[ "resourceArn", "tagKeys" ], "members":{ "resourceArn":{ "shape":"ResourceArn", "documentation":"The Amazon Resource Name (ARN) of the resource to remove tags from.
", "location":"uri", "locationName":"resourceArn" }, "tagKeys":{ "shape":"TagKeyList", "documentation":"The list of tag keys to remove from the resource.
", "location":"querystring", "locationName":"tagKeys" } }, "documentation":"Input for UntagResource operation.
" }, "UntagResourceOutput":{ "type":"structure", "members":{}, "documentation":"Output for UntagResource operation.
" }, "UpdateAgentSpaceInput":{ "type":"structure", "required":["agentSpaceId"], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the agent space to update.
" }, "name":{ "shape":"AgentName", "documentation":"The updated name of the agent space.
" }, "description":{ "shape":"String", "documentation":"The updated description of the agent space.
" }, "awsResources":{ "shape":"AWSResources", "documentation":"The updated AWS resources to associate with the agent space.
" }, "targetDomainIds":{ "shape":"TargetDomainIdList", "documentation":"The updated list of target domain identifiers to associate with the agent space.
" }, "codeReviewSettings":{ "shape":"CodeReviewSettings", "documentation":"The updated code review settings for the agent space.
" } }, "documentation":"Input for updating an agent space.
" }, "UpdateAgentSpaceOutput":{ "type":"structure", "required":[ "agentSpaceId", "name" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the updated agent space.
" }, "name":{ "shape":"AgentName", "documentation":"The name of the agent space.
" }, "description":{ "shape":"String", "documentation":"The description of the agent space.
" }, "awsResources":{ "shape":"AWSResources", "documentation":"The AWS resources associated with the agent space.
" }, "targetDomainIds":{ "shape":"TargetDomainIdList", "documentation":"The list of target domain identifiers associated with the agent space.
" }, "codeReviewSettings":{ "shape":"CodeReviewSettings", "documentation":"The code review settings for the agent space.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the agent space was created, in UTC format.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the agent space was last updated, in UTC format.
" } }, "documentation":"Output for the UpdateAgentSpace operation.
" }, "UpdateApplicationRequest":{ "type":"structure", "required":["applicationId"], "members":{ "applicationId":{ "shape":"ApplicationId", "documentation":"The unique identifier of the application to update.
" }, "roleArn":{ "shape":"RoleArn", "documentation":"The updated Amazon Resource Name (ARN) of the IAM role for the application.
" }, "defaultKmsKeyId":{ "shape":"DefaultKmsKeyId", "documentation":"The updated identifier of the default AWS KMS key for the application.
" } } }, "UpdateApplicationResponse":{ "type":"structure", "required":["applicationId"], "members":{ "applicationId":{ "shape":"ApplicationId", "documentation":"The unique identifier of the updated application.
" } } }, "UpdateFindingInput":{ "type":"structure", "required":[ "findingId", "agentSpaceId" ], "members":{ "findingId":{ "shape":"String", "documentation":"The unique identifier of the finding to update.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space that contains the finding.
" }, "riskLevel":{ "shape":"RiskLevel", "documentation":"The updated risk level for the finding.
" }, "status":{ "shape":"FindingStatus", "documentation":"The updated status for the finding.
" } }, "documentation":"Input for updating an existing security finding.
" }, "UpdateFindingOutput":{ "type":"structure", "members":{}, "documentation":"Output for the UpdateFinding operation.
" }, "UpdateIntegratedResourcesInput":{ "type":"structure", "required":[ "agentSpaceId", "integrationId", "items" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"The unique identifier of the agent space.
" }, "integrationId":{ "shape":"IntegrationId", "documentation":"The unique identifier of the integration.
" }, "items":{ "shape":"IntegratedResourceInputItemList", "documentation":"The list of integrated resource items to update.
" } } }, "UpdateIntegratedResourcesOutput":{ "type":"structure", "members":{} }, "UpdatePentestInput":{ "type":"structure", "required":[ "pentestId", "agentSpaceId" ], "members":{ "pentestId":{ "shape":"String", "documentation":"The unique identifier of the pentest to update.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space that contains the pentest.
" }, "title":{ "shape":"String", "documentation":"The updated title of the pentest.
" }, "assets":{ "shape":"Assets", "documentation":"The updated assets for the pentest.
" }, "excludeRiskTypes":{ "shape":"RiskTypeList", "documentation":"The updated list of risk types to exclude from the pentest.
" }, "serviceRole":{ "shape":"ServiceRole", "documentation":"The updated IAM service role for the pentest.
" }, "logConfig":{ "shape":"CloudWatchLog", "documentation":"The updated CloudWatch Logs configuration for the pentest.
" }, "vpcConfig":{ "shape":"VpcConfig", "documentation":"The updated VPC configuration for the pentest.
" }, "networkTrafficConfig":{ "shape":"NetworkTrafficConfig", "documentation":"The updated network traffic configuration for the pentest.
" }, "codeRemediationStrategy":{ "shape":"CodeRemediationStrategy", "documentation":"The updated code remediation strategy for the pentest.
" } }, "documentation":"Input for updating an existing pentest.
" }, "UpdatePentestOutput":{ "type":"structure", "members":{ "pentestId":{ "shape":"String", "documentation":"The unique identifier of the pentest.
" }, "title":{ "shape":"String", "documentation":"The title of the pentest.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the pentest was created, in UTC format.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the pentest was last updated, in UTC format.
" }, "assets":{ "shape":"Assets", "documentation":"The assets included in the pentest.
" }, "excludeRiskTypes":{ "shape":"RiskTypeList", "documentation":"The list of risk types excluded from the pentest.
" }, "serviceRole":{ "shape":"ServiceRole", "documentation":"The IAM service role used for the pentest.
" }, "logConfig":{ "shape":"CloudWatchLog", "documentation":"The CloudWatch Logs configuration for the pentest.
" }, "agentSpaceId":{ "shape":"String", "documentation":"The unique identifier of the agent space that contains the pentest.
" } }, "documentation":"Output for the UpdatePentest operation.
" }, "UpdateTargetDomainInput":{ "type":"structure", "required":[ "targetDomainId", "verificationMethod" ], "members":{ "targetDomainId":{ "shape":"TargetDomainId", "documentation":"The unique identifier of the target domain to update.
" }, "verificationMethod":{ "shape":"DomainVerificationMethod", "documentation":"The updated verification method for the target domain.
" } }, "documentation":"Input for updating a target domain.
" }, "UpdateTargetDomainOutput":{ "type":"structure", "required":[ "targetDomainId", "domainName", "verificationStatus" ], "members":{ "targetDomainId":{ "shape":"TargetDomainId", "documentation":"The unique identifier of the target domain.
" }, "domainName":{ "shape":"String", "documentation":"The domain name of the target domain.
" }, "verificationStatus":{ "shape":"TargetDomainStatus", "documentation":"The current verification status of the target domain.
" }, "verificationStatusReason":{ "shape":"String", "documentation":"The reason for the current target domain verification status.
" }, "verificationDetails":{ "shape":"VerificationDetails", "documentation":"The updated verification details for the target domain.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the target domain was created, in UTC format.
" }, "verifiedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the target domain was verified, in UTC format.
" } }, "documentation":"Output for the UpdateTargetDomain operation.
" }, "UriList":{ "type":"list", "member":{"shape":"String"} }, "UserConfig":{ "type":"structure", "members":{ "role":{ "shape":"UserRole", "documentation":"The role assigned to the user. Currently, only MEMBER is supported.
" } }, "documentation":"The configuration for a user membership, including the role assigned to the user within the agent space.
" }, "UserMetadata":{ "type":"structure", "required":[ "username", "email" ], "members":{ "username":{ "shape":"String", "documentation":"The username of the user.
" }, "email":{ "shape":"SensitiveEmail", "documentation":"The email address of the user.
" } }, "documentation":"Contains metadata about a user member, including the username and email address.
" }, "UserRole":{ "type":"string", "documentation":"Role of a user member associated to an agent space.
", "enum":["MEMBER"] }, "ValidationException":{ "type":"structure", "required":["message"], "members":{ "message":{ "shape":"String", "documentation":"A summary of the validation failure.
" }, "fieldList":{ "shape":"ValidationExceptionFieldList", "documentation":"A list of specific failures encountered during validation.
" } }, "documentation":"The input fails to satisfy the constraints specified by the service.
", "exception":true }, "ValidationExceptionField":{ "type":"structure", "required":[ "path", "message" ], "members":{ "path":{ "shape":"String", "documentation":"A JSONPointer expression to the structure member whose value failed to satisfy the modeled constraint.
" }, "message":{ "shape":"String", "documentation":"A detailed description of the validation failure.
" } }, "documentation":"Describes one specific validation failure for an input member.
" }, "ValidationExceptionFieldList":{ "type":"list", "member":{"shape":"ValidationExceptionField"} }, "VerificationDetails":{ "type":"structure", "members":{ "method":{ "shape":"DomainVerificationMethod", "documentation":"The verification method used for the target domain.
" }, "dnsTxt":{ "shape":"DnsVerification", "documentation":"The DNS TXT verification details.
" }, "httpRoute":{ "shape":"HttpVerification", "documentation":"The HTTP route verification details.
" } }, "documentation":"Contains the verification details for a target domain, including the verification method and provider-specific details.
" }, "VerifyTargetDomainInput":{ "type":"structure", "required":["targetDomainId"], "members":{ "targetDomainId":{ "shape":"TargetDomainId", "documentation":"The unique identifier of the target domain to verify.
" } }, "documentation":"Input for verifying ownership for a registered target domain in an agent space.
" }, "VerifyTargetDomainOutput":{ "type":"structure", "members":{ "targetDomainId":{ "shape":"TargetDomainId", "documentation":"The unique identifier of the target domain.
" }, "domainName":{ "shape":"String", "documentation":"The domain name of the target domain.
" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the target domain was created, in UTC format.
" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the target domain was last updated, in UTC format.
" }, "verifiedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The date and time the target domain was verified, in UTC format.
" }, "status":{ "shape":"TargetDomainStatus", "documentation":"The verification status of the target domain.
" }, "verificationStatusReason":{ "shape":"String", "documentation":"The reason for the current target domain verification status.
" } }, "documentation":"Output for verifying ownership for a registered target domain in an agent space.
" }, "VpcArn":{ "type":"string", "documentation":"ARN or ID of a VPC.
" }, "VpcConfig":{ "type":"structure", "members":{ "vpcArn":{ "shape":"VpcArn", "documentation":"The Amazon Resource Name (ARN) of the VPC.
" }, "securityGroupArns":{ "shape":"SecurityGroupArns", "documentation":"The Amazon Resource Names (ARNs) of the security groups for the VPC configuration.
" }, "subnetArns":{ "shape":"SubnetArns", "documentation":"The Amazon Resource Names (ARNs) of the subnets for the VPC configuration.
" } }, "documentation":"The VPC configuration for a pentest, specifying the VPC, security groups, and subnets to use during testing.
" }, "VpcConfigs":{ "type":"list", "member":{"shape":"VpcConfig"} } }, "documentation":"AWS Security Agent is a frontier agent that proactively secures your applications throughout the development lifecycle. It conducts automated security reviews tailored to your organizational requirements and delivers context-aware penetration testing on demand. By continuously validating security from design to deployment, AWS Security Agent helps prevent vulnerabilities early across all your environments. Key capabilities include design security review for architecture documents, code security review for pull requests in connected repositories, and on-demand penetration testing that discovers, validates, and remediates security vulnerabilities through tailored multi-step attack scenarios. For more information, see the AWS Security Agent User Guide.
" }