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

Request

Base URL
https://app.freeplay.ai (the document declares no server; this is the origin it was published from)
Auth
HTTP bearer
TypeScript
https://skmtc.dev/freeplay/apis/freeplay-api/docs/api/v2/projects/:project_id/search/traces/post.ts
A function with typed inputs. Its response is checked against the schema.

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)

Changes

No recorded changes to this operation across all 1 revision of this API.