Skip to main content
GET
Search

Authorizations

Authorization
string
header
required

Bearer JWT token or API Key (sk-*).

Query Parameters

type
enum<string>
required

Global search mode.

Available options:
SIMPLE,
CODE,
AGENT_MESSAGES,
CATEGORIES
skip
number

Number of rows to skip before pagination starts.

Required range: x >= 0
Example:

0

take
number

Maximum number of rows to return.

Required range: 1 <= x <= 100
Example:

30

caseSensitive
boolean

Whether code search should be case-sensitive.

Example:

false

matchWord
boolean

Whether code search should match whole words only.

Example:

false

includeMemory
boolean

When true, include accessible durable agent memory alongside normal resource results.

Example:

false

componentType
string[]

Optional component type filter for code search.

refTypes
enum<string>[]

Resource family filters. Include COMPONENT_ELEMENT to search component elements and AGENT_MEMORY to search durable memory with snapshot resources.

Available options:
USERS,
GROUPS,
ROLE_GROUPS,
COMPONENTS,
ENDPOINTS,
TEMPLATES,
SCHEDULE,
EVENTS,
SECRETS,
STORAGE,
FILES,
PREFERENCES,
USER_KEYS,
DATABASES,
AGENTS,
AGENT_PLUGINS,
DATABASE_VIEWS,
COMPONENT_ELEMENT,
AGENT_MEMORY
agentId
string

Optional agent id used to include agent-owned memory after the caller passes that agent memory view policy.

omitCache
boolean

When true, bypasses search result cache for this API request only.

term

Search term. SIMPLE and AGENT_MESSAGES searches accept one string or repeated term parameters for focused multi-term discovery; AGENT_MESSAGES terms require at least two characters. Optional when type=CATEGORIES.

Required string length: 1 - 100

Response

Search result. AGENT_MESSAGES returns one best hit per owned assistant thread.

data
object[]
required

One best title-or-message hit per owned thread.

total
number
required

Total owned threads matching the query before pagination.

Example:

12

take
number
required

Effective page size.

Example:

30

skip
number
required

Effective number of skipped thread hits.

Example:

0

Last modified on September 5, 2026