Search
GET /api/orgs/{org_id}/search
Section titled “GET /api/orgs/{org_id}/search”Global Search
Full-text search across chats and agents within an org.
status (chat lifecycle) and agent_id only apply to chat results;
an agent match by name is returned regardless of chat status, and
agent_id (searching within one already-known agent’s chats) suppresses
agent-name results rather than filtering them.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| agent_id | query | string (uuid) | no | Filter results by agent |
| limit | query | integer | no | Maximum results to return |
| offset | query | integer | no | Pagination offset |
| org_id | path | string (uuid) | yes | |
| q | query | string | yes | Search query text |
| status | query | ChatStatus[] | no | Filter results by chat status |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | Successful Response | agentdepot_api__routers__search__SearchResponse |
| 422 | Validation Error | HTTPValidationError |