Sets (private preview)
Understand the current availability of durable, asynchronous people Sets.
Not available to public API keys
People Sets are currently a private preview. POST /v1/sets and its child routes are not exposed through the customer API gateway and return the standard
404 not_found response. They are also intentionally absent from the public OpenAPI document and CLI.
Use the available public surfaces
Use POST /v1/search for a synchronous list of up to 100 people. Use the Agent API when the result requires multi-step research, public-web evidence, or structured analysis.
Preview scope
The private preview is designed for durable, asynchronous lists with criteria verification, enrichment columns, progress events, and export. Its request and response contracts may change before public release.
Do not build a production integration against /v1/sets until the family appears in the public OpenAPI document.