---
title: "POST /CreateCodeReview"
method: POST
path: "/CreateCodeReview"
---

# POST /CreateCodeReview

`POST /CreateCodeReview`

Creates a new code review configuration in an agent space. A code review defines the parameters for automated security-focused code analysis.

## Request body

- object
  - `title` string, required — The title of the code review.
  - `agentSpaceId` string, required — The unique identifier of the agent space to create the code review in.
  - `assets` object, required — The collection of assets used in a pentest configuration, including endpoints, actors, documents, source code repositories, and integrated repositories.
    - `endpoints` Endpoint[] — The list of endpoints to test during the pentest.
      - `uri` string — The URI of the endpoint.
    - `actors` Actor[] — The list of actors used during penetration testing.
      - `identifier` string — The unique identifier for the actor.
      - `uris` String[] — The list of URIs that the actor targets during testing.
      - `authentication` object — The authentication configuration for the actor.
        - `providerType` 'SECRETS_MANAGER' | 'AWS_LAMBDA' | 'AWS_IAM_ROLE' | 'AWS_INTERNAL' — The type of authentication provider. Valid values include SECRETS_MANAGER, AWS_LAMBDA, AWS_IAM_ROLE, and AWS_INTERNAL.
        - `value` string — The authentication value, such as a secret ARN, Lambda function ARN, or IAM role ARN, depending on the provider type.
      - `description` string — A description of the actor.
    - `documents` DocumentInfo[] — The list of documents that provide context for the pentest.
      - `s3Location` string — The Amazon S3 location of the document.
      - `artifactId` string — The unique identifier of the artifact associated with the document.
      - `integratedDocument` object — A reference to a document in an integrated third-party provider.
        - `integrationId` string, required — The identifier of the integration that provides access to the document.
        - `resourceId` string, required — The provider-specific resource identifier for the document.
    - `sourceCode` SourceCodeRepository[] — The list of source code repositories to analyze during the pentest.
      - `s3Location` string — The Amazon S3 location of the source code repository archive.
    - `integratedRepositories` IntegratedRepository[] — The list of integrated repositories associated with the pentest.
      - `integrationId` string, required — The unique identifier of the integration that provides access to the repository.
      - `providerResourceId` string, required — The provider-specific resource identifier for the repository.
  - `serviceRole` string — ARN of an IAM role that the service can assume to access customer resources.
  - `logConfig` object — The Amazon CloudWatch Logs configuration for pentest job logging.
    - `logGroup` string — The name of the CloudWatch log group.
    - `logStream` string — The name of the CloudWatch log stream.
  - `codeRemediationStrategy` 'AUTOMATIC' | 'DISABLED' — Strategy for automated code remediation.
  - `validationMode` 'DISABLED' | 'SIMULATED' — Mode of validation to perform on findings

## Response `200`

Success

- CreateCodeReviewOutput — Output for the CreateCodeReview operation.
  - `codeReviewId` string, required — The unique identifier of the created code review.
  - `title` string — The title of the code review.
  - `createdAt` string, date-time — The date and time the code review was created, in UTC format.
  - `updatedAt` string, date-time — The date and time the code review was last updated, in UTC format.
  - `assets` object — The assets included in the code review.
    - `endpoints` Endpoint[] — The list of endpoints to test during the pentest.
      - `uri` string — The URI of the endpoint.
    - `actors` Actor[] — The list of actors used during penetration testing.
      - `identifier` string — The unique identifier for the actor.
      - `uris` String[] — The list of URIs that the actor targets during testing.
      - `authentication` object — The authentication configuration for the actor.
        - `providerType` 'SECRETS_MANAGER' | 'AWS_LAMBDA' | 'AWS_IAM_ROLE' | 'AWS_INTERNAL' — The type of authentication provider. Valid values include SECRETS_MANAGER, AWS_LAMBDA, AWS_IAM_ROLE, and AWS_INTERNAL.
        - `value` string — The authentication value, such as a secret ARN, Lambda function ARN, or IAM role ARN, depending on the provider type.
      - `description` string — A description of the actor.
    - `documents` DocumentInfo[] — The list of documents that provide context for the pentest.
      - `s3Location` string — The Amazon S3 location of the document.
      - `artifactId` string — The unique identifier of the artifact associated with the document.
      - `integratedDocument` object — A reference to a document in an integrated third-party provider.
        - `integrationId` string, required — The identifier of the integration that provides access to the document.
        - `resourceId` string, required — The provider-specific resource identifier for the document.
    - `sourceCode` SourceCodeRepository[] — The list of source code repositories to analyze during the pentest.
      - `s3Location` string — The Amazon S3 location of the source code repository archive.
    - `integratedRepositories` IntegratedRepository[] — The list of integrated repositories associated with the pentest.
      - `integrationId` string, required — The unique identifier of the integration that provides access to the repository.
      - `providerResourceId` string, required — The provider-specific resource identifier for the repository.
  - `serviceRole` string — The IAM service role used for the code review.
  - `logConfig` object — The CloudWatch Logs configuration for the code review.
    - `logGroup` string — The name of the CloudWatch log group.
    - `logStream` string — The name of the CloudWatch log stream.
  - `agentSpaceId` string — The unique identifier of the agent space that contains the code review.
  - `codeRemediationStrategy` 'AUTOMATIC' | 'DISABLED' — The code remediation strategy for the code review.
  - `validationMode` 'DISABLED' | 'SIMULATED' — The validation mode for the code review.

---

[API](https://skmtc.net/aws/apis/securityagent.md) · [All operations](https://skmtc.net/aws/apis/securityagent/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/securityagent/versions/cad56717d636/schema)