---
title: "Get prompts by project"
method: GET
path: "/v1/private/projects/{projectId}/prompts"
tags: ["Projects"]
---

# Get prompts by project

`GET /v1/private/projects/{projectId}/prompts`

Get prompts scoped to a project

## Path parameters

- `projectId` string, uuid, required

## Query parameters

- `page` integer
- `size` integer
- `name` string — Filter prompts by name (partial match, case insensitive)
- `sorting` string
- `filters` string

## Response `200`

OK

- PromptPagePublic
  - `page` integer
  - `size` integer
  - `total` integer
  - `content` PromptPublic[]
    - `id` string, uuid
    - `name` string, required
    - `project_id` string, uuid — Project ID. Takes precedence over project_name when both are provided.
    - `description` string
    - `template_structure` 'text' | 'chat' — Template structure type: 'text' or 'chat'. Immutable after creation.
    - `tags` string[]
    - `created_at` string, date-time
    - `created_by` string
    - `last_updated_at` string, date-time
    - `last_updated_by` string
    - `version_count` integer
  - `sortableBy` string[]

---

[API](https://skmtc.net/comet-ml/apis/opik-rest-api.md) · [All operations](https://skmtc.net/comet-ml/apis/opik-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/comet-ml/opik-rest-api/versions/4ed2fbc97cc3/schema)