---
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[]

## 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/versions/933c4ebdcd72/schema)