| Name | Type | Description |
|---|---|---|
id | SequenceNotStr[str] | Omit | Default: omitExact Agent ids (repeat the parameter; maximum 100) |
cursor | str | Omit | Default: omitOpaque pagination cursor |
name | str | Omit | Default: omit |
page_size | int | Omit | Default: omit |
sort_by | Literal['last_run_start_time', 'name', 'created_at'] | Omit | Default: omit |
sort_order | Literal['asc', 'desc'] | Omit | Default: omit |
source_type | Literal['LSD', 'MDA', 'EXTERNAL', 'FLEET'] | Omit | Default: omit |
extra_headers | Headers | None | Default: None |
extra_query | Query | None | Default: None |
extra_body | Body | None | Default: None |
timeout | float | httpx.Timeout | None | NotGiven | Default: not_given |
Returns Agents visible to the caller.
Each item is the same Agent shape as GET /api/v1/agents/{agent_id}, including the environments the caller may read. The list never embeds runtime bindings. An unknown query parameter, including limit, returns 400; use page_size to set the page size.
Case-insensitive partial Agent name
Maximum number of Agents to return
Field to sort by. When name is set, exact name matches still come first.
Sort direction
Agent source type
Send extra headers
Add additional query parameters to the request
Add additional JSON properties to the request
Override the client-level default timeout for this request, in seconds
