---
title: "ListSkillVersions"
method: GET
path: "/v2/skills/{skill_id}/versions"
tags: ["beta.skills"]
---

# ListSkillVersions

`GET /v2/skills/{skill_id}/versions`

## Request

- Base URL: `https://api.mistral.ai`
- URL: `https://api.mistral.ai/v2/skills/{skill_id}/versions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/mistral/apis/mistral-ai-api/docs/v2/skills/:skill_id/versions/get.ts> (a function with typed inputs; its response is checked against the schema)

ListSkillVersions

## Path parameters

- `skill_id` string, required

## Response `200`

Success

- ListSkillVersionsResponse
  - `data` SkillVersion[]
    - `version` integer
    - `definition` SkillDefinition: Versioned skill content.
      - `description` string: Model-facing trigger and usage description.
      - `body` string: Skill body content.
      - `assets` object: Additional files available to the skill.
    - `notes` string: Notes for this version.
    - `aliases` string[]: Aliases pointing to this version.
    - `createdAt` string, date-time: RFC 3339 timestamp.

## Changes

- **2026-07-13** `5a5c361558bb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mistral/apis/mistral-ai-api/changes/v2/skills/:skill_id/versions/get.md)

---

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