AWS Security Agent
AWS Security Agent is a frontier agent that proactively secures your applications throughout the development lifecycle. It conducts automated security reviews…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
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 .
Endpoints 96
Agent space
- POSTBatch get agent spaces
/BatchGetAgentSpacesRetrieves information about one or more agent spaces. - POSTCreate agent space
/CreateAgentSpaceCreates a new agent space. An agent space is a dedicated workspace for securing a specific application. - POSTDelete agent space
/DeleteAgentSpaceDeletes an agent space and all of its associated resources, including pentests, findings, and artifacts. - POSTList agent spaces
/ListAgentSpacesReturns a paginated list of agent space summaries in your account. - POSTUpdate agent space
/UpdateAgentSpaceUpdates the configuration of an existing agent space, including its name, description, AWS resources, target domains, and code review settings.
Target domain
- POSTBatch get target domains
/BatchGetTargetDomainsRetrieves information about one or more target domains. - POSTCreate target domain
/CreateTargetDomainCreates 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. - POSTDelete target domain
/DeleteTargetDomainDeletes a target domain registration. After deletion, the domain can no longer be used for penetration testing. - POSTList target domains
/ListTargetDomainsReturns a paginated list of target domain summaries in your account. - POSTUpdate target domain
/UpdateTargetDomainUpdates the verification method for a target domain.
Application
- POSTCreate application
/CreateApplicationCreates a new application. An application is the top-level organizational unit that supports IAM Identity Center integration. - POSTDelete application
/DeleteApplicationDeletes an application and its associated configuration, including IAM Identity Center settings. - POSTGet application
/GetApplicationRetrieves information about an application. - POSTList applications
/ListApplicationsReturns a paginated list of application summaries in your account. - POSTUpdate application
/UpdateApplicationUpdates the configuration of an existing application, including the IAM role and default KMS key.
Integration
- POSTCreate integration
/CreateIntegrationCreates a new integration with a third-party provider, such as GitHub, for code review and remediation. - POSTDelete integration
/DeleteIntegrationDeletes an integration with a third-party provider. - POSTGet integration
/GetIntegrationRetrieves information about an integration. - POSTList integrations
/ListIntegrationsLists the integrations in your account, optionally filtered by provider or provider type. - POSTUpdate integration
/UpdateIntegrationCreates an integration's webhook, or rotates the HMAC signing secret of an existing one. The secret is returned only once, in this response, and cannot be…
Private connection
- POSTCreate private connection
/CreatePrivateConnectionCreates a private connection for reaching a self-hosted provider instance over private networking using Amazon VPC Lattice. - POSTDelete private connection
/DeletePrivateConnectionDeletes a private connection. - POSTDescribe private connection
/DescribePrivateConnectionRetrieves the details of a private connection. - POSTList private connections
/ListPrivateConnectionsLists the private connections in your account. - POSTUpdate private connection certificate
/UpdatePrivateConnectionCertificateUpdates the certificate associated with a private connection. Certificates can be added or replaced but not removed.
Security requirement pack
- POSTCreate security requirement pack
/CreateSecurityRequirementPackCreates a customer managed security requirement pack. - POSTDelete security requirement pack
/DeleteSecurityRequirementPackDeletes a customer managed security requirement pack and all its associated security requirements. - POSTGet security requirement pack
/GetSecurityRequirementPackRetrieves information about a security requirement pack. - POSTList security requirement packs
/ListSecurityRequirementPacksLists all security requirement packs in the caller's account. - POSTUpdate security requirement pack
/UpdateSecurityRequirementPackUpdates a security requirement pack. For customer managed packs, both metadata and status can be updated. For AWS managed packs, only status can be updated.
- POSTAdd artifact
/AddArtifactUploads an artifact to an agent space. Artifacts provide additional context for security testing, such as architecture diagrams, API specifications, or… - POSTBatch create security requirements
/BatchCreateSecurityRequirementsBatch creates security requirements in a customer managed pack. - POSTBatch delete code reviews
/BatchDeleteCodeReviewsDeletes one or more code reviews from an agent space. - POSTBatch delete pentests
/BatchDeletePentestsDeletes one or more pentests from an agent space. - POSTBatch delete security requirements
/BatchDeleteSecurityRequirementsBatch deletes security requirements from a customer managed pack. - POSTBatch delete threat models
/BatchDeleteThreatModelsDeletes one or more threat models from an agent space. - POSTBatch disassociate finding issue
/BatchDisassociateFindingIssueDisassociates a batch of findings from their linked issues. - POSTBatch export findings
/BatchExportFindingsExports a batch of findings to the connected issue tracker as issues. - POSTBatch get artifact metadata
/BatchGetArtifactMetadataRetrieves metadata for one or more artifacts in an agent space. - POSTBatch get code review job tasks
/BatchGetCodeReviewJobTasksRetrieves information about one or more tasks within a code review job. - POSTBatch get code review jobs
/BatchGetCodeReviewJobsRetrieves information about one or more code review jobs in an agent space. - POSTBatch get code reviews
/BatchGetCodeReviewsRetrieves information about one or more code reviews in an agent space. - POSTBatch get findings
/BatchGetFindingsRetrieves information about one or more security findings in an agent space. - POSTBatch get pentest job tasks
/BatchGetPentestJobTasksRetrieves information about one or more tasks within a pentest job. - POSTBatch get pentest jobs
/BatchGetPentestJobsRetrieves information about one or more pentest jobs in an agent space. - POSTBatch get pentests
/BatchGetPentestsRetrieves information about one or more pentests in an agent space. - POSTBatch get security requirements
/BatchGetSecurityRequirementsBatch retrieves security requirements from a pack. - POSTBatch get threat model job tasks
/BatchGetThreatModelJobTasksRetrieves information about one or more tasks within a threat model job. - POSTBatch get threat model jobs
/BatchGetThreatModelJobsRetrieves information about one or more threat model jobs in an agent space. - POSTBatch get threat models
/BatchGetThreatModelsRetrieves information about one or more threat models in an agent space. - POSTBatch get threats
/BatchGetThreatsRetrieves information about one or more threats. - POSTBatch update security requirements
/BatchUpdateSecurityRequirementsBatch updates security requirements within a customer managed pack. - POSTCreate code review
/CreateCodeReviewCreates a new code review configuration in an agent space. A code review defines the parameters for automated security-focused code analysis. - POSTCreate membership
/CreateMembershipCreates a new membership, granting a user or group access to an agent space within an application. - POSTCreate pentest
/CreatePentestCreates a new pentest configuration in an agent space. A pentest defines the security test parameters, including target assets, risk type exclusions, and… - POSTCreate threat
/CreateThreatCreates a new threat under a threat model job. - POSTCreate threat model
/CreateThreatModelCreates a new threat model configuration in an agent space. A threat model defines the parameters for automated threat analysis. - POSTDelete artifact
/DeleteArtifactDeletes an artifact from an agent space. - POSTDelete membership
/DeleteMembershipDeletes a membership, revoking a user's or group's access to an agent space. - POSTGet artifact
/GetArtifactRetrieves an artifact from an agent space. - POSTImport security requirements
/ImportSecurityRequirementsImports security requirements from uploaded documents into a customer managed security requirement pack. The import process asynchronously extracts and… - POSTInitiate provider registration
/oauth2/provider/registerInitiates the OAuth registration flow with a third-party provider. Returns a redirect URL and CSRF state token for completing the authorization. - POSTList actor messages
/ListActorMessagesReturns a paginated list of the email MFA messages received for an actor at its server-generated email address, most recent first. - POSTList artifacts
/ListArtifactsReturns a paginated list of artifact summaries for the specified agent space. - POSTList code review job tasks
/ListCodeReviewJobTasksReturns a paginated list of task summaries for the specified code review job, optionally filtered by step name or category. - POSTList code review jobs for code review
/ListCodeReviewJobsForCodeReviewReturns a paginated list of code review job summaries for the specified code review configuration. - POSTList code reviews
/ListCodeReviewsReturns a paginated list of code review summaries for the specified agent space. - POSTList discovered endpoints
/ListDiscoveredEndpointsReturns a paginated list of endpoints discovered during a pentest job execution. - POSTList findings
/ListFindingsLists the security findings for a pentest job. - POSTList integrated resources
/ListIntegratedResourcesLists the integrated resources for an agent space, optionally filtered by integration or resource type. - POSTList memberships
/ListMembershipsReturns a paginated list of membership summaries for the specified agent space within an application. - POSTList pentest job tasks
/ListPentestJobTasksReturns a paginated list of task summaries for the specified pentest job, optionally filtered by step name or category. - POSTList pentest jobs for pentest
/ListPentestJobsForPentestReturns a paginated list of pentest job summaries for the specified pentest configuration. - POSTList pentests
/ListPentestsReturns a paginated list of pentest summaries for the specified agent space. - POSTList security requirements
/ListSecurityRequirementsLists security requirements within a pack. - GETList tags for resource
/tags/:resourceArnReturns the tags associated with the specified resource. - POSTTag resource
/tags/:resourceArnAdds tags to a resource. - DELETEUntag resource
/tags/:resourceArn?tagKeys=Removes tags from a resource. - POSTList threat model job tasks
/ListThreatModelJobTasksReturns a paginated list of task summaries for the specified threat model job. - POSTList threat model jobs
/ListThreatModelJobsReturns a paginated list of threat model job summaries for the specified threat model. - POSTList threat models
/ListThreatModelsReturns a paginated list of threat model summaries for the specified agent space. - POSTList threats
/ListThreatsReturns a paginated list of threats for a threat model job. - POSTStart code remediation
/StartCodeRemediationInitiates code remediation for one or more security findings. This creates pull requests in integrated repositories to fix the identified vulnerabilities. - POSTStart code review job
/StartCodeReviewJobStarts a new code review job for a code review configuration. The job executes the security-focused code analysis defined in the code review. - POSTStart pentest job
/StartPentestJobStarts a new pentest job for a pentest configuration. The job executes the security tests defined in the pentest. - POSTStart threat model job
/StartThreatModelJobStarts a new threat model job for a threat model configuration. - POSTStop code review job
/StopCodeReviewJobStops a running code review job. The job transitions to a stopping state and then to stopped after cleanup completes. - POSTStop pentest job
/StopPentestJobStops a running pentest job. The job transitions to a stopping state and then to stopped after cleanup completes. - POSTStop threat model job
/StopThreatModelJobStops a running threat model job. - POSTUpdate code review
/UpdateCodeReviewUpdates an existing code review configuration. - POSTUpdate finding
/UpdateFindingUpdates the status or risk level of a security finding. - POSTUpdate integrated resources
/UpdateIntegratedResourcesUpdates the integrated resources for an agent space, including their capabilities. - POSTUpdate pentest
/UpdatePentestUpdates an existing pentest configuration. - POSTUpdate threat
/UpdateThreatUpdates a threat. - POSTUpdate threat model
/UpdateThreatModelUpdates an existing threat model configuration. - POSTVerify target domain
/VerifyTargetDomainInitiates verification of a target domain. This checks whether the domain ownership verification token has been properly configured.
API details
- Base URL
https://securityagent.{region}.amazonaws.com- Authentication
- AWS Signature Version 4 (requests signed with your AWS access key)
- Operations
- 96 operations on 94 pathsPOST 94GET 1DELETE 1
- Main resources
- Agent space 5Application 5Integration 5Private connection 5Security requirement pack 5Target domain 5
- Description format
- AWS Smithy model, API version
2025-09-06 - Links
- Documentation · OpenAPI document
- Listed from
- AWS Smithy API model (aws/api-models-aws) (Apache-2.0)
How to test the AWS Security Agent in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the AWS Security Agent collection, without the publisher's secrets.
- Add your credentialsThis API uses AWS Signature Version 4 (requests signed with your AWS access key). Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Batch get agent spaces” (POST /BatchGetAgentSpaces), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the AWS Security Agent?
AWS Security Agent is a frontier agent that proactively secures your applications throughout the development lifecycle. It conducts automated security reviews… It is listed under Identity & security and has 96 endpoints.
Who publishes the AWS Security Agent?
It is listed from Amazon Web Services, Inc.'s public API description (an OpenAPI document), not published by Amazon Web Services, Inc. on Swastik Codes. Anyone who controls amazonaws.com can claim the profile by adding a DNS TXT record.
What is the base URL of the AWS Security Agent?
Requests go to https://securityagent.{region}.amazonaws.com. Endpoint paths are added to this base URL.
How do I authenticate with the AWS Security Agent?
With AWS Signature Version 4 (requests signed with your AWS access key).
How many endpoints does the AWS Security Agent have?
96 operations on 94 paths (94 POST, 1 GET, 1 DELETE). The largest groups are Agent space, Application, Integration, Private connection.
Is forking the AWS Security Agent free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.