Skip to main content
GET
Search attachable agent tools

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

source_target_kind
string
target_branch_id
string<uuid> | null
cursor
string

Opaque cursor pointing at the next page. Omit it to read the first page.

limit
integer

Maximum number of compact references to return. Defaults to 20; maximum is 100.

Required range: 1 <= x <= 100
query
string

Focused text query matched against valid tool reference names and descriptions.

Minimum string length: 1
names
string[]

Exact candidate names to return when they are valid for agent tool_ids.

Required array length: 1 - 20 elements

Exact tool reference name to validate.

Minimum string length: 1

Response

Matching attachable tools

Compact schema-free agent tool reference search result.

data
object[]
required

Deterministically ranked and deduplicated tool references assignable to project agents. This search does not load callable tool contracts; use host tool discovery for executable tools.

page_info
object
required
returned
integer
required

Number of references returned after applying the limit.

Required range: x >= 0
total_matches
integer
required

Total matching references before applying the limit.

Required range: x >= 0