---
title: "ListSkills"
method: GET
path: "/v2/skills"
tags: ["beta.skills"]
---

# ListSkills

`GET /v2/skills`

ListSkills

## Query parameters

- `pageSize` integer
- `pageToken` string
- `alias` string
- `fields` string[]

## Response `200`

Success

- ListSkillsResponse
  - `data` Skill[]
    - `id` string
    - `name` string — Stable object name.
    - `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.
    - `version` integer
    - `notes` string — Notes for this version.
    - `aliases` string[] — Aliases pointing to this version.
    - `sharingScope` 'sharing_scope_unspecified' | 'private' | 'workspace'
    - `createdAt` string, date-time — RFC 3339 timestamp.
    - `updatedAt` string, date-time — RFC 3339 timestamp.
    - `latestVersion` integer — Latest version number.
  - `nextPageToken` string

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/versions/933c4ebdcd72/schema)