---
title: "Inspect Effective Prompt For Mindview"
method: POST
path: "/inspect-effective-prompt"
tags: ["app"]
---

# Inspect Effective Prompt For Mindview

`POST /inspect-effective-prompt`

## Request

- Base URL: `https://realtime-api.convai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://realtime-api.convai.com/inspect-effective-prompt`
- Auth: none declared

Render an owned character draft for an authorized MindView caller.

## Headers

- `X-API-Key` string, nullable
- `API-AUTH-TOKEN` string, nullable

## Request body

- InspectEffectivePromptRequest: One unsaved draft rendered without writing character state.
  - `inspection_version` 'mindview-effective-prompt-v1'
  - `character` ActionsPromptCharacterDraft, required: Current editor values; this model never writes character state.
    - `character_id` string, nullable
    - `character_name` string
    - `description` string
    - `speaking_style_description` string
    - `speaking_style_sample_dialogues` string
    - `character_traits` object
    - `personality_enabled` boolean
    - `state_of_mind_enabled` boolean
    - `moderation_enabled` boolean
    - `custom_guardrails_enabled` boolean
    - `guardrails_text` string
    - `model_group_name` string, nullable
    - `model_version` integer, nullable
    - `temperature` number
    - `language_codes` string[]
    - `actions_enabled` boolean
    - `actions_contract` string
    - `show_full_unfiltered_llm_output` boolean
    - `character_actions` string[]
    - `looks_description` string
    - `clothes_description` string
    - `custom_prompt` string
    - `is_narrative_driven` boolean
    - `language_hardening_mode` string, nullable
    - `language_hardening_text` string, nullable
  - `action_config` ActionConfig
    - `actions` Action[], nullable
      - `value` string, required
    - `characters` ActionCharacterConfig[], nullable
      - `name` string, required
      - `bio` string, required
    - `objects` ActionObjectConfig[], nullable
      - `name` string, required
      - `description` string, required
    - `current_attention_object` ActionObjectConfig
      - `name` string, required
      - `description` string, required
    - `tools` ClientToolDeclaration[], nullable
      - `name` string, required
      - `description` string, required
      - `inputSchema` object, required
  - `runtime_context` ActionsPromptRuntimeContext: Optional edit-time values for components normally known only at runtime.
    - `dynamic_info` DynamicInfo
      - `text` string
      - `keep_in_context` boolean: Whether to keep this dynamic info static in the context for the session.
    - `scene_description` ActionObjectConfig[], nullable
      - `name` string, required
      - `description` string, required
    - `memory` string, nullable
    - `narrative_prompt` string, nullable
    - `knowledge_base_context` string, nullable
    - `vision_available` boolean, nullable
    - `vision_prompt_mode` 'auto' | 'disabled'
    - `provider_mode` 'discrete' | 'realtime', nullable

## Response `200`

Successful Response

- InspectEffectivePromptResponse
  - `inspection_version` 'mindview-effective-prompt-v1'
  - `completeness` 'static_complete' | 'runtime_context_partial', required
  - `effective_prompt` EffectivePromptContent, required
    - `content` string, required
    - `sha256` string, required
    - `character_count` integer, required
    - `render_mode` 'combined_json' | 'realtime_tools' | 'natural_text', required
    - `provider_assumption` 'discrete' | 'realtime', required
    - `resolved_model_group_name` string, required
    - `resolved_model_version` integer, nullable
    - `resolved_provider` string, required
    - `resolved_model` string, required
  - `sources` EffectivePromptSource[], required
    - `order` integer, required
    - `field_path` string, required
    - `source_section` string, required
    - `origin` 'character' | 'core' | 'runtime', required
    - `layer` 'static_system' | 'static_cache' | 'dynamic_context' | 'chat', required
    - `status` 'present'
    - `content` string, required
    - `effect` string, required
    - `precedence` string, required
  - `unavailable_runtime_sources` UnavailableRuntimeSource[], required
    - `field_path` string, required
    - `source_section` string, required
    - `status` 'runtime_placeholder'
    - `reason` string, required
    - `effect` string, required
    - `precedence` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-23** `4361c107ef49`: 2 info
  - added the new optional request property `character/model_version`
  - added the optional property `effective_prompt/resolved_model_version` to the response with the `200` status
- **2026-09-17** `3c8632f2dc7b`: 2 info
  - added the new optional request property `character/language_hardening_mode`
  - added the new optional request property `character/language_hardening_text`
- **2026-09-04** `f44933ff97dc`: 1 info
  - added the new optional request property `runtime_context/anyOf[subschema #1: ActionsPromptRuntimeContext]/vision_prompt_mode`
- **2026-08-31** `6d7137301537`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/convai/apis/convai-api/changes/inspect-effective-prompt/post.md)

---

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