{"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 and lookup limits. Then pick a recipe from `documentation.recipes` — the call sequences that make up a task.","documentation":{"openapi":"https://api.trayo.ai/openapi.json","openapiYaml":"https://api.trayo.ai/v1/openapi.yaml","llms":"https://api.trayo.ai/llms.txt","llmsFull":"https://api.trayo.ai/llms-full.txt","agentInstall":"https://api.trayo.ai/agent-install.txt","recipes":"https://api.trayo.ai/v1/recipes","docs":"https://api.trayo.ai/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; `agentInstall` is the steps a coding agent follows to connect Trayo to itself as an MCP server."},"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":"POST","path":"/v1/accounts/lookalikes","summary":"Find companies similar to a list of seed companies"},{"method":"POST","path":"/v1/companies/competitors","summary":"Rank the competitors of one company"},{"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/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":"Find companies or people not yet in your workspace"},{"method":"GET","path":"/v1/find/industries","summary":"The industry taxonomy `filters.industries` accepts"},{"method":"POST","path":"/v1/job-changes/search","summary":"Find recent company moves"},{"method":"POST","path":"/v1/posts/search","summary":"Find LinkedIn posts by topic or author"},{"method":"POST","path":"/v1/posts/engagers","summary":"List the author and commenters of a LinkedIn post"},{"method":"POST","path":"/v1/posts/search/keywords","summary":"Search stored LinkedIn posts with explicit keyword groups"},{"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 workspace onboarding assumptions and settings"},{"method":"PATCH","path":"/v1/workspace","summary":"Correct workspace onboarding assumptions and settings"},{"method":"GET","path":"/v1/whoami","summary":"Who this key is: permissions, workspace and limits"},{"method":"POST","path":"/v1/stakeholders/search","summary":"Find the stakeholders at a company that fit a definition"},{"method":"POST","path":"/v1/stakeholders/search/batch","summary":"Find the stakeholders at up to 50 companies in one call"},{"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/research/person/batch","summary":"A quick overview for up to 10 people in one call"},{"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"}]}