---
title: "POST /codesecurity/scan/start"
method: POST
path: "/codesecurity/scan/start"
---

# POST /codesecurity/scan/start

`POST /codesecurity/scan/start`

Initiates a code security scan on a specified repository.

## Request body

- object
  - `clientToken` string — A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
  - `resource` object, required — Identifies a specific resource in a code repository that will be scanned.
    - `projectId` string — The unique identifier of the project in the code repository.

## Response `200`

Success

- StartCodeSecurityScanResponse
  - `scanId` string — The unique identifier of the initiated scan.
  - `status` 'IN_PROGRESS' | 'SUCCESSFUL' | 'FAILED' | 'SKIPPED' — The current status of the initiated scan.

## Other responses

- `480` — ConflictException
- `481` — AccessDeniedException
- `482` — ValidationException
- `483` — ThrottlingException
- `484` — ResourceNotFoundException
- `485` — InternalServerException

---

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