---
title: "ListPrompts"
method: GET
path: "/v2/prompts"
tags: ["beta.prompts"]
---

# ListPrompts

`GET /v2/prompts`

ListPrompts

## 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

- ListPromptsResponse
  - `data` Prompt[]
    - `id` string
    - `name` string — Stable object name.
    - `definition` PromptDefinition — Versioned prompt content.
      - `content` string, required — Prompt template content.
      - `variables` PromptVariable[] — Variables used by the prompt.
        - `name` string — Stable object name.
    - `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.
    - `title` string — Display title.
    - `description` string — Display description.
  - `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)