Skip to main content

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.

InputContract
App locatorEncoded app-name path, or /app/prompts?... with app_name in the query.
prompt_id1-200 characters: letters, digits, hyphens and underscores.
contentNonempty template string. The complete JSON body must fit within 1 MiB.
Creating a new promptNo If-Match needed (201). Sending the app ETag still works.
Replacing or deleting a promptCurrent app ETag in If-Match (428 without it, 412 when stale).

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.

GET/apps/{app_name}/prompts

List prompts

Stored prompts of the app, sorted by prompt_id, with the app version.

REQUIRESread

Also at /app/prompts?app_name=... for app names that contain / or %.

Path, query & header parameters 3
app_name (path)stringrequired

Exact app name, URL-encoded.

limit (query)integeroptional

Page size.

min: 1max: 200default: 50
cursor (query)stringoptional

Opaque 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

DELETE/apps/{app_name}/prompts/{prompt_id}

Delete a prompt

Deletes a stored prompt. Uses the app ETag.

REQUIRESconfig:write

Also at /app/prompts/{prompt_id}?app_name=... for app names that contain / or %.

Path, query & header parameters 3
app_name (path)stringrequired

Exact app name, URL-encoded.

prompt_id (path)stringrequired
If-Match (header)stringrequired

Quoted 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

GET/apps/{app_name}/prompts/{prompt_id}

Read a prompt

One stored prompt and the app version.

REQUIRESread

Also at /app/prompts/{prompt_id}?app_name=... for app names that contain / or %.

Path, query & header parameters 2
app_name (path)stringrequired

Exact app name, URL-encoded.

prompt_id (path)stringrequired

No 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

PUT/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).

REQUIRESconfig:write

Also at /app/prompts/{prompt_id}?app_name=... for app names that contain / or %.

Path, query & header parameters 3
app_name (path)stringrequired

Exact app name, URL-encoded.

prompt_id (path)stringrequired
If-Match (header)stringoptional

Quoted 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

contentstringrequired
min length: 1

Unknown 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