---
title: "GetPrompt"
method: GET
path: "/v2/prompts/{prompt_id}"
tags: ["beta.prompts"]
---

# GetPrompt

`GET /v2/prompts/{prompt_id}`

## Request

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

GetPrompt

## Path parameters

- `prompt_id` string, required

## Query parameters

- `version` integer
- `alias` string
- `fields` string[]

## Response `200`

Success

- 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.
  - `createdBy` string
  - `versionCreatedAt` string, date-time: RFC 3339 timestamp.

## Changes

- **2026-09-23** `fa73befe1c61`: 2 info
  - added the optional property `createdBy` to the response with the `200` status
  - added the optional property `versionCreatedAt` to the response with the `200` status
- **2026-07-13** `5a5c361558bb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mistral/apis/mistral-ai-api/changes/v2/prompts/:prompt_id/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)