Skip to main content
GET
Search project definitions

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
Minimum string length: 1

Query Parameters

runtime_target_kind
enum<string> | null
Available options:
main_branch,
environment,
preview_branch,
null
target_environment_id
string<uuid> | null
target_branch_id
string<uuid> | null
source_target_kind
enum<string>
Available options:
project,
main_branch,
environment,
preview_branch
identity
string

Exact definition ID or display name. Omit to browse.

Required string length: 1 - 4096
kinds
enum<string>[]
Required array length: 1 - 10 elements
Available options:
agent,
prompt,
tool,
task,
workflow,
resource,
skill,
eval,
schedule,
webhook
limit
integer
Required range: 1 <= x <= 50
cursor
string
Required string length: 1 - 512

Response

Definition identities and source coverage

data
object[]
required

Saved project source definitions, not executable tools. A display name does not establish its kind; read a definition with its reader operation and identity.

Maximum array length: 50
total_matches
integer
required
Required range: x >= 0
page_info
object
required
resolution
enum<string>
required

Lookup result for the requested kinds at the selected source target. not_found means no matching identity in those kinds only when their coverage is complete; it does not rule out other kinds or targets.

Available options:
listed,
found,
ambiguous,
not_found,
incomplete
coverage
object[]
required

Discovery coverage for the requested kinds at the selected source target.

source_selection
object
required
suggested_query
object

For a complete miss with an explicit kind filter, retry this exact identity and source target without kinds. This does not imply a match exists in another kind.

kind_filter_miss
object

Present when the identity was absent from the requested kinds but exists in another kind. data, coverage, resolution and page_info then describe the unfiltered lookup; use each match kind and reader, not the requested kinds. To continue, re-send the same query (with or without kinds) and page_info.next; the widening is re-applied.