Skip to main content
GET
List prompts

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Path Parameters

project_reference
string
required

Project slug, UUID, or domain that identifies the project.

Query Parameters

source_target_kind
enum<string>

Source to read prompts from: project, main_branch, environment or preview_branch. Falls back to runtime_target_kind when omitted.

Available options:
project,
main_branch,
environment,
preview_branch
runtime_target_kind
enum<string> | null

Runtime target to read from when source_target_kind is omitted: main_branch, environment or preview_branch.

Available options:
main_branch,
environment,
preview_branch,
null
target_environment_id
string<uuid> | null

Environment to use. Required for the environment target; rejected for any other target.

target_branch_id
string<uuid> | null

Preview branch to use. Required for the preview_branch target; rejected for any other target.

Response

Discovered project prompts

data
object[]
required
page_info
object
required
diagnostics
object[]

Prompt source files that could not be read. REST omits it when there are none.