Skip to main content
GET
List and search agents

Authorizations

Authorization
string
header
required

API key: key id as the username, secret as the password. An account API key carries the same scopes as an OAuth token and is checked against the scopes listed under oauth2 on each operation. A trigger API key is limited to its trigger's workspace and reaches only the session operations that list this scheme alongside the oauth2 scopes.

Query Parameters

sort_by
string | null

Column name to sort by; prefix with '-' for descending order.

limit
integer
default:20

Maximum number of items to return.

Required range: 0 <= x <= 500
offset
integer
default:0

Number of items to skip before returning results.

Required range: 0 <= x <= 9223372036854776000
search
string | null

Words to match in name or description

fast
boolean
default:false
published_only
boolean
default:false
is_public
boolean
default:false
is_pinned
boolean | null
for_workspace
string | null
tags
string | null
categories
string | null
agent_types
string | null
owner
string | null

Owning user or organization, by name or ID. Omit for every agent you can see.

contributor
string | null

Filter the list to items created, maintained, or authored by the specified user.

Response

Successful response

items
object[]
pagination
object