---
title: "Get skill version"
method: GET
path: "/api/skills/{skillId}/versions/{versionId}"
tags: ["Skills"]
---

# Get skill version

`GET /api/skills/{skillId}/versions/{versionId}`

## Request

- Base URL: `https://app.cotool.ai`
- URL: `https://app.cotool.ai/api/skills/{skillId}/versions/{versionId}`
- Auth: HTTP bearer

Get one specific skill version with references.

## Path parameters

- `skillId` string, uuid, required: Unique identifier for the skill
- `versionId` string, uuid, required: Unique identifier for the skill version

## Response `200`

Successful response

- object
  - `id` string, uuid, required: Unique identifier for the skill version
  - `skillId` string, uuid, required: Parent skill ID
  - `version` integer, required: Monotonic version number for the skill
  - `createdByUserId` string, nullable, required: User who created this version, if available
  - `createdAt` string, required: Timestamp when this version was created
  - `instructionPrompt` string, required: Instruction content for this specific version
  - `requiredTools` string[], required: Required tools snapshot for this specific version
  - `references` object[], required: References attached to this specific version
    - `id` string, uuid, required: Unique identifier for the reference file record
    - `skillVersionId` string, uuid, required: Version ID this reference belongs to
    - `filename` string, required: Relative path from skill root (for example references/guide.md)
    - `directory` 'references' | 'assets' | 'scripts', required: Top-level skill directory where this file resides
    - `sizeBytes` integer, required: UTF-8 byte size of the file content
    - `content` string: Optional file content (included in version detail / export flows)
    - `createdAt` string: Timestamp when this file was stored

## Other responses

- `400`: Bad request — input validation failed or the request was malformed
- `401`: Unauthorized — missing or invalid API key / session
- `403`: Forbidden — the authenticated user lacks the required permissions
- `500`: Internal server error

---

[API](https://skmtc.dev/cotool/apis/cotool-api.md) - [All operations](https://skmtc.dev/cotool/apis/cotool-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cotool/apis/cotool-api/revisions/f5abe0add203?raw)