ReferencePeople search
Start People Search
Begin a people search workflow.
Returns a thread_id for status, continue and stop. Charged as list.build.
Authorization
ApiKeyAuth x-api-key<token>
A platform key (ck_live_…). Mint one in the console under
Settings → API Keys.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/api/v1/search/workflow/people/start" \ -H "Content-Type: application/json" \ -d '{ "prompt": "Find VP-level engineering leaders at Series B fintech companies in the US", "list_name": "Q3 prospects", "list_description": "VP Engineering leaders in fintech", "search_mode": "fast" }'{ "success": true, "message": "string", "thread_id": "string", "status": "string"}Was this page helpful?Report an issue