Skip to main content
GET
List agent profiles across projects

Authorizations

Authorization
string
header
required

An opaque Omnara personal or organization bearer token.

Path Parameters

orgID
string
required

Organization ID (org_...).

Pattern: ^org_[a-z2-7]{26}$

Query Parameters

name
string

Case-insensitive glob over the list's logical name. * matches zero or more characters, ? matches one character, and \ escapes a wildcard.

Required string length: 1 - 200
include_stats
boolean

Include each profile's stats, so a list can show instance counts and usage without a request per profile.

stats_since
string<date-time>

Start of the window stats.usage tallies, with include_stats. Omit to tally from the earliest recorded call.

sort
enum<string>
default:-created_at

Sort order for named resources that expose created and modified timestamps.

Available options:
name,
-name,
-updated_at,
updated_at,
-created_at,
created_at
limit
integer<int32>
default:50

Maximum number of items to return in one page.

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

Opaque pagination cursor from a previous response's next_cursor. Omit for the first page.

Maximum string length: 1024

Response

Agent profiles across the caller's readable projects, newest first.

data
object[]
required
next_cursor
string | null
required

Opaque cursor for the next page, or null when this is the last page.