---
title: "Scan Skill"
method: POST
path: "/api/scan/skills/{skill_ref}"
---

# Scan Skill

`POST /api/scan/skills/{skill_ref}`

## Path parameters

- `skill_ref` string, required

## Request body

- ScanOptionsRequest
  - `awsProfile` string, nullable
  - `awsRegion` string, nullable
  - `awsSessionToken` string, nullable
  - `llmApiKey` string, nullable
  - `llmApiVersion` string, nullable
  - `llmBaseUrl` string, nullable
  - `llmConsensusRuns` integer
  - `llmMaxTokens` integer
  - `llmModel` string, nullable
  - `llmProvider` string, nullable
  - `useLlm` boolean

## Response `200`

Successful Response

- ScanResultResponse
  - `analyzersUsed` string[], required
  - `durationSeconds` number, required
  - `findings` ScanFindingResponse[], required
    - `analyzer` string, nullable
    - `category` string, required
    - `description` string, required
    - `filePath` string, nullable
    - `id` string, required
    - `lineNumber` integer, nullable
    - `metadata` object
    - `remediation` string, nullable
    - `ruleId` string, required
    - `severity` string, required
    - `snippet` string, nullable
    - `title` string, required
  - `findingsCount` integer, required
  - `isSafe` boolean, required
  - `maxSeverity` string, required
  - `skillName` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mode-io/apis/skill-manager.md) · [All operations](https://skmtc.net/mode-io/apis/skill-manager/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mode-io/skill-manager/versions/a2b29a5aa8b4/schema)