{"name":"Trayo API","version":"1.0.0","description":"Define accounts (companies) and signals (what you want to detect), run discovery on demand, read the events discovery produces, search for companies and people you do not have yet with POST /v1/find, keep the set you are working on in /v1/lists so it outlives this session, and rank accounts by Trayo's own scores instead of counting events.","startHere":"Call GET /v1/whoami first: it confirms the key and returns the workspace, plan, credit balance and lookup limits. Then pick a recipe from `documentation.recipes` — the call sequences that make up a task.","documentation":{"openapi":"https://api.trayo.dev/openapi.json","openapiYaml":"https://api.trayo.dev/v1/openapi.yaml","llms":"https://api.trayo.dev/llms.txt","llmsFull":"https://api.trayo.dev/llms-full.txt","recipes":"https://api.trayo.dev/v1/recipes","docs":"https://api.trayo.dev/docs","alternates":["/openapi.json","/v1/openapi.json","/v1/openapi.yaml","/.well-known/openapi"],"note":"All four URLs return the SAME generated document. The extension picks the default serialization; an Accept header of application/json or application/yaml overrides it. READ IT FIRST — every route, every field, every error code is in there. `llms` is a short Markdown index of the same document and `llmsFull` the whole of it as Markdown; `recipes` is the call order for each task; `docs` is the document rendered as a web page, for people."},"authentication":{"type":"bearer","header":"Authorization: Bearer <your-api-key>","note":"Required by every route except the documentation and index routes listed here. The key identifies your workspace and an owning user on its own — there is no separate workspace id to send. A missing or wrong key is 401 with code `unauthorized`."},"endpoints":[{"method":"GET","path":"/v1/accounts","summary":"List accounts"},{"method":"POST","path":"/v1/accounts","summary":"Create an account"},{"method":"POST","path":"/v1/accounts/batch","summary":"Batch create accounts"},{"method":"GET","path":"/v1/accounts/{id}","summary":"Get an account"},{"method":"PATCH","path":"/v1/accounts/{id}","summary":"Update an account"},{"method":"DELETE","path":"/v1/accounts/{id}","summary":"Delete an account"},{"method":"GET","path":"/v1/accounts/{id}/enrich","summary":"Read the enrichment state"},{"method":"POST","path":"/v1/accounts/{id}/enrich","summary":"Enrich an account"},{"method":"GET","path":"/v1/signals","summary":"List signals"},{"method":"POST","path":"/v1/signals","summary":"Create a signal"},{"method":"GET","path":"/v1/signals/{signalKey}","summary":"Get a signal"},{"method":"PATCH","path":"/v1/signals/{signalKey}","summary":"Update a signal"},{"method":"DELETE","path":"/v1/signals/{signalKey}","summary":"Delete a signal"},{"method":"GET","path":"/v1/discoveries","summary":"List discovery runs"},{"method":"POST","path":"/v1/discoveries","summary":"Start a discovery run"},{"method":"GET","path":"/v1/discoveries/{runId}","summary":"Get a discovery run"},{"method":"GET","path":"/v1/events","summary":"List events"},{"method":"GET","path":"/v1/events/{id}","summary":"Get an event"},{"method":"DELETE","path":"/v1/events/{id}","summary":"Delete (dismiss) an event"},{"method":"GET","path":"/v1/people","summary":"List people"},{"method":"POST","path":"/v1/people","summary":"Create a person"},{"method":"POST","path":"/v1/people/batch","summary":"Batch create people"},{"method":"GET","path":"/v1/people/{id}","summary":"Get a person"},{"method":"PATCH","path":"/v1/people/{id}","summary":"Update a person"},{"method":"DELETE","path":"/v1/people/{id}","summary":"Delete a person"},{"method":"POST","path":"/v1/people/enrich/batch","summary":"Look up emails and phones for many people"},{"method":"GET","path":"/v1/people/{id}/enrich","summary":"Read the contact lookup state"},{"method":"POST","path":"/v1/people/{id}/enrich","summary":"Look up an email and/or phone"},{"method":"POST","path":"/v1/people/{id}/ask","summary":"Ask a question about a person"},{"method":"POST","path":"/v1/find","summary":"Search for companies and people not yet in your workspace"},{"method":"POST","path":"/v1/job-changes/search","summary":"Find recent company moves"},{"method":"GET","path":"/v1/lists","summary":"List lists"},{"method":"POST","path":"/v1/lists","summary":"Create a list"},{"method":"GET","path":"/v1/lists/{id}","summary":"Get a list"},{"method":"PATCH","path":"/v1/lists/{id}","summary":"Rename a list"},{"method":"DELETE","path":"/v1/lists/{id}","summary":"Delete a list"},{"method":"GET","path":"/v1/lists/{id}/members","summary":"List members"},{"method":"POST","path":"/v1/lists/{id}/members","summary":"Add members"},{"method":"DELETE","path":"/v1/lists/{id}/members/{memberId}","summary":"Remove a member"},{"method":"GET","path":"/v1/workspace","summary":"Read the workspace settings that steer stakeholder search"},{"method":"PATCH","path":"/v1/workspace","summary":"Set the stakeholder definition and what you sell"},{"method":"GET","path":"/v1/whoami","summary":"Who this key is: workspace, user, plan, credits and limits"},{"method":"POST","path":"/v1/stakeholders/search","summary":"Find the stakeholders at a company that fit a definition"},{"method":"POST","path":"/v1/research/company","summary":"A quick overview of a company: what it does, why now, and fit"},{"method":"POST","path":"/v1/research/person","summary":"A quick overview of a person: career, likely challenges, and angles"},{"method":"POST","path":"/v1/contacts/lookup","summary":"Find an email or phone for a person you describe"},{"method":"GET","path":"/v1/contacts/lookups/{lookupId}","summary":"Collect a lookup that was still running"},{"method":"GET","path":"/","summary":"Where the documentation is and how to authenticate"},{"method":"GET","path":"/v1/recipes","summary":"The call sequences that make up a task"},{"method":"GET","path":"/v1/openapi.yaml","summary":"This document"},{"method":"GET","path":"/openapi.json","summary":"This document, as JSON"},{"method":"GET","path":"/.well-known/openapi","summary":"This document, at its well-known URI"}]}