---
title: "Retrieve a prompt"
method: GET
path: "/api/prompts/{prompt_id}/"
tags: ["prompts"]
---

# Retrieve a prompt

`GET /api/prompts/{prompt_id}/`

Retrieve a prompt template by ID, including its current and live versions.

## Path parameters

- `prompt_id` string, required

## Headers

- `Authorization` string, required

## Response `200`

Prompt details.

- PromptsRetrievePromptResponse200
  - `id` string — The unique prompt identifier.
  - `name` string
  - `description` string, nullable
  - `prompt_slug` string, nullable
  - `tags` ApiPromptsPromptIdGetResponsesContentApplicationJsonSchemaTagsItems[]
    - `id` string
    - `name` string
    - `color` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `current_version` ApiPromptsPromptIdGetResponsesContentApplicationJsonSchemaCurrentVersion
    - `version` integer
    - `model` string
    - `updated_at` string, date-time
  - `live_version` ApiPromptsPromptIdGetResponsesContentApplicationJsonSchemaLiveVersion
    - `version` integer
    - `model` string
    - `updated_at` string, date-time
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401` — Unauthorized - Missing/invalid authentication
- `404` — Prompt not found

## Changes

> 6 revisions in range; 3 could not be searched.

- **2026-07-31** `c26d550029f8` — 2 breaking, 2 warning, 84 info
  - the `current_version` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - the `live_version` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - removed the optional property `created_at` from the response with the `200` status
  - removed the optional property `updated_at` from the response with the `200` status
  - …84 more

[Change history](https://skmtc.dev/keywordsai/apis/api-reference/changes/api/prompts/:prompt_id/get.md)

---

[API](https://skmtc.dev/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.dev/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keywordsai/api-reference/revisions/c61efaf24756/schema)