---
title: "List Prompts"
method: GET
path: "/prompts"
tags: ["Prompts"]
---

# List Prompts

`GET /prompts`

Browse through all your prompts to see what you're using across your AI applications. Returns all prompts by default (both active and inactive versions), or filter by product or version to narrow down the results.

**Filtering & Pagination:**
- Filter by `productId` to see prompts for a specific product
- Filter by `versionId` to see a specific version
- Choose your pagination style: cursor-based (`limit` + `cursor`) or page-based (`page` + `pageSize`)
- Check the `Link` header for easy pagination navigation

**Note:** This returns lightweight data with just component IDs. Use `GET /prompts/:id` to fetch the full prompt content.

## Query parameters

- `limit` number — Page size limit (cursor-based pagination). Use either limit/cursor OR page/pageSize, not both.
- `page` number — Page number (page-based pagination). Use either page/pageSize OR limit/cursor, not both.
- `pageSize` number — Number of items per page (page-based pagination). Use either page/pageSize OR limit/cursor, not both.
- `includeArchived` boolean — Include archived prompts.
- `versionId` string, uuid — Filter prompts by specific version ID.
- `productId` string, uuid — Filter prompts by product ID.
- `activeOnly` boolean — Filter to only show prompts that are part of active versions. When true, only returns prompts associated with versions where isActive=true.

## Response `200`

Prompts retrieved successfully. Check the Link header for pagination URLs (first, prev, next).

- SlimPrompt[] — Array of prompts.
  - `id` string, uuid, required — The Greenflash prompt ID.
  - `externalPromptId` string, nullable, required — Your external identifier for the prompt.
  - `name` string, nullable, required — Prompt name.
  - `versionId` string, uuid, nullable, required — The version ID this prompt is associated with, or null if the prompt is not part of any version.
  - `productId` string, uuid, nullable, required — The product ID this prompt is associated with.
  - `archivedAt` string, nullable, required — ISO 8601 timestamp when archived, or null if active.
  - `createdAt` string, required — ISO 8601 timestamp when created.
  - `updatedAt` string, required — ISO 8601 timestamp when last updated.
  - `components` SlimPromptComponent[], required — Array of prompt component IDs that make up this prompt.
    - `id` string, uuid, required — The Greenflash component ID.
    - `externalComponentId` string, nullable, required — Your external identifier for the component.

## Other responses

- `500` — Server error

## Changes

- **2025-11-24** `c1998d918478` — 1 info
  - api tag `Prompts` added
- **2025-10-29** `f1cd8a0e3bee` — 1 info
  - endpoint added

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

---

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