Prompt Store
Manage app-scoped templates. Prompt content remains live independently of QuilrQL; in app configuration, prompts.require_system_from_store controls enforcement and prompts.universal_system_prompt holds the app's universal system prompt.
PUT creates a missing prompt (201) or replaces an existing prompt (200). It preserves other prompts/settings. Create-only prompt preconditions are Not Generally Available; If-None-Match is not implemented as a create-only guard. DELETE returns 200 with prompt:null, prompt_id, the updated app version and request_id.
Reads return prompt content and the current app version. A change to any versioned app setting can invalidate a prompt-write precondition. Re-read before reconciling 412 conflicts.
{
"content": "You help customers with support questions. Use supplied account context and do not invent account details."
}
Prompt content is visible to keys with read. For runtime references and variables, see Prompt Store.
Universal system prompt
The universal system prompt is an app setting rather than a prompt resource. Set it with PATCH /llmgateway/management/v1/apps/{app_name} (scope config:write, current app ETag in If-Match):
{
"prompts": {
"universal_system_prompt": {
"enabled": true,
"content": "You are Acme's support assistant. Never share internal URLs."
}
}
}
A partial object merges with the stored value: {"prompts": {"universal_system_prompt": {"enabled": false}}} turns it off and keeps the text. content is at most 100,000 characters, and enabling it with empty content returns 400 (invalid_configuration). App reads return prompts.universal_system_prompt as {"enabled": ..., "content": ...}, and rollback restores it with the rest of the app configuration. While the Policy Engine is on for the LLM Gateway, the write is saved but not enforced: the response carries an inactive_under_quilrql warning naming prompts.universal_system_prompt, and policies decide the prompt. For how the gateway applies it, see Universal system prompt.
/apps/{app_name}/promptsList prompts
Stored prompts of the app, sorted by prompt_id, with the app version.
readAlso at /app/prompts?app_name=... for app names that contain / or %.
Path, query & header parameters 3
app_name (path)stringrequiredExact app name, URL-encoded.
limit (query)integeroptionalPage size.
cursor (query)stringoptionalOpaque cursor from the previous page's next_cursor.
No request body.
curl --request GET \
'https://guardrails-usa-1.quilr.ai/llmgateway/management/v1/apps/Support%20Bot/prompts?limit=50' \
--header 'Authorization: Bearer <management-key>'
Authentication, errors & retry rules Try it in the playground
/apps/{app_name}/prompts/{prompt_id}Delete a prompt
Deletes a stored prompt. Uses the app ETag.
config:writeAlso at /app/prompts/{prompt_id}?app_name=... for app names that contain / or %.
Path, query & header parameters 3
app_name (path)stringrequiredExact app name, URL-encoded.
prompt_id (path)stringrequiredIf-Match (header)stringrequiredQuoted version from the latest read of the resource. Prompt, attachment, conversion and rollback writes use the app version.
Full request body specification application/json
Unknown fields are rejected in this object.
curl --request DELETE \
'https://guardrails-usa-1.quilr.ai/llmgateway/management/v1/apps/Support%20Bot/prompts/support' \
--header 'Authorization: Bearer <management-key>' \
--header 'If-Match: "3f1c0a9e5b7d"'
Authentication, errors & retry rules Try it in the playground
/apps/{app_name}/prompts/{prompt_id}Read a prompt
One stored prompt and the app version.
readAlso at /app/prompts/{prompt_id}?app_name=... for app names that contain / or %.
Path, query & header parameters 2
app_name (path)stringrequiredExact app name, URL-encoded.
prompt_id (path)stringrequiredNo request body.
curl --request GET \
'https://guardrails-usa-1.quilr.ai/llmgateway/management/v1/apps/Support%20Bot/prompts/support' \
--header 'Authorization: Bearer <management-key>'
Authentication, errors & retry rules Try it in the playground
/apps/{app_name}/prompts/{prompt_id}Create or replace a prompt
Creates (201) or replaces (200) a prompt. prompt_id is 1-200 letters, digits, `_` or `-`. Creating a new prompt needs no If-Match; replacing or deleting one uses the app ETag in If-Match (428 without it).
config:writeAlso at /app/prompts/{prompt_id}?app_name=... for app names that contain / or %.
Path, query & header parameters 3
app_name (path)stringrequiredExact app name, URL-encoded.
prompt_id (path)stringrequiredIf-Match (header)stringoptionalQuoted version from the latest read of the resource. Prompt, attachment, conversion and rollback writes use the app version. Optional when creating a new prompt; required (428) to replace an existing one.
Full request body specification application/json
contentstringrequiredUnknown fields are rejected in this object.
curl --request PUT \
'https://guardrails-usa-1.quilr.ai/llmgateway/management/v1/apps/Support%20Bot/prompts/support' \
--header 'Authorization: Bearer <management-key>' \
--header 'If-Match: "3f1c0a9e5b7d"' \
--header 'Content-Type: application/json' \
--data '{
"content": "You help customers with support questions."
}'
Authentication, errors & retry rules Try it in the playground