---
title: "Get Conversation System Prompt"
method: GET
path: "/api/user/conversation/system-prompt"
---

# Get Conversation System Prompt

`GET /api/user/conversation/system-prompt`

Return the system prompt that would be sent on the next turn.

Reconstructed live from current user state (profile, soul, memory,
onboarding status, tool availability) so the UI doesn't show a
stale snapshot from the first turn of the session.

Known approximations:

* The preview omits specialist tool guidelines that get appended
  mid-turn when the LLM calls ``list_capabilities`` to activate a
  category. It matches the start-of-turn tool list, mirroring how
  the agent itself starts each turn fresh.
* Tools whose factories require a storage backend or an outbound
  publish hook (currently ``send_media_reply``,
  ``upload_to_storage``, and ``move_file``) are filtered out
  by the registry's dependency gates because the preview can't
  safely construct those runtime hooks. Their usage hints will
  not appear in the Tool Guidelines section.
* If a user's ``BOOTSTRAP.md`` cannot be created on disk by the
  runtime (rare, requires an OS-level error), the runtime drops
  out of onboarding mode while this preview still reports
  ``is_onboarding=true`` based on the in-memory heuristic.

## Response `200`

Successful Response

- SessionSystemPromptResponse — Live system prompt that would be sent to the LLM on the next turn. Reconstructed on demand from current user state (memory, profile, onboarding status, available tools). The historical first-turn snapshot lives on the ``ChatSession.initial_system_prompt`` column for forensics but is intentionally not exposed via the public API, since it reveals the operator's preamble and tool wiring. Premium deployments additionally gate this endpoint behind an admin guard.
  - `session_id` string, required
  - `system_prompt` string, required
  - `is_onboarding` boolean, required

---

[API](https://skmtc.net/mozilla-ai/apis/clawbolt.md) · [All operations](https://skmtc.net/mozilla-ai/apis/clawbolt/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mozilla-ai/clawbolt/revisions/0e52fe5f8d33/schema)