---
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[]
- `sort.field` 'list_sort_field_unspecified' | 'list_sort_field_created_at' | 'list_sort_field_last_modified_at' | 'list_sort_field_name' | 'list_sort_field_title'
- `sort.direction` 'list_sort_direction_unspecified' | 'list_sort_direction_asc' | 'list_sort_direction_desc'
- `sort_by` string — REST-friendly alias for sort.field. Supported values: created_at, last_modified_at, name, title.
- `sort_direction` string — REST-friendly alias for sort.direction. Supported values: asc, desc.

## 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/revisions/61436a496404/schema)