Skip to main content
GET
Search Agents
Search matches agent title, description, and agent ID within the authenticated workspace.

Query parameters

Use GET /agents for a full workspace list without filters. Use GET /agents/search when you need pagination, text search, or starred-only views.

Example

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

workspaceId
string
sortBy
enum<string>
default:newest
Available options:
newest,
oldest,
firstCreated,
lastCreated,
alphabetical
page
number
default:1
Required range: x >= 1
limit
number
default:20
Required range: 1 <= x <= 50
starredOnly
boolean
default:false
agentIds
string
excludeAgentIds
string
includeStarredAgents
boolean
default:true

Response

Successful response

agents
object[]
required
starredAgents
object[]
required
total
number
required
totalStarred
number
required
page
number
required
limit
number
required
hasMore
boolean
required