Skip to main content
GET
List agents

Authorizations

Authorization
string
header
required

A Skydive API key, sent as Authorization: Bearer sky_live_.... Keys are scoped to a single agent and carry a use or edit scope. The full key value is shown once at creation and never again.

Query Parameters

scope
enum<string>

Filter the list. mine returns only agents you created; org (the default) returns every agent you can view in the workspace.

Available options:
mine,
org
limit
integer

Maximum number of agents to return (1-100). Defaults to 50.

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

50

cursor
string

Pagination cursor. Pass the nextCursor from the previous page to fetch the next one.

Response

A page of agents.

agents
object[]
required
count
integer
required

Number of agents in this page.

nextCursor
string | null
required

Cursor for the next page, or null if this is the last page.