latestOpenAPI 3.1.02026-08-08127304355.9 KB
69c553220183
Search & Analytics
Search Traces
Query traces using advanced filters. Use to find specific trace executions, filter by metadata, or analyze trace patterns.
Supports pagination and optional inclusion of all child traces and completions within the session, using the include_children parameter.
page_size defaults to 30, maximum 100.
For filter operators and examples, see: https://docs.freeplay.ai/openapi/search-api-operators
post/api/v2/projects/{project_id}/search/traces
Path parameters
project_idstring required
Query parameters
pageinteger
page_sizeinteger
include_childrenboolean
Request body
Response
TraceSearchResponse(data: Union[List[server.search_api.types.TraceSearchInfo], List[server.search_api.types.TraceSearchInfoWithChildren]], pagination: server.api_routes.api_v2_common.PaginationInfo)