---
title: "Prompt List"
method: GET
path: "/api/prompts"
tags: ["API"]
---

# Prompt List

`GET /api/prompts`

## Request

- Base URL: `https://app.asserto.ai`
- URL: `https://app.asserto.ai/api/prompts`
- Auth: none declared

Get all project's prompts. The project is given by its API key.

## Headers

- `authorization` string: API Key in the format: `Authorization: ApiKey <key>`

## Response `200`

Successful Response

- APIPromptList
  - `data` PromptSchema[], required
    - `slug` string, required
    - `messages` MCPPromptMessage[], required
      - `role` string, required
      - `content` ContentText, required
        - `type` 'text', required
        - `text` string, required
    - `model` ModelInfo, required
      - `id` integer, nullable
      - `name` string, required
      - `kind` 'system' | 'custom', required
      - `provider` string, required
      - `url` string, nullable
      - `config` object, nullable
      - `pricing` LLMPricing: Pricing in USD per 1M tokens
        - `tkInput` string, required
        - `tkOutput` string, required
        - `tkCacheWrite` string, nullable
        - `tkCacheRead` string, nullable
    - `genParams` GenerationParams, required
      - `temperature` number
    - `respFormat` string, required
    - `outputSchema` SchemaJsonFormat: Schema for response when using response format json_schema
      - `name` string, required: Schema name. Must match pattern: ^[a-zA-Z0-9_-]+$
      - `description` string, nullable: A brief description of the Schema.
      - `schema` SchemaJsonProperties, required
        - `type` 'object'
        - `properties` object, required: Dictionary of parameter names to their definitions.
        - `required` string[]: List of required parameters.
        - `additionalProperties` boolean: Indicates if additional properties are allowed.
      - `strict` boolean
    - `variables` string[]
    - `tools` MCPToolDef[], nullable, required
      - `name` string, required
      - `description` string
      - `inputSchema` MCPToolInputSchema, required
        - `type` 'object'
        - `properties` object, required
        - `required` string[], required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/asserto/apis/asserto-ai-api.md) - [All operations](https://skmtc.dev/asserto/apis/asserto-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/asserto/apis/asserto-ai-api/revisions/ccafa6c11b48?raw)