---
title: "Get Agent Prompt Preview"
method: GET
path: "/api/agents/{agent_id}/prompt-preview"
tags: ["agents"]
---

# Get Agent Prompt Preview

`GET /api/agents/{agent_id}/prompt-preview`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/agents/{agent_id}/prompt-preview`
- Auth: none declared

Show what this identity's next system prompt is actually built from.

## Path parameters

- `agent_id` string, uuid, required

## Headers

- `x-impersonate-identity-id` string, nullable

## Response `200`

Successful Response

- PromptPreviewResponse: The identity's assembled system prompt, read-only (TOS-2077).
  - `identity_id` string, uuid, required
  - `display_name` string, required
  - `provider` string, required
  - `model` string, required
  - `stable_text` string, required
  - `volatile_placeholders` PromptPreviewPlaceholder[], required
    - `name` string, required
    - `description` string, required
  - `constitution_budget_tokens` integer, required
  - `constitution_clamped` boolean, required
  - `measured_at` string, date-time, nullable, required
  - `usage` PromptPreviewSection[], required
    - `source` string, required
    - `status` string, required
    - `estimated_tokens` integer, required
    - `budget_tokens` integer, required
    - `reason` string, required

## Other responses

- `422`: Validation Error

---

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