@aventurevc/aventure-cli 0.8.6 → 0.8.7

package/dist/chunks/openapi-commands-Ddy43sf8.js

@@ -0,0 +1 @@
+import{Bt as e,D as t,It as n,Lt as r,et as i,nt as a,rt as o}from"./auth-BkmEH7-r.js";function s(e,t){let n=f(e);if(t===void 0||t.length===0)return n;let r=`Allowed values: ${t.join(`, `)}`;return n===``?`${r}.`:`${n} ${r}.`}var c={path:{heading:`Path parameters:`,rank:0},header:{heading:`Request headers:`,rank:1},input:{heading:`Input:`,rank:2},body:{heading:`Body fields:`,rank:3},option:{heading:`Options:`,rank:1/0}};function l(e){return d(e).rank}function u(e){return d(e).heading}function d(e){return e.location===`path`?c.path:e.location===`header`?c.header:e.inputType===`file`||e.schemaFormat===`binary`?c.input:e.location===`body`?c.body:c.option}var f=e=>e===``||/[.!?]$/u.test(e)?e:`${e}.`,p={researchData:{heading:`Research data commands:`,rank:0},account:{heading:`Account commands:`,rank:1},administration:{heading:`Administration commands (require AUTH_TOKEN):`,rank:2},cli:{heading:`CLI commands:`,rank:3}};function m(e,t){return e!==void 0&&h(e,t)===`administration`}function h(e,t){return g[e]??t?.[e]?.section}var g={app:`account`,auth:`account`,entities:`researchData`,people:`researchData`,enrichments:`researchData`,news:`researchData`,search:`researchData`,resolve:`researchData`,lookup:`researchData`,"lookup-jobs":`researchData`,provenance:`administration`,billing:`account`,harness:`administration`,jobs:`administration`,operations:`administration`,metrics:`cli`,inference:`administration`,web:`researchData`,contacts:`administration`,"url-types":`researchData`,"unique-ids":`researchData`,research:`administration`,status:`cli`,agents:`cli`,help:`cli`},_=new Set([`metrics`]),v={agents:{summary:`Deprecated: get one agent instruction document`,section:`cli`},"agents help":{summary:`Deprecated: answer a natural-language platform help question`},"agents instructions":{summary:`Platform help, versioned agent instructions, and agent runtime discovery`},"agents instructions manifest":{summary:`Deprecated: get the agent instruction manifest`},"agents instructions versions":{summary:`Deprecated: get one agent instruction document version`},auth:{summary:`Sign-in, session, API key, and CLI authorization endpoints`,section:`account`},"auth api-key":{summary:`Get current API key`},"auth me":{summary:`Current user permissions`},"auth me permissions":{summary:`Returns the current caller's resolved roles and permissions`},"auth providers":{summary:`Get the public authentication provider catalog`},billing:{summary:`Hosted billing operations and the public plan catalog`,section:`account`},"billing ai-credits":{summary:`Read the current AI credit allowance`},"billing checkout-sessions":{summary:`Create or recover a hosted Checkout Session`},"billing plan-changes":{summary:`Change the subscription plan`},"billing plans":{summary:`List subscription tiers and plans`},"billing portal-sessions":{summary:`Create a hosted Billing Portal Session`},"billing subscription":{summary:`Read the current billing subscription`},enrichments:{summary:`Enrich many companies and people`,section:`researchData`},entities:{summary:`Companies and funds: people, funding, and news`,section:`researchData`},"entities acquisitions":{summary:`Acquisitions a company made or was part of`},"entities addresses":{summary:`A company's recorded office and headquarters addresses`},"entities blog-posts":{summary:`External blog and article links for entities and people`},"entities classifications":{summary:`Classification tags on a company, and suggested tags`},"entities classifications catalog":{summary:`Get the company classification taxonomy`},"entities classifications suggestions":{summary:`Suggest classifications for a company`},"entities classifications tags":{summary:`List classification tags`},"entities content":{summary:`Publications about one company or person, and platform-wide publication search`},"entities content facets":{summary:`Count a company's publications`},"entities employee-counts":{summary:`List a company's headcount over time`},"entities enrichments":{summary:`Enrich one company, product, or service`},"entities filters":{summary:`Filter options for company listings: available values, refinement, and option search`},"entities fundraise-investor-joins":{summary:`List the investors in a funding round`},"entities fundraise-rounds":{summary:`List a company's funding rounds`},"entities investments":{summary:`List the investments a company made`},"entities investor-activity":{summary:`Get investor activity`},"entities investors":{summary:`List a company's investors`},"entities lookup-exact":{summary:`Read full entity detail by exact slug, URL, or domain`},"entities media":{summary:`Get a company media slot`},"entities people":{summary:`People linked to companies, and the role each one holds`},"entities person-investors":{summary:`List person investors`},"entities relationships":{summary:`Relationships between companies, investors, and other organizations`},"entities relationships types":{summary:`List entity relationship types`},"entities repositories":{summary:`List a company's GitHub repositories`},"entities research":{summary:`Get the research gathered about a company`},"entities research-details":{summary:`List research details`},"entities research-details types":{summary:`List the accepted research detail types`},"entities research-snippets":{summary:`List research snippets`},"entities research-snippets types":{summary:`List the accepted research snippet types`},"entities sec":{summary:`Get SEC EDGAR facts for a public company`},"entities similar":{summary:`Similar companies and people, related entities, and trending news`},"entities similar summary":{summary:`Get similar company summaries by id`},"entities slug":{summary:`Get a company's slug`},"entities texts":{summary:`Descriptions and other written text for companies and people`},"entities texts types":{summary:`List the accepted company text types`},"entities trending-news":{summary:`List trending news about a company`},"entities types":{summary:`List the accepted typeRecord values`},"entities unique-ids":{summary:`External identifiers and the records they name`},"entities urls":{summary:`Websites, social profiles, and other URLs for companies and people`},"entities valuations":{summary:`List a company's valuation over time`},harness:{summary:`Get one run`,section:`administration`},"harness runs":{summary:`Returns one run with its resolved public entity and exact renderable profile URL when available`},help:{summary:`Answer a natural-language platform help question`,section:`cli`},"help instructions":{summary:`Get one agent instruction document`},"help instructions manifest":{summary:`Get the agent instruction manifest`},"help instructions versions":{summary:`Get one agent instruction document version`},"lookup-jobs":{summary:`Identify every company and person an article names`,section:`researchData`},news:{summary:`News linked to the companies and people in it`,section:`researchData`},"news feedback":{summary:`Submit news feedback`},"news media":{summary:`Get news thumbnail`},"news related-entities":{summary:`List the entities a news article is about`},people:{summary:`Founders and investors, and what they back`,section:`researchData`},"people addresses":{summary:`A person's recorded addresses`},"people blog-posts":{summary:`External blog and article links for entities and people`},"people content":{summary:`Publications about one company or person, and platform-wide publication search`},"people content facets":{summary:`Count a person's publications`},"people enrichments":{summary:`Enrich one person`},"people entities":{summary:`People linked to companies, and the role each one holds`},"people filters":{summary:`Filter options for people listings and option search`},"people graph":{summary:`Get person graph`},"people investments":{summary:`List a person's investments`},"people investor-activity":{summary:`Get person investor activity`},"people lookup-exact":{summary:`Read one person's full detail by exact slug or URL`},"people media":{summary:`Get person photo`},"people repositories":{summary:`List a person's GitHub repositories`},"people similar":{summary:`List people similar to one person`},"people texts":{summary:`Descriptions and other written text for companies and people`},"people texts types":{summary:`List the accepted person text types`},"people unique-ids":{summary:`External identifiers and the records they name`},"people urls":{summary:`Websites, social profiles, and other URLs for companies and people`},resolve:{summary:`Deprecated: find the record behind an id, slug, or URL`,section:`researchData`},search:{summary:`Search companies, people, and news together`,section:`researchData`},"search natural":{summary:`Find companies and people in natural language`},"unique-ids":{summary:`External identifiers and the records they name`,section:`researchData`},"unique-ids types":{summary:`List the accepted unique identifier types`},"url-types":{summary:`List URL types`,section:`researchData`},web:{summary:`Search the live web`,section:`researchData`}};function y(e){return S(e,b())}function b(){return!!a().userBearerToken?.trim()}function x(e){return b()||!m(e,v)}function S(e,t){return t?e:e.filter(e=>!m(e.cliPath[0],v)||e.visibility!==`private`).map(C)}function C(e){let t=e.parameters.filter(w),n=e.requestBody?.map(e=>{let t=e.parameter.filter(w);return t.length===e.parameter.length?e:{...e,parameter:t}}),r=n?.every((t,n)=>t===e.requestBody?.[n]);return t.length===e.parameters.length&&r!==!1?e:{...e,parameters:t,requestBody:n}}var w=e=>e.visibility!==`private`;function T(a,o){let s=a.indexOf(`--`),c=a.slice(0,s===-1?a.length:s);if(c.some(e=>e===`--version`||e===`-V`))return`none`;let l=new n().exitOverride().configureOutput({writeErr:()=>void 0}).addOption(new r(`--environment <environment>`,`route all API calls to a mapped API environment`).choices([...i()])).addOption(new r(`--content-type <media-type>`)).addOption(new r(`--ask <question>`)),u=l.parseOptions([...a]).operands,d=l.opts().environment;d!==void 0&&(process.env.API_ENV=d);let f=o.find(e=>E(u,e.cliPath)),p=l.opts().contentType;if(f!==void 0&&p!==void 0){let n=t(f.requestBody??[],p);if(!n.ok)throw new e(n.summary)}let h=u.at(0);return h===void 0?`optional`:[`auth`,`update`].includes(h)?`none`:c.some(e=>e===`--help`||e===`-h`)?m(h,v)?`optional`:`none`:m(h,v)?`required`:h===`help`?f===void 0?l.opts().ask===void 0?`optional`:u.length===1?`required`:`none`:`required`:h===`agents`&&u[1]===`setup`?`required`:[`command-catalog`,`completion`].includes(h)?`optional`:h===`batch`?`required`:f===void 0?`optional`:`required`}function E(e,t){return t.every((t,n)=>e[n]===t)}var D=`${o/1e3}KB`,O=[{flags:`--text`,description:`Print text (terminal default).`,conflicts:[`data`,`dataFull`,`json`]},{flags:`--data`,description:`Print data JSON (piped default); over ${D} returns a truncated envelope.`,conflicts:[`text`,`dataFull`,`json`]},{flags:`--data-full`,description:`Print uncapped JSON for bounded programs; never LLM agents.`,conflicts:[`text`,`data`,`json`]},{flags:`--json`,description:`Print the stable JSON envelope (capped at ${D}).`,conflicts:[`text`,`data`,`dataFull`]},{flags:`--all-fields`,description:`Print text including the detail fields --text hides; JSON output is unchanged.`,conflicts:[`data`,`dataFull`,`json`]}];function k(e){for(let t of O)e.addOption(new r(t.flags,t.description).conflicts([...t.conflicts]));return e}function A(e,t=`auto`){return e.json===!0?`json`:e.dataFull===!0?`data-full`:e.data===!0?`data`:e.text===!0||e.allFields===!0?`text`:N(e)||t===`auto`&&!process.stdout.isTTY?`data`:`text`}function j(e){return e.includes(`--text`)||e.includes(`--all-fields`)?!1:e.includes(`--json`)||e.includes(`--data`)||e.includes(`--data-full`)||e.includes(`--agent-chassis`)&&e.includes(`--agent-model`)||!process.stdout.isTTY}function M(e){return e===`data`||e===`data-full`||e===`json`}function N(e){return P(e.agentChassis)&&P(e.agentModel)}function P(e){return typeof e==`string`&&e.trim().length>0}var F=`c3245e713a415ebd`,I=[{operationId:`lookupRecord`,method:`POST`,path:`/v1/lookup`,resource:`lookup`,intent:`lookup`,cliPath:[`lookup`],summary:`Find a company or person by name, URL, or id`,description:`Identifies a company or a person in one call. A name that is exactly a record's id, public handle, registry id (ticker, LEI, EIN), or slug settles at once; otherwise the company and person ladders of POST /v1/entities/lookup and POST /v1/people/lookup both run. Returns MATCHED when a URL, slug, or registry-id proof settles one kind, or when exactly one kind matches and the other finds nothing; NO_MATCH when neither finds the subject; and NEEDS_REVIEW otherwise, including when a company and a person share the name. match.owner says which kind matched: with entityId, read it with GET /v1/entities/{entityId} (CLI: entities get) or enrich it with POST /v1/entities/{entityId}/enrichments (CLI: entities enrichments enrich); with personId, use GET /v1/people/{personId} (CLI: people get) or POST /v1/people/{personId}/enrichments (CLI: people enrichments enrich). On NEEDS_REVIEW ask the user which candidate it is, then use its owner the same way; when you already know the kind, the company-only or person-only lookup answers without the other kind's namesakes. Takes the same body as those two operations. Example body: {"name":"Acme AI","url":["https://acme.ai"]}. Exact id only: legacy=true with {"name":"eV1StGXR8Z5a"}.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/identification/subject`,schemaName:`IdentificationSubjectSchema`,kind:`json`,contentType:`application/json`,description:`The company or person to identify. Send the name plus every URL, location, and source you have; a website or profile URL usually settles the answer without any model call.`,required:!0,requiredPath:[`name`],parameter:[{name:`context`,optionKey:`context`,flag:`--context <context>`,required:!1,description:`Specific facts in plain words: product, industry, employer and title, or founder names. Generic words like startup add nothing.`,schemaType:`string`,location:`body`},{name:`location`,optionKey:`location`,flag:`--location <location>`,required:!1,description:`City, region, or country, such as Austin, TX. Tells namesakes apart; not proof on its own.`,schemaType:`string`,location:`body`},{name:`name`,optionKey:`name`,flag:`--name <name>`,required:!0,description:`Name exactly as the source writes it, such as Acme AI or Jane Doe.`,schemaType:`string`,location:`body`},{name:`sourceNewsId`,optionKey:`sourceNewsId`,flag:`--source-news-id <integer>`,required:!1,description:`aVenture news id of the article that mentions the subject; an unknown id is a 400.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`sourceUrl`,optionKey:`sourceUrl`,flag:`--source-url <source-url>`,required:!1,description:`URL of the article that mentions the subject; read from aVenture news when stored there, otherwise fetched.`,schemaType:`string`,location:`body`},{name:`url`,optionKey:`url`,flag:`--url <url...>`,required:!1,description:`URLs the subject owns: its website, its LinkedIn company or person profile, or a registry page. At most 10. Put articles in sourceUrl.`,schemaType:`array`,itemSchemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[{status:`402`,description:`The signed-in caller's plan does not include natural search.`},{status:`429`,description:`The caller's natural-search quota is spent; retry after the Retry-After seconds.`}],parameters:[{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Also considers hidden and unpublished records; needs private-visibility authority. Without it, NO_MATCH covers only records you can see.`,schemaType:`boolean`,location:`query`},{name:`legacy`,optionKey:`legacy`,flag:`--legacy <true|false>`,required:!1,description:`Treat name only as an exact id, public handle, registry id, or slug: no model call, no web search, and 404 when nothing matches. An exact match never spends the natural-search quota, with or without this flag.`,schemaType:`boolean`,location:`query`}]},{operationId:`getSystemGlobalMetrics`,method:`GET`,path:`/v1/metrics`,resource:`metrics`,intent:`read`,cliPath:[`metrics`],summary:`Get platform totals for companies, funding, and people`,description:`Global metrics snapshot. Companies tracked, total funding, trailing 30-day funding, investors, people, countries, cities. Totals are a periodically refreshed snapshot, so they can trail recent changes.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[]},{operationId:`searchFederated`,method:`POST`,path:`/v1/search`,resource:`search`,intent:`search`,cliPath:[`search`],summary:`Search companies, people, and news together`,description:`Searches enriched details across our company and people dataset from a plain-English query. Runs the canonical entity, person, and news search engines sequentially and returns their typed result pages with per-scope strategy provenance. Supports only auto and keyword modes; unsupported modes are rejected before any scope runs. Page and size apply to every scope; cross-domain sort is not supported.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/natural/search`,schemaName:`NaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English search request. The server plans the query into the target domain filter plus sort, then runs that domain's canonical list engine.`,required:!0,requiredPath:[`query`],parameter:[{name:`mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value; news and federated search accept only `auto` and `keyword`; content search accepts only `auto`. Allowed values: auto, exact, keyword, semantic, natural.",schemaType:`string`,defaultValue:`auto`,choices:[`auto`,`exact`,`keyword`,`semantic`,`natural`],location:`body`},{name:`model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Optional chat model for planning; null uses the configured natural-search default. A caller without admin authority may only choose an allowlisted model; admin callers are unrestricted.`,schemaType:`string`,location:`body`},{name:`query`,optionKey:`query`,flag:`--query <query>`,required:!0,description:`Plain-English search request.`,schemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[{status:`402`,description:`The authenticated caller's subscription does not include this search.`}],parameters:[{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`}]},{operationId:`getSystemStatus`,method:`GET`,path:`/v1/status`,resource:`status`,intent:`status`,cliPath:[`status`],summary:`Get system uptime`,description:`Returns the API's uptime SLA and the identity of the served operation set. Callable without credentials, so it confirms the API is reachable.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[]},{operationId:`enrichRecords`,method:`POST`,path:`/v1/enrichments`,resource:`enrichments`,intent:`write`,cliPath:[`enrichments`,`enrich`],summary:`Enrich many companies and people`,description:`Queues one enrichment run per listed entity and person, in order, each owned by the authenticated principal and billed exactly as the single-record enrich call is. A repeated id is filed once. Returns one outcome per distinct record: its run, or a refusal (NOT_FOUND, ALLOWANCE_EXHAUSTED, AMBIGUOUS, SUBSCRIPTION_REQUIRED) for a record that cannot be filed; other records still file, and runs already filed stay queued. A caller without a research subscription gets 402 before any run is filed. A transient failure fails the request; retrying it reuses runs still in progress without charging them again. A list longer than the configured batch limit is refused before any run is filed. Check each run's progress with GET /v1/harness/runs/{runId} (CLI: harness runs get).`,requestBody:[{schemaImport:`@aventurevc/api-schemas/enrichment/batch`,schemaName:`EnrichmentBatchSchema`,kind:`json`,contentType:`application/json`,description:`Existing records to enrich in one call, with the run options every run shares`,required:!0,requiredPath:[],parameter:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <entity-id...>`,required:!1,description:`Canonical entity UUIDs to enrich, filed in order before any person.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:`COMPREHENSIVE (the default) researches each whole profile; INDIVIDUAL runs only the tasks named in taskPresetKey. Allowed values: COMPREHENSIVE, INDIVIDUAL.`,schemaType:`string`,choices:[`COMPREHENSIVE`,`INDIVIDUAL`],location:`body`},{name:`model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Model id for each run's lead agent; omit to use aVenture's default model.`,schemaType:`string`,location:`body`},{name:`personId`,optionKey:`personId`,flag:`--person-id <person-id...>`,required:!1,description:`Canonical person UUIDs to enrich, filed in order after every entity.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`taskPresetKey`,optionKey:`taskPresetKey`,flag:`--task-preset-key <task-preset-key...>`,required:!1,description:`Task preset keys that scope or emphasize every run; at least one is required when mode is INDIVIDUAL, and an unknown key is a 400.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`userPrompt`,optionKey:`userPrompt`,flag:`--user-prompt <user-prompt>`,required:!1,description:`Plain-language instruction for every run, such as which facts or sources to check first.`,schemaType:`string`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[{status:`402`,description:`The authenticated caller's subscription tier does not include research runs.`}],parameters:[]},{operationId:`getEntity`,method:`GET`,path:`/v1/entities/{entityId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`get`],summary:`Get one company, product, or service by id`,description:`Returns entity detail by exact UUID. Use lookup for a slug, URL, or candidate signals. A signed-in user's read charges one view per distinct returned record against the monthly entity or person view allowance; a repeat read of the same record in the month is free, and an exhausted cap answers 429 with Retry-After. Reads made without a signed-in user are never charged.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Exact entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record>`,required:!1,description:`Concrete entity type qualifier; group-only Organization is invalid. List the accepted concrete tokens and their aliases with GET /v1/entities/types (CLI: entities types list).`,schemaType:`string`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Allow generated monogram logo fallback.`,schemaType:`boolean`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes hidden or off-sitemap entities and hidden research snippets when the caller has private-visibility authority.`,schemaType:`boolean`,location:`query`}]},{operationId:`listEntities`,method:`GET`,path:`/v1/entities`,resource:`entities`,intent:`read`,cliPath:[`entities`,`list`],summary:`List companies, products, and services`,description:`List entities with the same filters and sort as POST /v1/entities/search, passed as query parameters. Use the POST search for semantic ranking or a JSON EntityListFilter body, and POST /v1/search/natural/entities for plain English.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <entity-id...>`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`slug`,optionKey:`entitySlug`,flag:`--entity-slug <entity-slug...>`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`entityName`,optionKey:`entityName`,flag:`--entity-name <entity-name...>`,required:!1,description:`Exact normalized match against entity brand or legal names.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`person`,optionKey:`person`,flag:`--person <person...>`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`query`},{name:`industry`,optionKey:`industry`,flag:`--industry <industry...>`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`location`,optionKey:`location`,flag:`--location <location...>`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`tag`,optionKey:`tag`,flag:`--tag <tag...>`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`mainProduct`,optionKey:`mainProduct`,flag:`--main-product <main-product...>`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`typeTechnologyUsed`,optionKey:`typeTechnologyUsed`,flag:`--type-technology-used <type-technology-used...>`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`typeModel`,optionKey:`typeModel`,flag:`--type-model <type-model...>`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`typeOwnership`,optionKey:`typeOwnership`,flag:`--type-ownership <type-ownership...>`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`typeCustomer`,optionKey:`typeCustomer`,flag:`--type-customer <type-customer...>`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`typeRevenue`,optionKey:`typeRevenue`,flag:`--type-revenue <type-revenue...>`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`acceleratorBrand`,optionKey:`acceleratorBrand`,flag:`--accelerator-brand <accelerator-brand...>`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`acceleratorName`,optionKey:`acceleratorName`,flag:`--accelerator-name <accelerator-name...>`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`acceleratorCohort`,optionKey:`acceleratorCohort`,flag:`--accelerator-cohort <accelerator-cohort...>`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`acceleratorStatus`,optionKey:`acceleratorStatus`,flag:`--accelerator-status <accelerator-status...>`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`affinity`,optionKey:`affinity`,flag:`--affinity <affinity...>`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`headquartersCountry`,optionKey:`headquartersCountry`,flag:`--headquarters-country <headquarters-country...>`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`headquartersState`,optionKey:`headquartersState`,flag:`--headquarters-state <headquarters-state...>`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`headquartersCity`,optionKey:`headquartersCity`,flag:`--headquarters-city <headquarters-city...>`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`stage`,optionKey:`stage`,flag:`--stage <stage...>`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`yearFoundedRange[0].min`,optionKey:`yearFoundedRangeMin`,flag:`--year-founded-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`yearFoundedRange[0].max`,optionKey:`yearFoundedRangeMax`,flag:`--year-founded-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`employeeCountRange[0].min`,optionKey:`employeeCountRangeMin`,flag:`--employee-count-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`employeeCountRange[0].max`,optionKey:`employeeCountRangeMax`,flag:`--employee-count-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`operatingStatus`,optionKey:`operatingStatus`,flag:`--operating-status <operating-status...>`,required:!1,description:`Operating states to include; omit to include every state. Allowed values: Operating, Acquired, Acquired Subsidiary, Closed, Closed (Acquihire), Inactive.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`],location:`query`},{name:`createdAtRange.min`,optionKey:`createdAtRangeMin`,flag:`--created-at-range-min <date-time>`,required:!1,description:`Inclusive earliest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`query`},{name:`createdAtRange.max`,optionKey:`createdAtRangeMax`,flag:`--created-at-range-max <date-time>`,required:!1,description:`Inclusive latest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`query`},{name:`updatedAtRange.min`,optionKey:`updatedAtRangeMin`,flag:`--updated-at-range-min <date-time>`,required:!1,description:`Inclusive earliest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`query`},{name:`updatedAtRange.max`,optionKey:`updatedAtRangeMax`,flag:`--updated-at-range-max <date-time>`,required:!1,description:`Inclusive latest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`query`},{name:`hasLogo`,optionKey:`hasLogo`,flag:`--has-logo <true|false>`,required:!1,description:`Privileged filter to entities with any logo.`,schemaType:`boolean`,location:`query`},{name:`isHidden`,optionKey:`isHidden`,flag:`--is-hidden <true|false>`,required:!1,description:`Privileged filter by hidden status.`,schemaType:`boolean`,location:`query`},{name:`showOnSitemap`,optionKey:`showOnSitemap`,flag:`--show-on-sitemap <true|false>`,required:!1,description:`Privileged filter by public sitemap inclusion.`,schemaType:`boolean`,location:`query`},{name:`hasRealLogo`,optionKey:`hasRealLogo`,flag:`--has-real-logo <true|false>`,required:!1,description:`Privileged filter to entities with a real uploaded logo.`,schemaType:`boolean`,location:`query`},{name:`hasFundraising`,optionKey:`hasFundraising`,flag:`--has-fundraising <true|false>`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`,location:`query`},{name:`featured`,optionKey:`featured`,flag:`--featured <true|false>`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`,location:`query`},{name:`suppressZeroTotalRaised`,optionKey:`suppressZeroTotalRaised`,flag:`--suppress-zero-total-raised <true|false>`,required:!1,description:`Suppress entities whose total raised is zero.`,schemaType:`boolean`,location:`query`},{name:`suppressNonOperating`,optionKey:`suppressNonOperating`,flag:`--suppress-non-operating <true|false>`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`,location:`query`},{name:`qualityGate`,optionKey:`qualityGate`,flag:`--quality-gate <quality-gate>`,required:!1,description:`Named server-owned list quality gate. Allowed values: NONE, COMPANY_LISTING_READY.`,schemaType:`string`,choices:[`NONE`,`COMPANY_LISTING_READY`],location:`query`},{name:`url`,optionKey:`url`,flag:`--url <url>`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`,location:`query`},{name:`urlDomain`,optionKey:`urlDomain`,flag:`--url-domain <url-domain>`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`,location:`query`},{name:`urlType`,optionKey:`urlType`,flag:`--url-type <url-type>`,required:!1,description:`Restrict URL matching to one URL type. Allowed values: website, linkedin, twitter, github, facebook, instagram, tiktok, youtube, subreddit, forum, documentation, support, statuspage, changelog, roadmap, discord, crunchbase, wellfound, angellist, glassdoor, theorg, ycombinator, wikipedia, pitchbook, morningstar, bloomberg, nyse, nasdaq, g2, producthunt, trustpilot, alternativeto, gartnerpeerinsights, getapp, sourceforge, appstore, googleplay, capterra, trustradius, hubspotmarketplace, slackappdirectory, awsmarketplace, salesforceappexchange, chromewebstore, vscodemarketplace, npm, pypi, maven, dockerhub, homebrew, crates, huggingface.`,schemaType:`string`,choices:`website.linkedin.twitter.github.facebook.instagram.tiktok.youtube.subreddit.forum.documentation.support.statuspage.changelog.roadmap.discord.crunchbase.wellfound.angellist.glassdoor.theorg.ycombinator.wikipedia.pitchbook.morningstar.bloomberg.nyse.nasdaq.g2.producthunt.trustpilot.alternativeto.gartnerpeerinsights.getapp.sourceforge.appstore.googleplay.capterra.trustradius.hubspotmarketplace.slackappdirectory.awsmarketplace.salesforceappexchange.chromewebstore.vscodemarketplace.npm.pypi.maven.dockerhub.homebrew.crates.huggingface`.split(`.`),location:`query`},{name:`urlMatchMode`,optionKey:`urlMatchMode`,flag:`--url-match-mode <url-match-mode>`,required:!1,description:`URL matching mode: hostPath uses host and path; domain uses the root domain. Allowed values: hostPath, domain.`,schemaType:`string`,choices:[`hostPath`,`domain`],location:`query`},{name:`portfolioHeadquartersCountry`,optionKey:`portfolioHeadquartersCountry`,flag:`--portfolio-headquarters-country <portfolio-headquarters-country...>`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`portfolioHeadquartersState`,optionKey:`portfolioHeadquartersState`,flag:`--portfolio-headquarters-state <portfolio-headquarters-state...>`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`portfolioHeadquartersCity`,optionKey:`portfolioHeadquartersCity`,flag:`--portfolio-headquarters-city <portfolio-headquarters-city...>`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`fundraiseActivity.round`,optionKey:`fundraiseRound`,flag:`--fundraise-round <fundraise-round...>`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`fundraiseActivity.amountRaisedRange[0].min`,optionKey:`fundraiseAmountRaisedRangeMin`,flag:`--fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.amountRaisedRange[0].max`,optionKey:`fundraiseAmountRaisedRangeMax`,flag:`--fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.amountInvestedRange[0].min`,optionKey:`fundraiseAmountInvestedRangeMin`,flag:`--fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.amountInvestedRange[0].max`,optionKey:`fundraiseAmountInvestedRangeMax`,flag:`--fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.totalRaisedRange[0].min`,optionKey:`fundraiseTotalRaisedRangeMin`,flag:`--fundraise-total-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.totalRaisedRange[0].max`,optionKey:`fundraiseTotalRaisedRangeMax`,flag:`--fundraise-total-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.valuationRange[0].min`,optionKey:`fundraiseValuationRangeMin`,flag:`--fundraise-valuation-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.valuationRange[0].max`,optionKey:`fundraiseValuationRangeMax`,flag:`--fundraise-valuation-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.lastRoundYearRange[0].min`,optionKey:`fundraiseLastRoundYearRangeMin`,flag:`--fundraise-last-round-year-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`fundraiseActivity.lastRoundYearRange[0].max`,optionKey:`fundraiseLastRoundYearRangeMax`,flag:`--fundraise-last-round-year-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`fundraiseActivity.investedCompanyName`,optionKey:`fundraiseInvestedCompanyName`,flag:`--fundraise-invested-company-name <fundraise-invested-company-name...>`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`fundraiseActivity.investorActivity.totalInvestmentRange[0].min`,optionKey:`fundraiseInvestorActivityTotalInvestmentRangeMin`,flag:`--fundraise-investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`fundraiseActivity.investorActivity.totalInvestmentRange[0].max`,optionKey:`fundraiseInvestorActivityTotalInvestmentRangeMax`,flag:`--fundraise-investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[0].min`,optionKey:`fundraiseInvestorActivityTotalAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[0].max`,optionKey:`fundraiseInvestorActivityTotalAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[0].min`,optionKey:`fundraiseInvestorActivityAverageAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[0].max`,optionKey:`fundraiseInvestorActivityAverageAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[0].min`,optionKey:`fundraiseInvestorActivityLargestAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[0].max`,optionKey:`fundraiseInvestorActivityLargestAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[0].min`,optionKey:`fundraiseInvestorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[0].max`,optionKey:`fundraiseInvestorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`textSearch`,optionKey:`textSearch`,flag:`--text-search <text-search>`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`,location:`query`},{name:`countOnly`,optionKey:`countOnly`,flag:`--count-only <true|false>`,required:!1,description:`Return only the matching entity count in totalElements. Content is empty by design, so the page empty flag describes content, not whether matches exist. Unsupported with semanticQuery.`,schemaType:`boolean`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Allow generated monogram logos in results.`,schemaType:`boolean`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes hidden or off-sitemap entities when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`lookupEntity`,method:`POST`,path:`/v1/entities/lookup`,resource:`entities`,intent:`lookup`,cliPath:[`entities`,`lookup`],summary:`Find which company a name refers to, or confirm it is new`,description:`Returns status MATCHED, NO_MATCH, or NEEDS_REVIEW. MATCHED: match.owner.entityId is the company; read it with GET /v1/entities/{entityId} (CLI: entities get) or queue research on it with POST /v1/entities/{entityId}/enrichments (CLI: entities enrichments enrich). NO_MATCH: no record you can see is this company; a caller with write access creates it, using officialUrl as its website when present. NEEDS_REVIEW: show candidate (most probable first) to the user and ask which one it is or whether it is new, then use the chosen candidate's owner.entityId; never create on NEEDS_REVIEW. Resending with the company's website or LinkedIn company URL settles it without a model call when a stored record holds that URL. stage names the step that settled it: DETERMINISTIC (URL or registry-id proof, no model call), JUDGMENT (decision model), or WEB_EVIDENCE (added a web search). Send the website and LinkedIn company URL whenever you have them, location and context to tell namesakes apart, and the article as sourceUrl or sourceNewsId. A parent, subsidiary, or namesake is a different company. For the full detail of an exact slug, URL, or domain use GET /v1/entities/lookup-exact. Example body: {"name":"Acme AI","url":["https://acme.ai"],"location":"Austin, TX"}.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/identification/subject`,schemaName:`IdentificationSubjectSchema`,kind:`json`,contentType:`application/json`,description:`The company or person to identify. Send the name plus every URL, location, and source you have; a website or profile URL usually settles the answer without any model call.`,required:!0,requiredPath:[`name`],parameter:[{name:`context`,optionKey:`context`,flag:`--context <context>`,required:!1,description:`Specific facts in plain words: product, industry, employer and title, or founder names. Generic words like startup add nothing.`,schemaType:`string`,location:`body`},{name:`location`,optionKey:`location`,flag:`--location <location>`,required:!1,description:`City, region, or country, such as Austin, TX. Tells namesakes apart; not proof on its own.`,schemaType:`string`,location:`body`},{name:`name`,optionKey:`name`,flag:`--name <name>`,required:!0,description:`Name exactly as the source writes it, such as Acme AI or Jane Doe.`,schemaType:`string`,location:`body`},{name:`sourceNewsId`,optionKey:`sourceNewsId`,flag:`--source-news-id <integer>`,required:!1,description:`aVenture news id of the article that mentions the subject; an unknown id is a 400.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`sourceUrl`,optionKey:`sourceUrl`,flag:`--source-url <source-url>`,required:!1,description:`URL of the article that mentions the subject; read from aVenture news when stored there, otherwise fetched.`,schemaType:`string`,location:`body`},{name:`url`,optionKey:`url`,flag:`--url <url...>`,required:!1,description:`URLs the subject owns: its website, its LinkedIn company or person profile, or a registry page. At most 10. Put articles in sourceUrl.`,schemaType:`array`,itemSchemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[{status:`402`,description:`The signed-in caller's plan does not include natural search.`},{status:`429`,description:`The caller's natural-search quota is spent; retry after the Retry-After seconds.`}],parameters:[{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Also considers hidden and unpublished records; needs private-visibility authority. Without it, NO_MATCH covers only records you can see.`,schemaType:`boolean`,location:`query`}]},{operationId:`lookupEntityBatch`,method:`POST`,path:`/v1/entities/lookup-batch`,resource:`entities`,intent:`lookup`,cliPath:[`entities`,`lookup-batch`],summary:`Look up companies in bulk by id, slug, or URL`,description:`Returns a page envelope of entity detail records by id, slug, and/or current joined URL. When page and size are omitted, the full deduplicated batch is returned in request order. Sort is not supported for this fixed-order batch response. For public reads totalElements counts the entities visible to the caller, so requested identifiers that do not resolve or fail the public visibility filter are excluded. For privileged reads totalElements counts the requested identifiers that resolved to an entity id, which can exceed the number of records returned when an id no longer exists. A signed-in user's read charges one view per distinct returned record against the monthly entity or person view allowance; a repeat read of the same record in the month is free, and an exhausted cap answers 429 with Retry-After. Reads made without a signed-in user are never charged.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/detail-batch`,schemaName:`EntityDetailBatchSchema`,kind:`json`,contentType:`application/json`,description:`Batch request for entity detail retrieval by id, slug, or current joined URL`,required:!1,requiredPath:[],parameter:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <entity-id...>`,required:!1,description:`Entity UUID values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Permit monogram fallbacks.`,schemaType:`boolean`,defaultValue:!0,location:`body`},{name:`slug`,optionKey:`slug`,flag:`--slug <slug...>`,required:!1,description:`Entity slug values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`url`,optionKey:`url`,flag:`--url <url...>`,required:!1,description:`Current joined entity URL values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes hidden, unverified, and not-yet-published entities when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N); omit page and size for the full batch.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned; omit page and size for the full batch.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`}]},{operationId:`lookupEntityMatches`,method:`POST`,path:`/v1/entities/lookup-matches`,resource:`entities`,intent:`lookup`,cliPath:[`entities`,`lookup-matches`],summary:`Look up which company each identifier matches`,description:`Resolves each queried id, slug, and current joined URL to exactly one outcome row that echoes the raw input: MATCHED with full detail, AMBIGUOUS with candidate ids when a URL is currently owned by more than one entity, or MISSING. Unlike the batch detail read, no input is silently dropped and every row maps back to its source identifier. URL matching is host+path exact: scheme and a leading www are ignored, but distinct paths stay distinct (stripe.com does not match stripe.com/payments). A signed-in user's read charges one view per distinct returned record against the monthly entity or person view allowance; a repeat read of the same record in the month is free, and an exhausted cap answers 429 with Retry-After. Reads made without a signed-in user are never charged.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/detail-batch`,schemaName:`EntityDetailBatchSchema`,kind:`json`,contentType:`application/json`,description:`Batch request for entity detail retrieval by id, slug, or current joined URL`,required:!1,requiredPath:[],parameter:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <entity-id...>`,required:!1,description:`Entity UUID values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Permit monogram fallbacks.`,schemaType:`boolean`,defaultValue:!0,location:`body`},{name:`slug`,optionKey:`slug`,flag:`--slug <slug...>`,required:!1,description:`Entity slug values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`url`,optionKey:`url`,flag:`--url <url...>`,required:!1,description:`Current joined entity URL values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Returns hidden, unverified, and not-yet-published entities instead of resolving them as MISSING when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`,location:`query`}]},{operationId:`searchEntitiesByNaturalLanguage`,method:`POST`,path:`/v1/entities/natural-search`,resource:`entities`,intent:`search`,cliPath:[`entities`,`natural-search`],summary:`Deprecated: find companies in natural language`,description:`Deprecated: use search natural entities (POST /v1/search/natural/entities) with the same body and parameters.`,explain:!0,deprecated:!0,requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/natural-search`,schemaName:`EntityNaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English entity search plus explicit hard constraints. The planner may fill only filter fields the caller leaves unset.`,required:!0,requiredPath:[`search`,`search.query`],parameter:[{name:`filter.employeeCountRange[].min`,optionKey:`employeeCountRangeMin`,flag:`--employee-count-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.fundraiseActivity.amountInvestedRange[].min`,optionKey:`fundraiseAmountInvestedRangeMin`,flag:`--fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.amountRaisedRange[].min`,optionKey:`fundraiseAmountRaisedRangeMin`,flag:`--fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityAverageAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityLargestAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityTotalAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.totalInvestmentRange[].min`,optionKey:`fundraiseInvestorActivityTotalInvestmentRangeMin`,flag:`--fundraise-investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.fundraiseActivity.lastRoundYearRange[].min`,optionKey:`fundraiseLastRoundYearRangeMin`,flag:`--fundraise-last-round-year-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.fundraiseActivity.totalRaisedRange[].min`,optionKey:`fundraiseTotalRaisedRangeMin`,flag:`--fundraise-total-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.valuationRange[].min`,optionKey:`fundraiseValuationRangeMin`,flag:`--fundraise-valuation-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.yearFoundedRange[].min`,optionKey:`yearFoundedRangeMin`,flag:`--year-founded-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.employeeCountRange[].max`,optionKey:`employeeCountRangeMax`,flag:`--employee-count-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.fundraiseActivity.amountInvestedRange[].max`,optionKey:`fundraiseAmountInvestedRangeMax`,flag:`--fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.amountRaisedRange[].max`,optionKey:`fundraiseAmountRaisedRangeMax`,flag:`--fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityAverageAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityLargestAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityTotalAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.totalInvestmentRange[].max`,optionKey:`fundraiseInvestorActivityTotalInvestmentRangeMax`,flag:`--fundraise-investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.fundraiseActivity.lastRoundYearRange[].max`,optionKey:`fundraiseLastRoundYearRangeMax`,flag:`--fundraise-last-round-year-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.fundraiseActivity.totalRaisedRange[].max`,optionKey:`fundraiseTotalRaisedRangeMax`,flag:`--fundraise-total-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.valuationRange[].max`,optionKey:`fundraiseValuationRangeMax`,flag:`--fundraise-valuation-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.yearFoundedRange[].max`,optionKey:`yearFoundedRangeMax`,flag:`--year-founded-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.acceleratorBrand`,optionKey:`acceleratorBrand`,flag:`--accelerator-brand <accelerator-brand...>`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.acceleratorCohort`,optionKey:`acceleratorCohort`,flag:`--accelerator-cohort <accelerator-cohort...>`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.acceleratorName`,optionKey:`acceleratorName`,flag:`--accelerator-name <accelerator-name...>`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.acceleratorStatus`,optionKey:`acceleratorStatus`,flag:`--accelerator-status <accelerator-status...>`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.affinity`,optionKey:`affinity`,flag:`--affinity <affinity...>`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityId`,optionKey:`entityId`,flag:`--entity-id <entity-id...>`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityName`,optionKey:`entityName`,flag:`--entity-name <entity-name...>`,required:!1,description:`Exact normalized match against entity brand or legal names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.featured`,optionKey:`featured`,flag:`--featured <true|false>`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`,location:`body`},{name:`filter.fundraiseActivity.investedCompanyName`,optionKey:`fundraiseInvestedCompanyName`,flag:`--fundraise-invested-company-name <fundraise-invested-company-name...>`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.fundraiseActivity.round`,optionKey:`fundraiseRound`,flag:`--fundraise-round <fundraise-round...>`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.hasFundraising`,optionKey:`hasFundraising`,flag:`--has-fundraising <true|false>`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`,location:`body`},{name:`filter.headquartersCity`,optionKey:`headquartersCity`,flag:`--headquarters-city <headquarters-city...>`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.headquartersCountry`,optionKey:`headquartersCountry`,flag:`--headquarters-country <headquarters-country...>`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.headquartersState`,optionKey:`headquartersState`,flag:`--headquarters-state <headquarters-state...>`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.industry`,optionKey:`industry`,flag:`--industry <industry...>`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.letter`,optionKey:`letter`,flag:`--letter <letter>`,required:!1,description:`First letter of the display name.`,schemaType:`string`,location:`body`},{name:`filter.location`,optionKey:`location`,flag:`--location <location...>`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.logoOption.sortPriority`,optionKey:`logoSortPriority`,flag:`--logo-sort-priority <logo-sort-priority>`,required:!1,description:`Logo sort priority. Allowed values: NONE, ANY_LOGO_FIRST, REAL_LOGO_FIRST.`,schemaType:`string`,choices:[`NONE`,`ANY_LOGO_FIRST`,`REAL_LOGO_FIRST`],location:`body`},{name:`filter.mainProduct`,optionKey:`mainProduct`,flag:`--main-product <main-product...>`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.operatingStatus`,optionKey:`operatingStatus`,flag:`--operating-status <operating-status...>`,required:!1,description:`Operating states to include; omit to include every state. Allowed values: Operating, Acquired, Acquired Subsidiary, Closed, Closed (Acquihire), Inactive.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`],location:`body`},{name:`filter.person`,optionKey:`person`,flag:`--person <person...>`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.portfolioHeadquartersCity`,optionKey:`portfolioHeadquartersCity`,flag:`--portfolio-headquarters-city <portfolio-headquarters-city...>`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.portfolioHeadquartersCountry`,optionKey:`portfolioHeadquartersCountry`,flag:`--portfolio-headquarters-country <portfolio-headquarters-country...>`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.portfolioHeadquartersState`,optionKey:`portfolioHeadquartersState`,flag:`--portfolio-headquarters-state <portfolio-headquarters-state...>`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.qualityGate`,optionKey:`qualityGate`,flag:`--quality-gate <quality-gate>`,required:!1,description:`Named server-owned list quality gate. Allowed values: NONE, COMPANY_LISTING_READY.`,schemaType:`string`,choices:[`NONE`,`COMPANY_LISTING_READY`],location:`body`},{name:`filter.slug`,optionKey:`slug`,flag:`--slug <slug...>`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.stage`,optionKey:`stage`,flag:`--stage <stage...>`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.suppressNonOperating`,optionKey:`suppressNonOperating`,flag:`--suppress-non-operating <true|false>`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`,location:`body`},{name:`filter.suppressZeroTotalRaised`,optionKey:`suppressZeroTotalRaised`,flag:`--suppress-zero-total-raised <true|false>`,required:!1,description:`Suppress entities whose total raised is zero.`,schemaType:`boolean`,location:`body`},{name:`filter.tag`,optionKey:`tag`,flag:`--tag <tag...>`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.textSearch`,optionKey:`textSearch`,flag:`--text-search <text-search>`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`,location:`body`},{name:`filter.typeCustomer`,optionKey:`typeCustomer`,flag:`--type-customer <type-customer...>`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.typeModel`,optionKey:`typeModel`,flag:`--type-model <type-model...>`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.typeOwnership`,optionKey:`typeOwnership`,flag:`--type-ownership <type-ownership...>`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`filter.typeRevenue`,optionKey:`typeRevenue`,flag:`--type-revenue <type-revenue...>`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.typeTechnologyUsed`,optionKey:`typeTechnologyUsed`,flag:`--type-technology-used <type-technology-used...>`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.url`,optionKey:`url`,flag:`--url <url>`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`,location:`body`},{name:`filter.urlDomain`,optionKey:`urlDomain`,flag:`--url-domain <url-domain>`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`,location:`body`},{name:`filter.urlMatchMode`,optionKey:`urlMatchMode`,flag:`--url-match-mode <url-match-mode>`,required:!1,description:`URL matching mode: hostPath uses host and path; domain uses the root domain. Allowed values: hostPath, domain.`,schemaType:`string`,choices:[`hostPath`,`domain`],location:`body`},{name:`filter.urlType`,optionKey:`urlType`,flag:`--url-type <url-type>`,required:!1,description:`Restrict URL matching to one URL type. Allowed values: website, linkedin, twitter, github, facebook, instagram, tiktok, youtube, subreddit, forum, documentation, support, statuspage, changelog, roadmap, discord, crunchbase, wellfound, angellist, glassdoor, theorg, ycombinator, wikipedia, pitchbook, morningstar, bloomberg, nyse, nasdaq, g2, producthunt, trustpilot, alternativeto, gartnerpeerinsights, getapp, sourceforge, appstore, googleplay, capterra, trustradius, hubspotmarketplace, slackappdirectory, awsmarketplace, salesforceappexchange, chromewebstore, vscodemarketplace, npm, pypi, maven, dockerhub, homebrew, crates, huggingface.`,schemaType:`string`,choices:`website.linkedin.twitter.github.facebook.instagram.tiktok.youtube.subreddit.forum.documentation.support.statuspage.changelog.roadmap.discord.crunchbase.wellfound.angellist.glassdoor.theorg.ycombinator.wikipedia.pitchbook.morningstar.bloomberg.nyse.nasdaq.g2.producthunt.trustpilot.alternativeto.gartnerpeerinsights.getapp.sourceforge.appstore.googleplay.capterra.trustradius.hubspotmarketplace.slackappdirectory.awsmarketplace.salesforceappexchange.chromewebstore.vscodemarketplace.npm.pypi.maven.dockerhub.homebrew.crates.huggingface`.split(`.`),location:`body`},{name:`search.mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value; news and federated search accept only `auto` and `keyword`; content search accepts only `auto`. Allowed values: auto, exact, keyword, semantic, natural.",schemaType:`string`,defaultValue:`auto`,choices:[`auto`,`exact`,`keyword`,`semantic`,`natural`],location:`body`},{name:`search.model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Optional chat model for planning; null uses the configured natural-search default. A caller without admin authority may only choose an allowlisted model; admin callers are unrestricted.`,schemaType:`string`,location:`body`},{name:`search.query`,optionKey:`query`,flag:`--query <query>`,required:!0,description:`Plain-English search request.`,schemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`When false, generated monogram logos are stripped from entity rows.`,schemaType:`boolean`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes hidden or off-sitemap entities when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`searchEntities`,method:`POST`,path:`/v1/entities/search`,resource:`entities`,intent:`search`,cliPath:[`entities`,`search`],summary:`Search companies, products, and services`,description:`Run keyword, semantic, or explicit structured entity filtering with a structured filter body; Organization expands to the canonical organization type group; semanticQuery ranks by stored content embeddings. For plain-English queries, use POST /v1/search/natural/entities. Semantic results can emit signed cursors; reuse the same filters, sort, size, and visibility scope. countOnly is unsupported with semanticQuery or cursor; count-only pages have no content; read totalElements.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/list-filter`,schemaName:`EntityListFilterSchema`,kind:`json`,contentType:`application/json`,description:`Entity list filters and saved-view query state including semantic entity search. semanticQuery executes on GET /v1/entities and POST /v1/entities/search; saved views persist it for replay. Every other reused EntityFilter surface accepts the base EntityFilter, which omits semanticQuery.`,required:!1,requiredPath:[],parameter:[{name:`employeeCountRange[].min`,optionKey:`employeeCountRangeMin`,flag:`--employee-count-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.amountInvestedRange[].min`,optionKey:`fundraiseAmountInvestedRangeMin`,flag:`--fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.amountRaisedRange[].min`,optionKey:`fundraiseAmountRaisedRangeMin`,flag:`--fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityAverageAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityLargestAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityTotalAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.totalInvestmentRange[].min`,optionKey:`fundraiseInvestorActivityTotalInvestmentRangeMin`,flag:`--fundraise-investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.lastRoundYearRange[].min`,optionKey:`fundraiseLastRoundYearRangeMin`,flag:`--fundraise-last-round-year-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.totalRaisedRange[].min`,optionKey:`fundraiseTotalRaisedRangeMin`,flag:`--fundraise-total-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.valuationRange[].min`,optionKey:`fundraiseValuationRangeMin`,flag:`--fundraise-valuation-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`yearFoundedRange[].min`,optionKey:`yearFoundedRangeMin`,flag:`--year-founded-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`employeeCountRange[].max`,optionKey:`employeeCountRangeMax`,flag:`--employee-count-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.amountInvestedRange[].max`,optionKey:`fundraiseAmountInvestedRangeMax`,flag:`--fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.amountRaisedRange[].max`,optionKey:`fundraiseAmountRaisedRangeMax`,flag:`--fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityAverageAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityLargestAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityTotalAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.totalInvestmentRange[].max`,optionKey:`fundraiseInvestorActivityTotalInvestmentRangeMax`,flag:`--fundraise-investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.lastRoundYearRange[].max`,optionKey:`fundraiseLastRoundYearRangeMax`,flag:`--fundraise-last-round-year-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.totalRaisedRange[].max`,optionKey:`fundraiseTotalRaisedRangeMax`,flag:`--fundraise-total-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.valuationRange[].max`,optionKey:`fundraiseValuationRangeMax`,flag:`--fundraise-valuation-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`yearFoundedRange[].max`,optionKey:`yearFoundedRangeMax`,flag:`--year-founded-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`acceleratorBrand`,optionKey:`acceleratorBrand`,flag:`--accelerator-brand <accelerator-brand...>`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`acceleratorCohort`,optionKey:`acceleratorCohort`,flag:`--accelerator-cohort <accelerator-cohort...>`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`acceleratorName`,optionKey:`acceleratorName`,flag:`--accelerator-name <accelerator-name...>`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`acceleratorStatus`,optionKey:`acceleratorStatus`,flag:`--accelerator-status <accelerator-status...>`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`affinity`,optionKey:`affinity`,flag:`--affinity <affinity...>`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <entity-id...>`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityName`,optionKey:`entityName`,flag:`--entity-name <entity-name...>`,required:!1,description:`Exact normalized match against entity brand or legal names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`featured`,optionKey:`featured`,flag:`--featured <true|false>`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`,location:`body`},{name:`fundraiseActivity.investedCompanyName`,optionKey:`fundraiseInvestedCompanyName`,flag:`--fundraise-invested-company-name <fundraise-invested-company-name...>`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`fundraiseActivity.round`,optionKey:`fundraiseRound`,flag:`--fundraise-round <fundraise-round...>`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`hasFundraising`,optionKey:`hasFundraising`,flag:`--has-fundraising <true|false>`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`,location:`body`},{name:`headquartersCity`,optionKey:`headquartersCity`,flag:`--headquarters-city <headquarters-city...>`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`headquartersCountry`,optionKey:`headquartersCountry`,flag:`--headquarters-country <headquarters-country...>`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`headquartersState`,optionKey:`headquartersState`,flag:`--headquarters-state <headquarters-state...>`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`industry`,optionKey:`industry`,flag:`--industry <industry...>`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`letter`,optionKey:`letter`,flag:`--letter <letter>`,required:!1,description:`First letter of the display name.`,schemaType:`string`,location:`body`},{name:`location`,optionKey:`location`,flag:`--location <location...>`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`logoOption.sortPriority`,optionKey:`logoSortPriority`,flag:`--logo-sort-priority <logo-sort-priority>`,required:!1,description:`Logo sort priority. Allowed values: NONE, ANY_LOGO_FIRST, REAL_LOGO_FIRST.`,schemaType:`string`,choices:[`NONE`,`ANY_LOGO_FIRST`,`REAL_LOGO_FIRST`],location:`body`},{name:`mainProduct`,optionKey:`mainProduct`,flag:`--main-product <main-product...>`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`operatingStatus`,optionKey:`operatingStatus`,flag:`--operating-status <operating-status...>`,required:!1,description:`Operating states to include; omit to include every state. Allowed values: Operating, Acquired, Acquired Subsidiary, Closed, Closed (Acquihire), Inactive.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`],location:`body`},{name:`person`,optionKey:`person`,flag:`--person <person...>`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`portfolioHeadquartersCity`,optionKey:`portfolioHeadquartersCity`,flag:`--portfolio-headquarters-city <portfolio-headquarters-city...>`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`portfolioHeadquartersCountry`,optionKey:`portfolioHeadquartersCountry`,flag:`--portfolio-headquarters-country <portfolio-headquarters-country...>`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`portfolioHeadquartersState`,optionKey:`portfolioHeadquartersState`,flag:`--portfolio-headquarters-state <portfolio-headquarters-state...>`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`qualityGate`,optionKey:`qualityGate`,flag:`--quality-gate <quality-gate>`,required:!1,description:`Named server-owned list quality gate. Allowed values: NONE, COMPANY_LISTING_READY.`,schemaType:`string`,choices:[`NONE`,`COMPANY_LISTING_READY`],location:`body`},{name:`semanticQuery`,optionKey:`semanticQuery`,flag:`--semantic-query <semantic-query>`,required:!1,description:`Semantic entity search phrase. Executable on POST /v1/entities/search; saved views persist it for replay.`,schemaType:`string`,location:`body`},{name:`slug`,optionKey:`slug`,flag:`--slug <slug...>`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`stage`,optionKey:`stage`,flag:`--stage <stage...>`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`suppressNonOperating`,optionKey:`suppressNonOperating`,flag:`--suppress-non-operating <true|false>`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`,location:`body`},{name:`suppressZeroTotalRaised`,optionKey:`suppressZeroTotalRaised`,flag:`--suppress-zero-total-raised <true|false>`,required:!1,description:`Suppress entities whose total raised is zero.`,schemaType:`boolean`,location:`body`},{name:`tag`,optionKey:`tag`,flag:`--tag <tag...>`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`textSearch`,optionKey:`textSearch`,flag:`--text-search <text-search>`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`,location:`body`},{name:`typeCustomer`,optionKey:`typeCustomer`,flag:`--type-customer <type-customer...>`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`typeModel`,optionKey:`typeModel`,flag:`--type-model <type-model...>`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`typeOwnership`,optionKey:`typeOwnership`,flag:`--type-ownership <type-ownership...>`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`typeRevenue`,optionKey:`typeRevenue`,flag:`--type-revenue <type-revenue...>`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`typeTechnologyUsed`,optionKey:`typeTechnologyUsed`,flag:`--type-technology-used <type-technology-used...>`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`url`,optionKey:`url`,flag:`--url <url>`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`,location:`body`},{name:`urlDomain`,optionKey:`urlDomain`,flag:`--url-domain <url-domain>`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`,location:`body`},{name:`urlMatchMode`,optionKey:`urlMatchMode`,flag:`--url-match-mode <url-match-mode>`,required:!1,description:`URL matching mode: hostPath uses host and path; domain uses the root domain. Allowed values: hostPath, domain.`,schemaType:`string`,choices:[`hostPath`,`domain`],location:`body`},{name:`urlType`,optionKey:`urlType`,flag:`--url-type <url-type>`,required:!1,description:`Restrict URL matching to one URL type. Allowed values: website, linkedin, twitter, github, facebook, instagram, tiktok, youtube, subreddit, forum, documentation, support, statuspage, changelog, roadmap, discord, crunchbase, wellfound, angellist, glassdoor, theorg, ycombinator, wikipedia, pitchbook, morningstar, bloomberg, nyse, nasdaq, g2, producthunt, trustpilot, alternativeto, gartnerpeerinsights, getapp, sourceforge, appstore, googleplay, capterra, trustradius, hubspotmarketplace, slackappdirectory, awsmarketplace, salesforceappexchange, chromewebstore, vscodemarketplace, npm, pypi, maven, dockerhub, homebrew, crates, huggingface.`,schemaType:`string`,choices:`website.linkedin.twitter.github.facebook.instagram.tiktok.youtube.subreddit.forum.documentation.support.statuspage.changelog.roadmap.discord.crunchbase.wellfound.angellist.glassdoor.theorg.ycombinator.wikipedia.pitchbook.morningstar.bloomberg.nyse.nasdaq.g2.producthunt.trustpilot.alternativeto.gartnerpeerinsights.getapp.sourceforge.appstore.googleplay.capterra.trustradius.hubspotmarketplace.slackappdirectory.awsmarketplace.salesforceappexchange.chromewebstore.vscodemarketplace.npm.pypi.maven.dockerhub.homebrew.crates.huggingface`.split(`.`),location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`countOnly`,optionKey:`countOnly`,flag:`--count-only <true|false>`,required:!1,description:`Return only the matching entity count in totalElements. Content is empty by design, so the page empty flag describes content, not whether matches exist. Unsupported with semanticQuery.`,schemaType:`boolean`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Allow generated monogram logos in results.`,schemaType:`boolean`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes hidden or off-sitemap entities when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`,location:`query`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Opaque entity cursor; reuse filters and sort. Cursor is unsupported with countOnly; semanticQuery depends on the endpoint.`,schemaType:`string`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`25`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`includeFullDetail`,optionKey:`includeFullDetail`,flag:`--include-full-detail <true|false>`,required:!1,description:`Privileged read flag. Must be true to return the /v1/entities/detail payload.`,schemaType:`boolean`,location:`query`}]},{operationId:`askHelpQuestion`,method:`POST`,path:`/v1/help`,resource:`help`,intent:`search`,cliPath:[`help`,`ask`],summary:`Answer a natural-language platform help question`,description:`Retrieves the most relevant operations, skills, and completion gates, then returns a grounded, citation-bearing answer. Unsupported questions abstain (LOW confidence) rather than invent a command. Free for Clerk callers; legacy client and admin keys remain accepted during migration.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/agent/help-question`,schemaName:`AgentHelpQuestionSchema`,kind:`json`,contentType:`application/json`,description:`A natural-language question about how to operate the platform, answered from the operation catalog, agent skills, and completion gates.`,required:!0,requiredPath:[`question`],parameter:[{name:`model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Optional chat model that answers the question; null uses the configured default. A caller without admin authority may only choose an allowlisted model; an ineligible model is rejected with 422. Admin callers are unrestricted.`,schemaType:`string`,location:`body`},{name:`question`,optionKey:`question`,flag:`--question <question>`,required:!0,description:`The question to answer, in natural language.`,schemaType:`string`,location:`body`},{name:`scope`,optionKey:`scope`,flag:`--scope <scope>`,required:!1,description:`Optional scope restricting which operations the answer may recommend; null means all. Allowed values: READ, WRITE, ALL.`,schemaType:`string`,choices:[`READ`,`WRITE`,`ALL`],location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],parameters:[]},{operationId:`createLookupJob`,method:`POST`,path:`/v1/lookup-jobs`,resource:`lookup-jobs`,intent:`write`,cliPath:[`lookup-jobs`,`create`],summary:`Start identifying every company and person an article names`,description:`Reads one article (sourceUrl or sourceNewsId), extracts the companies and people it names, and identifies each one as POST /v1/lookup would with the article as its source. Poll the returned status URL with GET /v1/lookup-jobs/{jobId}. Spends one natural-search quota slot for each name the job may identify, up to its per-article limit, when it is accepted. For a name no stored record is, the job creates a hidden shell record at no charge only when a second live page on another site names it too; enrich that shell by its id. The same article sent again soon returns the earlier job without spending quota again. Example body: {"sourceUrl":"https://techcrunch.com/2024/01/01/example"}.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/lookup/job-mutation`,schemaName:`LookupJobMutationSchema`,kind:`json`,contentType:`application/json`,description:`The article whose companies and people a lookup job identifies. Send sourceUrl, sourceNewsId, or both.`,required:!0,requiredPath:[],parameter:[{name:`sourceNewsId`,optionKey:`sourceNewsId`,flag:`--source-news-id <integer>`,required:!1,description:`aVenture news id of the article; an unknown id fails the job.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`sourceUrl`,optionKey:`sourceUrl`,flag:`--source-url <source-url>`,required:!1,description:`URL of the article; read from aVenture news when stored there, otherwise fetched.`,schemaType:`string`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[{status:`402`,description:`The signed-in caller's plan does not include natural search.`},{status:`429`,description:`The caller's natural-search quota is spent; retry after the Retry-After seconds.`}],parameters:[{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Also considers hidden and unpublished records; needs private-visibility authority. Without it, NO_MATCH covers only records you can see.`,schemaType:`boolean`,location:`query`}]},{operationId:`getLookupJob`,method:`GET`,path:`/v1/lookup-jobs/{jobId}`,resource:`lookup-jobs`,intent:`read`,cliPath:[`lookup-jobs`,`get`],summary:`Get a lookup job's state and the records its article names`,description:`Returns the job state and, once COMPLETED, one mention per company or person the article names: its identification (MATCHED gives the stored record, NEEDS_REVIEW the candidates) and, for NO_MATCH, the hidden shell record created for it or shellDetail saying why none was. A name whose lookup failed carries failureReason instead; send it alone to POST /v1/lookup. Only the caller that started the job can read it.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`jobId`,optionKey:`jobId`,flag:`--job-id <uuid>`,required:!0,description:`Lookup job id from the create response.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`getNews`,method:`GET`,path:`/v1/news/{newsId}`,resource:`news`,intent:`read`,cliPath:[`news`,`get`],summary:`Get one news article`,description:`Returns news detail by exact positive ID. Use lookup for a slug, external ID, URL, or title candidates.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`newsId`,optionKey:`newsId`,flag:`--news-id <integer>`,required:!0,description:`Exact positive news article id.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`}]},{operationId:`listNews`,method:`GET`,path:`/v1/news`,resource:`news`,intent:`read`,cliPath:[`news`,`list`],summary:`List news articles`,description:`Browse news articles in the canonical news domain, with optional filtering.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned; default and maximum 25 for the standard list, where larger values are reduced to that maximum. Entity, person, author-initial, and thin-mode reads accept larger pages.`,schemaType:`integer`,defaultValue:`25`,location:`query`},{name:`search`,optionKey:`search`,flag:`--search <search>`,required:!1,description:`Full-text news search term.`,schemaType:`string`,location:`query`},{name:`category`,optionKey:`category`,flag:`--category <category>`,required:!1,description:`News category slug to include or exclude.`,schemaType:`string`,location:`query`},{name:`owner.entityId`,optionKey:`ownerEntityId`,flag:`--owner-entity-id <uuid>`,required:!1,description:`Owning entity id; set only when personId is absent.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`owner.personId`,optionKey:`ownerPersonId`,flag:`--owner-person-id <uuid>`,required:!1,description:`Owning person id; set only when entityId is absent.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`excludeId`,optionKey:`excludeId`,flag:`--exclude-id <integer>`,required:!1,description:`Exclude one news article by id.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`authorInitial`,optionKey:`authorInitial`,flag:`--author-initial <author-initial>`,required:!1,description:`Author initial filter.`,schemaType:`string`,location:`query`},{name:`publishedAfter`,optionKey:`publishedAfter`,flag:`--published-after <date>`,required:!1,description:`Earliest publication date, inclusive.`,schemaType:`string`,schemaFormat:`date`,location:`query`},{name:`publishedBefore`,optionKey:`publishedBefore`,flag:`--published-before <date>`,required:!1,description:`Latest publication date, inclusive.`,schemaType:`string`,schemaFormat:`date`,location:`query`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Cursor token returned by the previous thin page.`,schemaType:`string`,location:`query`},{name:`letter`,optionKey:`letter`,flag:`--letter <letter>`,required:!1,description:`Deprecated: use the author-initial filter.`,schemaType:`string`,location:`query`},{name:`mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:`Response mode: thin returns cursor-paginated index rows; omit for the standard list. Allowed values: thin.`,schemaType:`string`,choices:[`thin`],location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`lookupNews`,method:`GET`,path:`/v1/news/lookup`,resource:`news`,intent:`lookup`,cliPath:[`news`,`lookup`],summary:`Look up one news article`,description:`Resolves news detail by slug, external ID, URL, or bounded title candidate signals. Use the numeric item route for an id; any id query is rejected. Canonical redirects are preserved.`,scope:`read`,auth:`bearer`,errorResponse:[{status:`409`,description:`Ambiguous candidate signals: more than one article still matches the supplied title/URL bundle. ProblemDetail carries details.newsCandidate; review those ids, update the matching article, and create only when all candidates are distinct and source evidence supports the target. score and threshold are review ranking, not absence proof. Resolve directly by id, slug, or externalId.`}],parameters:[{name:`slug`,optionKey:`newsSlug`,flag:`--news-slug <news-slug>`,required:!1,description:`Exact news article slug (URL-friendly identifier). Mutually exclusive with id, externalId, url, and title.`,schemaType:`string`,location:`query`},{name:`externalId`,optionKey:`externalId`,flag:`--external-id <external-id>`,required:!1,description:`External ID or RSS GUID for ingestion-key lookup. Mutually exclusive with id, slug, url, and title.`,schemaType:`string`,location:`query`},{name:`url`,optionKey:`url`,flag:`--url <url>`,required:!1,description:`Original article URL to resolve via strict host+path or domain-only match. Mutually exclusive with id, slug, and externalId. May pair with title and publication to narrow candidate recovery after an exact URL miss. Pair with urlMatchMode to disambiguate.`,schemaType:`string`,location:`query`},{name:`title`,optionKey:`title`,flag:`--title <title>`,required:!1,description:`Candidate lookup signal: article title. Mutually exclusive with id, slug, and externalId. Combine with publication, urlDomain, or url for bounded candidate search.`,schemaType:`string`,location:`query`},{name:`publication`,optionKey:`publication`,flag:`--publication <publication>`,required:!1,description:`Publication qualifier (e.g., 'TechCrunch', 'Forbes'). Narrows a title candidate search. Not an identifier on its own.`,schemaType:`string`,location:`query`},{name:`urlDomain`,optionKey:`urlDomain`,flag:`--url-domain <url-domain>`,required:!1,description:`Candidate lookup URL domain qualifier (host only, no path). Narrows a title candidate search. Not an identifier on its own.`,schemaType:`string`,location:`query`},{name:`urlMatchMode`,optionKey:`urlMatchMode`,flag:`--url-match-mode <url-match-mode>`,required:!1,description:`URL match mode qualifier: 'hostPath' (strict host + path match, default) or 'domain' (host-only match). Narrows url and urlDomain matching. Not an identifier on its own.`,schemaType:`string`,location:`query`}]},{operationId:`getPerson`,method:`GET`,path:`/v1/people/{personId}`,resource:`people`,intent:`read`,cliPath:[`people`,`get`],summary:`Get one person by id`,description:`Returns person detail by exact UUID. Use lookup for a slug, URL, or candidate signals. A signed-in user's read charges one view per distinct returned record against the monthly entity or person view allowance; a repeat read of the same record in the month is free, and an exhausted cap answers 429 with Retry-After. Reads made without a signed-in user are never charged.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Exact person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`includeUrl`,optionKey:`includeUrl`,flag:`--include-url <true|false>`,required:!1,description:`Projection qualifier — include URL link values in response (default: true). Set false to omit urlLink array.`,schemaType:`boolean`,location:`query`},{name:`includeAssociation`,optionKey:`includeAssociation`,flag:`--include-association <true|false>`,required:!1,description:`Projection qualifier — include association values (default: true). Set false to omit association array.`,schemaType:`boolean`,location:`query`},{name:`includeAddress`,optionKey:`includeAddress`,flag:`--include-address <true|false>`,required:!1,description:`Projection qualifier — include address values (default: true). Set false to omit address array.`,schemaType:`boolean`,location:`query`},{name:`maxAssociations`,optionKey:`maxAssociations`,flag:`--max-associations <integer>`,required:!1,description:`Projection qualifier — max association values to return; bounded internally to the association limit. Default: 40.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Permit generated monogram photo fallback (default: true). Set false to exclude monogram photos in response.`,schemaType:`boolean`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes hidden or off-sitemap people and private fields when the caller has private-visibility authority.`,schemaType:`boolean`,location:`query`}]},{operationId:`listPeople`,method:`GET`,path:`/v1/people`,resource:`people`,intent:`read`,cliPath:[`people`,`list`],summary:`List people`,description:`List people with the same filters and sort as POST /v1/people/search, passed as query parameters. Use the POST search for semantic ranking or a JSON body, and POST /v1/search/natural/people for plain English.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`firstName`,optionKey:`firstName`,flag:`--first-name <first-name>`,required:!1,description:`Person first name.`,schemaType:`string`,location:`query`},{name:`lastName`,optionKey:`lastName`,flag:`--last-name <last-name>`,required:!1,description:`Person last name.`,schemaType:`string`,location:`query`},{name:`status`,optionKey:`status`,flag:`--status <status>`,required:!1,description:`Person workflow status.`,schemaType:`string`,location:`query`},{name:`arrayFilter.entityName`,optionKey:`entityName`,flag:`--entity-name <entity-name...>`,required:!1,description:`Associated entity names.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`arrayFilter.typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Associated entity type scope. Omit or use [] for any associated type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`query`},{name:`arrayFilter.personTitle`,optionKey:`personTitle`,flag:`--person-title <person-title...>`,required:!1,description:`Person titles.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`arrayFilter.investedCompany`,optionKey:`fundraiseInvestedCompanyName`,flag:`--fundraise-invested-company-name <fundraise-invested-company-name...>`,required:!1,description:`Invested company names.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`arrayFilter.round`,optionKey:`fundraiseRound`,flag:`--fundraise-round <fundraise-round...>`,required:!1,description:`Fundraise round labels.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`arrayFilter.amountRaisedRange[0].min`,optionKey:`fundraiseAmountRaisedRangeMin`,flag:`--fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`arrayFilter.amountRaisedRange[0].max`,optionKey:`fundraiseAmountRaisedRangeMax`,flag:`--fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`arrayFilter.amountInvestedRange[0].min`,optionKey:`fundraiseAmountInvestedRangeMin`,flag:`--fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`arrayFilter.amountInvestedRange[0].max`,optionKey:`fundraiseAmountInvestedRangeMax`,flag:`--fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`arrayFilter.totalInvestmentCount[0].min`,optionKey:`totalInvestmentCountMin`,flag:`--total-investment-count-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`arrayFilter.totalInvestmentCount[0].max`,optionKey:`totalInvestmentCountMax`,flag:`--total-investment-count-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`search`,optionKey:`search`,flag:`--search <search>`,required:!1,description:`Search keyword or phrase. Single characters valid; stop words rejected.`,schemaType:`string`,location:`query`},{name:`personName`,optionKey:`personName`,flag:`--person-name <person-name...>`,required:!1,description:`Exact normalized match against a person's full name or slug.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`personId`,optionKey:`personId`,flag:`--person-id <person-id...>`,required:!1,description:`Restrict results to specific person IDs. Omit or use [] for no ID restriction.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`letter`,optionKey:`letter`,flag:`--letter <letter>`,required:!1,description:`First-name initial.`,schemaType:`string`,location:`query`},{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!1,description:`Associated entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`entitySlug`,optionKey:`entitySlug`,flag:`--entity-slug <entity-slug>`,required:!1,description:`Associated entity slug.`,schemaType:`string`,location:`query`},{name:`role`,optionKey:`role`,flag:`--role <role>`,required:!1,description:`Associated entity role or title.`,schemaType:`string`,location:`query`},{name:`isCurrent`,optionKey:`isCurrent`,flag:`--is-current <true|false>`,required:!1,description:`Filter current associations.`,schemaType:`boolean`,location:`query`},{name:`includeUrl`,optionKey:`includeUrl`,flag:`--include-url <true|false>`,required:!1,description:`Include URL links on each person.`,schemaType:`boolean`,location:`query`},{name:`includeAddress`,optionKey:`includeAddress`,flag:`--include-address <true|false>`,required:!1,description:`Include addresses on each person.`,schemaType:`boolean`,location:`query`},{name:`investorActivity.totalInvestmentRange[0].min`,optionKey:`investorActivityTotalInvestmentRangeMin`,flag:`--investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`investorActivity.totalInvestmentRange[0].max`,optionKey:`investorActivityTotalInvestmentRangeMax`,flag:`--investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`investorActivity.totalAmountInvestedUsdRange[0].min`,optionKey:`investorActivityTotalAmountInvestedUsdRangeMin`,flag:`--investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`investorActivity.totalAmountInvestedUsdRange[0].max`,optionKey:`investorActivityTotalAmountInvestedUsdRangeMax`,flag:`--investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`investorActivity.averageAmountInvestedUsdRange[0].min`,optionKey:`investorActivityAverageAmountInvestedUsdRangeMin`,flag:`--investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`investorActivity.averageAmountInvestedUsdRange[0].max`,optionKey:`investorActivityAverageAmountInvestedUsdRangeMax`,flag:`--investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`investorActivity.largestAmountInvestedUsdRange[0].min`,optionKey:`investorActivityLargestAmountInvestedUsdRangeMin`,flag:`--investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`investorActivity.largestAmountInvestedUsdRange[0].max`,optionKey:`investorActivityLargestAmountInvestedUsdRangeMax`,flag:`--investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`investorActivity.smallestAmountInvestedUsdRange[0].min`,optionKey:`investorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`investorActivity.smallestAmountInvestedUsdRange[0].max`,optionKey:`investorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`countOnly`,optionKey:`countOnly`,flag:`--count-only <true|false>`,required:!1,description:`When true, return only the page total in the body and skip the content payload.`,schemaType:`boolean`,location:`query`},{name:`hasImageFirst`,optionKey:`hasImageFirst`,flag:`--has-image-first <true|false>`,required:!1,description:`When true, sort people who have a photo before those who do not.`,schemaType:`boolean`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`When false, monogram fallback logos are stripped from the response. Defaults to true.`,schemaType:`boolean`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes hidden, unverified, and not-yet-published records when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`25`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`lookupPerson`,method:`POST`,path:`/v1/people/lookup`,resource:`people`,intent:`lookup`,cliPath:[`people`,`lookup`],summary:`Find which person a name refers to, or confirm they are new`,description:`Returns status MATCHED, NO_MATCH, or NEEDS_REVIEW. MATCHED: match.owner.personId is the person; read them with GET /v1/people/{personId} (CLI: people get) or queue research on them with POST /v1/people/{personId}/enrichments (CLI: people enrichments enrich). NO_MATCH: no record you can see is this person; a caller with write access creates them. NEEDS_REVIEW: show candidate (most probable first) to the user and ask which one it is or whether the person is new, then use the chosen candidate's owner.personId; never create on NEEDS_REVIEW. Resending with their LinkedIn profile URL settles it without a model call when a stored record holds that URL. stage names the step that settled it: DETERMINISTIC (URL proof, no model call), JUDGMENT (decision model), or WEB_EVIDENCE (added a web search). Send their LinkedIn or personal URL whenever you have it, and employer and title as context; the same name at a different employer is a different person. For the full detail of an exact slug or URL use GET /v1/people/lookup-exact. Example body: {"name":"Jane Doe","context":"CEO at Acme AI"}.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/identification/subject`,schemaName:`IdentificationSubjectSchema`,kind:`json`,contentType:`application/json`,description:`The company or person to identify. Send the name plus every URL, location, and source you have; a website or profile URL usually settles the answer without any model call.`,required:!0,requiredPath:[`name`],parameter:[{name:`context`,optionKey:`context`,flag:`--context <context>`,required:!1,description:`Specific facts in plain words: product, industry, employer and title, or founder names. Generic words like startup add nothing.`,schemaType:`string`,location:`body`},{name:`location`,optionKey:`location`,flag:`--location <location>`,required:!1,description:`City, region, or country, such as Austin, TX. Tells namesakes apart; not proof on its own.`,schemaType:`string`,location:`body`},{name:`name`,optionKey:`name`,flag:`--name <name>`,required:!0,description:`Name exactly as the source writes it, such as Acme AI or Jane Doe.`,schemaType:`string`,location:`body`},{name:`sourceNewsId`,optionKey:`sourceNewsId`,flag:`--source-news-id <integer>`,required:!1,description:`aVenture news id of the article that mentions the subject; an unknown id is a 400.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`sourceUrl`,optionKey:`sourceUrl`,flag:`--source-url <source-url>`,required:!1,description:`URL of the article that mentions the subject; read from aVenture news when stored there, otherwise fetched.`,schemaType:`string`,location:`body`},{name:`url`,optionKey:`url`,flag:`--url <url...>`,required:!1,description:`URLs the subject owns: its website, its LinkedIn company or person profile, or a registry page. At most 10. Put articles in sourceUrl.`,schemaType:`array`,itemSchemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[{status:`402`,description:`The signed-in caller's plan does not include natural search.`},{status:`429`,description:`The caller's natural-search quota is spent; retry after the Retry-After seconds.`}],parameters:[{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Also considers hidden and unpublished records; needs private-visibility authority. Without it, NO_MATCH covers only records you can see.`,schemaType:`boolean`,location:`query`}]},{operationId:`lookupPersonBatch`,method:`POST`,path:`/v1/people/lookup-batch`,resource:`people`,intent:`lookup`,cliPath:[`people`,`lookup-batch`],summary:`Look up people in bulk by id or slug`,description:`Enrich multiple people by id or slug with optional url, association, and address. When page and size are omitted, the full deduplicated batch is returned in request order. Sort is not supported for this fixed-order batch response. A signed-in user's read charges one view per distinct returned record against the monthly entity or person view allowance; a repeat read of the same record in the month is free, and an exhausted cap answers 429 with Retry-After. Reads made without a signed-in user are never charged.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/person/lookup-batch`,schemaName:`PersonLookupBatchSchema`,kind:`json`,contentType:`application/json`,description:`Batch request for person detail enrichment. Each selector array accepts at most 200 values, and at most 200 selectors may be submitted across personId, slug, and url.`,required:!1,requiredPath:[],parameter:[{name:`hasImageFirst`,optionKey:`hasImageFirst`,flag:`--has-image-first <true|false>`,required:!1,description:`Sort results by image presence.`,schemaType:`boolean`,defaultValue:!1,location:`body`},{name:`includeAddress`,optionKey:`includeAddress`,flag:`--include-address <true|false>`,required:!1,description:`Include address values.`,schemaType:`boolean`,defaultValue:!0,location:`body`},{name:`includeAssociation`,optionKey:`includeAssociation`,flag:`--include-association <true|false>`,required:!1,description:`Include association values.`,schemaType:`boolean`,defaultValue:!0,location:`body`},{name:`includeUrl`,optionKey:`includeUrl`,flag:`--include-url <true|false>`,required:!1,description:`Include URL links.`,schemaType:`boolean`,defaultValue:!0,location:`body`},{name:`maxAssociations`,optionKey:`maxAssociations`,flag:`--max-associations <integer>`,required:!1,description:`Max association values per person.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`40`,location:`body`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Permit monogram fallbacks.`,schemaType:`boolean`,defaultValue:!0,location:`body`},{name:`personId`,optionKey:`personId`,flag:`--person-id <person-id...>`,required:!1,description:`Person UUID values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`slug`,optionKey:`slug`,flag:`--slug <slug...>`,required:!1,description:`Person slug values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`url`,optionKey:`url`,flag:`--url <url...>`,required:!1,description:`Person URL values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes private fields when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N); omit page and size for the full batch.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned; omit page and size for the full batch.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`}]},{operationId:`searchPeopleByNaturalLanguage`,method:`POST`,path:`/v1/people/natural-search`,resource:`people`,intent:`search`,cliPath:[`people`,`natural-search`],summary:`Deprecated: find people in natural language`,description:`Deprecated: use search natural people (POST /v1/search/natural/people) with the same body and parameters.`,explain:!0,deprecated:!0,requestBody:[{schemaImport:`@aventurevc/api-schemas/person/natural-search`,schemaName:`PersonNaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English people search plus explicit hard constraints. The planner may fill only filter fields the caller leaves unset.`,required:!0,requiredPath:[`search`,`search.query`],parameter:[{name:`filter.arrayFilter.amountInvestedRange[].min`,optionKey:`fundraiseAmountInvestedRangeMin`,flag:`--fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.arrayFilter.amountRaisedRange[].min`,optionKey:`fundraiseAmountRaisedRangeMin`,flag:`--fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.arrayFilter.totalInvestmentCount[].min`,optionKey:`totalInvestmentCountMin`,flag:`--total-investment-count-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.investorActivity.averageAmountInvestedUsdRange[].min`,optionKey:`investorActivityAverageAmountInvestedUsdRangeMin`,flag:`--investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.largestAmountInvestedUsdRange[].min`,optionKey:`investorActivityLargestAmountInvestedUsdRangeMin`,flag:`--investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.smallestAmountInvestedUsdRange[].min`,optionKey:`investorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.totalAmountInvestedUsdRange[].min`,optionKey:`investorActivityTotalAmountInvestedUsdRangeMin`,flag:`--investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.totalInvestmentRange[].min`,optionKey:`investorActivityTotalInvestmentRangeMin`,flag:`--investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.arrayFilter.amountInvestedRange[].max`,optionKey:`fundraiseAmountInvestedRangeMax`,flag:`--fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.arrayFilter.amountRaisedRange[].max`,optionKey:`fundraiseAmountRaisedRangeMax`,flag:`--fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.arrayFilter.totalInvestmentCount[].max`,optionKey:`totalInvestmentCountMax`,flag:`--total-investment-count-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.investorActivity.averageAmountInvestedUsdRange[].max`,optionKey:`investorActivityAverageAmountInvestedUsdRangeMax`,flag:`--investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.largestAmountInvestedUsdRange[].max`,optionKey:`investorActivityLargestAmountInvestedUsdRangeMax`,flag:`--investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.smallestAmountInvestedUsdRange[].max`,optionKey:`investorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.totalAmountInvestedUsdRange[].max`,optionKey:`investorActivityTotalAmountInvestedUsdRangeMax`,flag:`--investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.totalInvestmentRange[].max`,optionKey:`investorActivityTotalInvestmentRangeMax`,flag:`--investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.arrayFilter.entityName`,optionKey:`entityName`,flag:`--entity-name <entity-name...>`,required:!1,description:`Associated entity names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.arrayFilter.investedCompany`,optionKey:`fundraiseInvestedCompanyName`,flag:`--fundraise-invested-company-name <fundraise-invested-company-name...>`,required:!1,description:`Invested company names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.arrayFilter.personTitle`,optionKey:`personTitle`,flag:`--person-title <person-title...>`,required:!1,description:`Person titles.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.arrayFilter.round`,optionKey:`fundraiseRound`,flag:`--fundraise-round <fundraise-round...>`,required:!1,description:`Fundraise round labels.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.arrayFilter.typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Associated entity type scope. Omit or use [] for any associated type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`filter.entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!1,description:`Associated entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`body`},{name:`filter.entitySlug`,optionKey:`entitySlug`,flag:`--entity-slug <entity-slug>`,required:!1,description:`Associated entity slug.`,schemaType:`string`,location:`body`},{name:`filter.firstName`,optionKey:`firstName`,flag:`--first-name <first-name>`,required:!1,description:`Person first name.`,schemaType:`string`,location:`body`},{name:`filter.includeAddress`,optionKey:`includeAddress`,flag:`--include-address <true|false>`,required:!1,description:`Include addresses on each person.`,schemaType:`boolean`,location:`body`},{name:`filter.includeUrl`,optionKey:`includeUrl`,flag:`--include-url <true|false>`,required:!1,description:`Include URL links on each person.`,schemaType:`boolean`,location:`body`},{name:`filter.isCurrent`,optionKey:`isCurrent`,flag:`--is-current <true|false>`,required:!1,description:`Filter current associations.`,schemaType:`boolean`,location:`body`},{name:`filter.lastName`,optionKey:`lastName`,flag:`--last-name <last-name>`,required:!1,description:`Person last name.`,schemaType:`string`,location:`body`},{name:`filter.letter`,optionKey:`letter`,flag:`--letter <letter>`,required:!1,description:`First-name initial.`,schemaType:`string`,location:`body`},{name:`filter.personId`,optionKey:`personId`,flag:`--person-id <person-id...>`,required:!1,description:`Restrict results to specific person IDs. Omit or use [] for no ID restriction.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.personName`,optionKey:`personName`,flag:`--person-name <person-name...>`,required:!1,description:`Exact normalized match against a person's full name or slug.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.role`,optionKey:`role`,flag:`--role <role>`,required:!1,description:`Associated entity role or title.`,schemaType:`string`,location:`body`},{name:`filter.search`,optionKey:`search`,flag:`--search <search>`,required:!1,description:`Search keyword or phrase. Single characters valid; stop words rejected.`,schemaType:`string`,location:`body`},{name:`filter.semanticQuery`,optionKey:`semanticQuery`,flag:`--semantic-query <semantic-query>`,required:!1,description:`Semantic person search phrase.`,schemaType:`string`,location:`body`},{name:`filter.status`,optionKey:`status`,flag:`--status <status>`,required:!1,description:`Person workflow status.`,schemaType:`string`,location:`body`},{name:`search.mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value; news and federated search accept only `auto` and `keyword`; content search accepts only `auto`. Allowed values: auto, exact, keyword, semantic, natural.",schemaType:`string`,defaultValue:`auto`,choices:[`auto`,`exact`,`keyword`,`semantic`,`natural`],location:`body`},{name:`search.model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Optional chat model for planning; null uses the configured natural-search default. A caller without admin authority may only choose an allowlisted model; admin callers are unrestricted.`,schemaType:`string`,location:`body`},{name:`search.query`,optionKey:`query`,flag:`--query <query>`,required:!0,description:`Plain-English search request.`,schemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`When false, generated monogram pictures are stripped from person rows.`,schemaType:`boolean`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes hidden or off-sitemap people when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`searchPeople`,method:`POST`,path:`/v1/people/search`,resource:`people`,intent:`search`,cliPath:[`people`,`search`],summary:`Search people`,description:`Browse, filter, and search person, people, and individual records in the people domain; returns a paginated people list matching a filter request body. semanticQuery uses the live priority embeddings tier and returns semanticMatch evidence. Without semanticQuery or search, a default-sorted page emits an X-Next-Cursor keyset continuation; send it back as cursor, without sort, to read the next page.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/person/filter`,schemaName:`PersonFilterSchema`,kind:`json`,contentType:`application/json`,description:`Canonical person criteria contract for GET/POST/batch endpoints`,required:!1,requiredPath:[],parameter:[{name:`arrayFilter.amountInvestedRange[].min`,optionKey:`fundraiseAmountInvestedRangeMin`,flag:`--fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`arrayFilter.amountRaisedRange[].min`,optionKey:`fundraiseAmountRaisedRangeMin`,flag:`--fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`arrayFilter.totalInvestmentCount[].min`,optionKey:`totalInvestmentCountMin`,flag:`--total-investment-count-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`investorActivity.averageAmountInvestedUsdRange[].min`,optionKey:`investorActivityAverageAmountInvestedUsdRangeMin`,flag:`--investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`investorActivity.largestAmountInvestedUsdRange[].min`,optionKey:`investorActivityLargestAmountInvestedUsdRangeMin`,flag:`--investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`investorActivity.smallestAmountInvestedUsdRange[].min`,optionKey:`investorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`investorActivity.totalAmountInvestedUsdRange[].min`,optionKey:`investorActivityTotalAmountInvestedUsdRangeMin`,flag:`--investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`investorActivity.totalInvestmentRange[].min`,optionKey:`investorActivityTotalInvestmentRangeMin`,flag:`--investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`arrayFilter.amountInvestedRange[].max`,optionKey:`fundraiseAmountInvestedRangeMax`,flag:`--fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`arrayFilter.amountRaisedRange[].max`,optionKey:`fundraiseAmountRaisedRangeMax`,flag:`--fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`arrayFilter.totalInvestmentCount[].max`,optionKey:`totalInvestmentCountMax`,flag:`--total-investment-count-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`investorActivity.averageAmountInvestedUsdRange[].max`,optionKey:`investorActivityAverageAmountInvestedUsdRangeMax`,flag:`--investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`investorActivity.largestAmountInvestedUsdRange[].max`,optionKey:`investorActivityLargestAmountInvestedUsdRangeMax`,flag:`--investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`investorActivity.smallestAmountInvestedUsdRange[].max`,optionKey:`investorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`investorActivity.totalAmountInvestedUsdRange[].max`,optionKey:`investorActivityTotalAmountInvestedUsdRangeMax`,flag:`--investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`investorActivity.totalInvestmentRange[].max`,optionKey:`investorActivityTotalInvestmentRangeMax`,flag:`--investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`arrayFilter.entityName`,optionKey:`entityName`,flag:`--entity-name <entity-name...>`,required:!1,description:`Associated entity names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`arrayFilter.investedCompany`,optionKey:`fundraiseInvestedCompanyName`,flag:`--fundraise-invested-company-name <fundraise-invested-company-name...>`,required:!1,description:`Invested company names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`arrayFilter.personTitle`,optionKey:`personTitle`,flag:`--person-title <person-title...>`,required:!1,description:`Person titles.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`arrayFilter.round`,optionKey:`fundraiseRound`,flag:`--fundraise-round <fundraise-round...>`,required:!1,description:`Fundraise round labels.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`arrayFilter.typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Associated entity type scope. Omit or use [] for any associated type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!1,description:`Associated entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`body`},{name:`entitySlug`,optionKey:`entitySlug`,flag:`--entity-slug <entity-slug>`,required:!1,description:`Associated entity slug.`,schemaType:`string`,location:`body`},{name:`firstName`,optionKey:`firstName`,flag:`--first-name <first-name>`,required:!1,description:`Person first name.`,schemaType:`string`,location:`body`},{name:`includeAddress`,optionKey:`includeAddress`,flag:`--include-address <true|false>`,required:!1,description:`Include addresses on each person.`,schemaType:`boolean`,location:`body`},{name:`includeUrl`,optionKey:`includeUrl`,flag:`--include-url <true|false>`,required:!1,description:`Include URL links on each person.`,schemaType:`boolean`,location:`body`},{name:`isCurrent`,optionKey:`isCurrent`,flag:`--is-current <true|false>`,required:!1,description:`Filter current associations.`,schemaType:`boolean`,location:`body`},{name:`lastName`,optionKey:`lastName`,flag:`--last-name <last-name>`,required:!1,description:`Person last name.`,schemaType:`string`,location:`body`},{name:`letter`,optionKey:`letter`,flag:`--letter <letter>`,required:!1,description:`First-name initial.`,schemaType:`string`,location:`body`},{name:`personId`,optionKey:`personId`,flag:`--person-id <person-id...>`,required:!1,description:`Restrict results to specific person IDs. Omit or use [] for no ID restriction.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`personName`,optionKey:`personName`,flag:`--person-name <person-name...>`,required:!1,description:`Exact normalized match against a person's full name or slug.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`role`,optionKey:`role`,flag:`--role <role>`,required:!1,description:`Associated entity role or title.`,schemaType:`string`,location:`body`},{name:`search`,optionKey:`search`,flag:`--search <search>`,required:!1,description:`Search keyword or phrase. Single characters valid; stop words rejected.`,schemaType:`string`,location:`body`},{name:`semanticQuery`,optionKey:`semanticQuery`,flag:`--semantic-query <semantic-query>`,required:!1,description:`Semantic person search phrase.`,schemaType:`string`,location:`body`},{name:`status`,optionKey:`status`,flag:`--status <status>`,required:!1,description:`Person workflow status.`,schemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`countOnly`,optionKey:`countOnly`,flag:`--count-only <true|false>`,required:!1,description:`When true, return only the page total in the body and skip the content payload.`,schemaType:`boolean`,location:`query`},{name:`hasImageFirst`,optionKey:`hasImageFirst`,flag:`--has-image-first <true|false>`,required:!1,description:`When true, sort people who have a photo before those who do not.`,schemaType:`boolean`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`When false, monogram fallback logos are stripped from the response. Defaults to true.`,schemaType:`boolean`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes hidden, unverified, and not-yet-published records when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`,location:`query`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Opaque continuation from X-Next-Cursor. Repeat the same filters and size; a semantic cursor also repeats sort, a keyset cursor omits it.`,schemaType:`string`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`25`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getResolvedHandle`,method:`GET`,path:`/v1/resolve/{token}`,resource:`resolve`,intent:`read`,cliPath:[`resolve`,`get`],summary:`Deprecated: find the record behind an id, slug, or URL`,description:`Deprecated: use POST /v1/lookup?legacy=true with body {"name":"<token>"}. Resolve any identifier token to its canonical entity or person. Tries UUID, then the stable public handle, then external registry ids, then the slug (with redirects). Returns 404 when nothing matches and 409 when an external id maps to multiple owners. A name or website URL is not a token; resolve it with the entity or person lookup.`,deprecated:!0,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`token`,optionKey:`token`,flag:`--token <token>`,required:!0,description:`Any identifier: a stable public handle (e.g. eV1StGXR8Z5a), a UUID, an external registry id (ticker, LEI, EIN, ...), or a slug.`,schemaType:`string`,location:`path`}]},{operationId:`searchAll`,method:`POST`,path:`/v1/search/all`,resource:`search`,intent:`search`,cliPath:[`search`,`all`],summary:`Deprecated: search companies, people, and news together`,description:`Deprecated: use search (POST /v1/search) with the same body.`,deprecated:!0,requestBody:[{schemaImport:`@aventurevc/api-schemas/natural/search`,schemaName:`NaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English search request. The server plans the query into the target domain filter plus sort, then runs that domain's canonical list engine.`,required:!0,requiredPath:[`query`],parameter:[{name:`mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value; news and federated search accept only `auto` and `keyword`; content search accepts only `auto`. Allowed values: auto, exact, keyword, semantic, natural.",schemaType:`string`,defaultValue:`auto`,choices:[`auto`,`exact`,`keyword`,`semantic`,`natural`],location:`body`},{name:`model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Optional chat model for planning; null uses the configured natural-search default. A caller without admin authority may only choose an allowlisted model; admin callers are unrestricted.`,schemaType:`string`,location:`body`},{name:`query`,optionKey:`query`,flag:`--query <query>`,required:!0,description:`Plain-English search request.`,schemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`}]},{operationId:`searchLink`,method:`GET`,path:`/v1/search/link`,resource:`search`,intent:`search`,cliPath:[`search`,`link`],summary:`Search from a page URL`,description:`Fetches the page at the supplied URL, identifies the single company, product, or person the page is primarily about, and returns the federated entity, person, and news results for that name together with the synthesized query itself. A page whose content cannot be read returns 404; a fetch or inference failure returns a problem (503 only when a retry can succeed), never an empty result. For direct URL-to-record identity resolution use the entities lookup operation with the url instead.`,scope:`read`,auth:`bearer`,errorResponse:[{status:`402`,description:`The authenticated caller's subscription does not include this search.`}],parameters:[{name:`url`,optionKey:`url`,flag:`--url <url>`,required:!0,description:`Public article or page URL to search from.`,schemaType:`string`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`}]},{operationId:`lookupUniqueId`,method:`GET`,path:`/v1/unique-ids/lookup`,resource:`unique-ids`,intent:`lookup`,cliPath:[`unique-ids`,`lookup`],summary:`Look up an identifier owner`,description:`Resolves an external identifier to its owner(s). idType accepts a canonical token or alias; the value is normalized per type before matching. Returns every owner that carries the identifier (a value can recur across owners, e.g. a reused ticker), each row carrying its entityId or personId.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`idType`,optionKey:`idType`,flag:`--id-type <id-type>`,required:!0,description:`Identifier type token or alias, for example ein.`,schemaType:`string`,location:`query`},{name:`identifier`,optionKey:`identifier`,flag:`--identifier <identifier>`,required:!0,description:`Identifier value to resolve.`,schemaType:`string`,location:`query`}]},{operationId:`listUrlTypes`,method:`GET`,path:`/v1/url-types`,resource:`url-types`,intent:`read`,cliPath:[`url-types`,`list`],summary:`List URL types`,description:`Returns the canonical URL types and aliases accepted by entity and person URL rows. One catalog serves both owners.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[]},{operationId:`searchWeb`,method:`POST`,path:`/v1/web/search`,resource:`web`,intent:`search`,cliPath:[`web`,`search`],summary:`Search the live web`,description:`Runs a live web search, returns a stored result when a fresh version exists, and durably records fresh results in the source-document store. Each successful search attributed to a Clerk user, including an owner-acting machine run, uses one web search from that user's monthly allowance. Past it, a subscriber with additional usage on pays 2.5 cents per search; otherwise the call answers 429. Bare machine and legacy client/admin credentials remain admitted without a user allowance during migration. A query naming too few distinct words (a bare brand, or a brand plus a number) is refused with 422 before any provider call or charge; name what you are looking for and a disambiguator such as the domain.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/search/search`,schemaName:`SearchSchema`,kind:`json`,contentType:`application/json`,description:`Live web search request with cache controls`,required:!0,requiredPath:[`search`],parameter:[{name:`bypassCache`,optionKey:`bypassCache`,flag:`--bypass-cache <true|false>`,required:!1,description:`Skip cache lookup and refresh from the search provider.`,schemaType:`boolean`,defaultValue:!1,location:`body`},{name:`cacheKey`,optionKey:`cacheKey`,flag:`--cache-key <cache-key>`,required:!1,description:`Stable lookup text for cache keying when generated search text varies between runs.`,schemaType:`string`,location:`body`},{name:`language`,optionKey:`language`,flag:`--language <language>`,required:!1,description:`Search language code.`,schemaType:`string`,location:`body`},{name:`region`,optionKey:`region`,flag:`--region <region>`,required:!1,description:`Search region code.`,schemaType:`string`,location:`body`},{name:`resultLimit`,optionKey:`resultLimit`,flag:`--result-limit <integer>`,required:!1,description:`Maximum number of normalized results to keep.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`search`,optionKey:`search`,flag:`--search <search>`,required:!0,description:`Search text sent to the upstream web search provider.`,schemaType:`string`,location:`body`},{name:`source`,optionKey:`source`,flag:`--source <source>`,required:!1,description:`Optional caller identity for source-document attribution and abuse triage. Any non-blank string up to 64 characters is accepted and persisted with the resolved request context.`,schemaType:`string`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[],parameters:[]},{operationId:`answerAgentHelpQuestion`,method:`POST`,path:`/v1/agents/help`,resource:`agents`,intent:`search`,cliPath:[`agents`,`help`,`answer`],summary:`Deprecated: answer a natural-language platform help question`,description:`Deprecated: use help ask (POST /v1/help) with the same body. Help is free; legacy client and admin keys remain accepted during migration.`,deprecated:!0,requestBody:[{schemaImport:`@aventurevc/api-schemas/agent/help-question`,schemaName:`AgentHelpQuestionSchema`,kind:`json`,contentType:`application/json`,description:`A natural-language question about how to operate the platform, answered from the operation catalog, agent skills, and completion gates.`,required:!0,requiredPath:[`question`],parameter:[{name:`model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Optional chat model that answers the question; null uses the configured default. A caller without admin authority may only choose an allowlisted model; an ineligible model is rejected with 422. Admin callers are unrestricted.`,schemaType:`string`,location:`body`},{name:`question`,optionKey:`question`,flag:`--question <question>`,required:!0,description:`The question to answer, in natural language.`,schemaType:`string`,location:`body`},{name:`scope`,optionKey:`scope`,flag:`--scope <scope>`,required:!1,description:`Optional scope restricting which operations the answer may recommend; null means all. Allowed values: READ, WRITE, ALL.`,schemaType:`string`,choices:[`READ`,`WRITE`,`ALL`],location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],parameters:[]},{operationId:`getAgentInstructionAtRetiredAddress`,method:`GET`,path:`/v1/agents/instructions/{kind}/{name}`,resource:`agents`,intent:`read`,cliPath:[`agents`,`instructions`,`get`],summary:`Deprecated: get one agent instruction document`,description:`Deprecated: use help instructions get (GET /v1/help/instructions/{kind}/{name}).`,deprecated:!0,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`kind`,optionKey:`kind`,flag:`--kind <kind>`,required:!0,description:`Document kind: prompt, skill, or agent. Allowed values: PROMPT, SKILL, AGENT.`,schemaType:`string`,choices:[`PROMPT`,`SKILL`,`AGENT`],location:`path`},{name:`name`,optionKey:`name`,flag:`--name <name>`,required:!0,description:`Manifest name of the document.`,schemaType:`string`,location:`path`}]},{operationId:`getCurrentApiKey`,method:`GET`,path:`/v1/auth/api-key`,resource:`auth`,intent:`read`,cliPath:[`auth`,`api-key`,`get`],summary:`Get current API key`,description:`Returns provider metadata for the aVenture API key authenticating this request.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[]},{operationId:`revokeCurrentApiKey`,method:`DELETE`,path:`/v1/auth/api-key`,resource:`auth`,intent:`delete`,cliPath:[`auth`,`api-key`,`revoke`],summary:`Revoke current API key`,description:`Revokes the aVenture API key authenticating this request and returns its metadata so the CLI can confirm revocation before deleting its saved copy.`,scope:`write`,auth:`bearer`,errorResponse:[],parameters:[]},{operationId:`getAuthProviderCatalog`,method:`GET`,path:`/v1/auth/providers`,resource:`auth`,intent:`read`,cliPath:[`auth`,`providers`,`get`],summary:`Get the public authentication provider catalog`,description:`Sign-in provider availability and CLI OAuth configuration. Public — callers read it before any session exists. A non-null Clerk publishable key offers browser sign-in; a non-null OAuth client offers the PKCE CLI sign-in lane.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[]},{operationId:`getAiCredits`,method:`GET`,path:`/v1/billing/ai-credits`,resource:`billing`,intent:`read`,cliPath:[`billing`,`ai-credits`,`get`],summary:`Read the current AI credit allowance`,description:`AI credits are Researchly messages sent in Researchly's current billing period; the cap comes from the caller's tier and resetAt is Researchly's period end.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[]},{operationId:`createBillingCheckoutSession`,method:`POST`,path:`/v1/billing/checkout-sessions`,resource:`billing`,intent:`write`,cliPath:[`billing`,`checkout-sessions`,`create`],summary:`Create or recover a hosted Checkout Session`,description:`Start the selected AI Plus or AI Pro plan through hosted Checkout. A caller with a continuing subscription changes plan with POST /v1/billing/plan-changes and cancels or resumes it through a Billing Portal Session.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/billing/checkout-mutation`,schemaName:`BillingCheckoutMutationSchema`,kind:`json`,contentType:`application/json`,description:`Caller-selected plan for server-owned hosted Checkout creation.`,required:!0,requiredPath:[`plan`],parameter:[{name:`plan`,optionKey:`plan`,flag:`--plan <plan>`,required:!0,description:`AI Plus or AI Pro plan to start through hosted Checkout. Allowed values: PLUS_MONTHLY, PLUS_YEARLY, PRO_MONTHLY, PRO_YEARLY, PRO_YEARLY_PROMOTION.`,schemaType:`string`,choices:[`PLUS_MONTHLY`,`PLUS_YEARLY`,`PRO_MONTHLY`,`PRO_YEARLY`,`PRO_YEARLY_PROMOTION`],location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[],parameters:[]},{operationId:`createBillingPlanChange`,method:`POST`,path:`/v1/billing/plan-changes`,resource:`billing`,intent:`write`,cliPath:[`billing`,`plan-changes`,`create`],summary:`Change the subscription plan`,description:`Move an active AI Plus or AI Pro subscription to another plan. A higher tier or a longer billing period applies now and invoices the prorated difference; paymentUrl is set when that invoice needs the customer to pay before the change applies. Any other change takes effect at the current period end. Sending the current plan cancels a scheduled change.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/billing/plan-change-mutation`,schemaName:`BillingPlanChangeMutationSchema`,kind:`json`,contentType:`application/json`,description:`Caller-selected plan for changing a continuing AI Plus or AI Pro subscription.`,required:!0,requiredPath:[`plan`],parameter:[{name:`plan`,optionKey:`plan`,flag:`--plan <plan>`,required:!0,description:`AI Plus or AI Pro plan to move to; the current plan cancels a scheduled change. Allowed values: PLUS_MONTHLY, PLUS_YEARLY, PRO_MONTHLY, PRO_YEARLY, PRO_YEARLY_PROMOTION.`,schemaType:`string`,choices:[`PLUS_MONTHLY`,`PLUS_YEARLY`,`PRO_MONTHLY`,`PRO_YEARLY`,`PRO_YEARLY_PROMOTION`],location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[],parameters:[]},{operationId:`listPlans`,method:`GET`,path:`/v1/billing/plans`,resource:`billing`,intent:`read`,cliPath:[`billing`,`plans`,`list`],summary:`List subscription tiers and plans`,description:`Return every self-serve tier with its monthly allowance caps and every Checkout plan with its recurring price. Public; needs no credentials.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[]},{operationId:`createBillingPortalSession`,method:`POST`,path:`/v1/billing/portal-sessions`,resource:`billing`,intent:`write`,cliPath:[`billing`,`portal-sessions`,`create`],summary:`Create a hosted Billing Portal Session`,description:`Open the authenticated user's Stripe Billing Portal to manage the continuing subscription.`,scope:`write`,auth:`bearer`,errorResponse:[],parameters:[]},{operationId:`getBillingSubscription`,method:`GET`,path:`/v1/billing/subscription`,resource:`billing`,intent:`read`,cliPath:[`billing`,`subscription`,`get`],summary:`Read the current billing subscription`,description:`Return sanitized Essential, AI Plus, AI Pro, or Unlimited subscription, entitlement, monthly allowance usage, and additional usage spent and available.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[]},{operationId:`getEntityAcquisition`,method:`GET`,path:`/v1/entities/{entityId}/acquisitions/{relationshipId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`acquisitions`,`get`],summary:`Get one company acquisition`,description:`VISIBILITY-GATED READ: a row is returned only when BOTH the acquired and acquirer entities are publicly visible. An acquisition relationship that already exists (and is visible in the entity relationships resource) but returns 404 here means one counterpart entity is still hidden -- publish that entity (statusSitemapShow=true, statusHidePage=false) -- it is an unmet visibility prerequisite, not data-layer inconsistency or projection lag. A gated miss on an existing row returns 404 with title 'Acquisition Exists but a Counterpart Entity Is Not Public'. The acquired/acquirer roles in each row are always declared explicitly in the response via the acquiredEntity and acquirerEntity fields. The role query parameter only selects which side the path entity occupies in the WHERE clause: acquired (default) lists acquisitions where the path entity was bought; acquirer lists acquisitions where the path entity was the buyer; all lists or reads both sides in one response. Writes (POST/PUT/PATCH/DELETE) ignore role and always treat the path entity as acquired.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID whose acquisition rows are being read or written.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`relationshipId`,optionKey:`relationshipId`,flag:`--relationship-id <integer>`,required:!0,description:`Acquisition relationship row id (entity_relationship.id).`,schemaType:`integer`,schemaFormat:`int32`,location:`path`},{name:`role`,optionKey:`role`,flag:`--role <role>`,required:!1,description:"Selects which side the path entity occupies in the WHERE clause: `acquired` (default) lists rows where the path entity was bought; `acquirer` lists rows where the path entity was the buyer; `all` reads either side. Allowed values: acquired, acquirer, all.",schemaType:`string`,defaultValue:`acquired`,choices:[`acquired`,`acquirer`,`all`],location:`query`}]},{operationId:`listEntityAcquisitions`,method:`GET`,path:`/v1/entities/{entityId}/acquisitions`,resource:`entities`,intent:`read`,cliPath:[`entities`,`acquisitions`,`list`],summary:`List a company's acquisitions`,description:`VISIBILITY-GATED READ: a row is returned only when BOTH the acquired and acquirer entities are publicly visible. An acquisition relationship that already exists (and is visible in the entity relationships resource) but returns 404 here means one counterpart entity is still hidden -- publish that entity (statusSitemapShow=true, statusHidePage=false) -- it is an unmet visibility prerequisite, not data-layer inconsistency or projection lag. The acquired/acquirer roles in each row are always declared explicitly in the response via the acquiredEntity and acquirerEntity fields. The role query parameter only selects which side the path entity occupies in the WHERE clause: acquired (default) lists acquisitions where the path entity was bought; acquirer lists acquisitions where the path entity was the buyer; all lists or reads both sides in one response. Writes (POST/PUT/PATCH/DELETE) ignore role and always treat the path entity as acquired. List responses are ordered by most recent acquisition event first.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID whose acquisition rows are being read or written.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`role`,optionKey:`role`,flag:`--role <role>`,required:!1,description:"Selects which side the path entity occupies in the WHERE clause: `acquired` (default) lists rows where the path entity was bought; `acquirer` lists rows where the path entity was the buyer; `all` lists both sides. Allowed values: acquired, acquirer, all.",schemaType:`string`,defaultValue:`acquired`,choices:[`acquired`,`acquirer`,`all`],location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`20`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getEntityAddress`,method:`GET`,path:`/v1/entities/{entityId}/addresses/{addressJoinId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`addresses`,`get`],summary:`Get one company address`,description:`Returns the physical address group containing the selected entity address association. Requires read auth.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`addressJoinId`,optionKey:`addressJoinId`,flag:`--address-join-id <integer>`,required:!0,description:`Address join id parameter.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`}]},{operationId:`listEntityAddresses`,method:`GET`,path:`/v1/entities/{entityId}/addresses`,resource:`entities`,intent:`read`,cliPath:[`entities`,`addresses`,`list`],summary:`List a company's locations`,description:"Returns current physical addresses with their role-period associations, ordered HQ-first, primary-next, most-recent-first (`updated_at DESC`). Reads directly from the base tables so fresh writes surface immediately (bypassing the mv_entity_addresses materialized view). Set includeInactive=true as a signed-in user or with read credentials to include inactive/historical rows.",scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`includeInactive`,optionKey:`includeInactive`,flag:`--include-inactive <true|false>`,required:!1,description:`Include inactive rows.`,schemaType:`boolean`,defaultValue:!1,location:`query`}]},{operationId:`getEntityBlogPost`,method:`GET`,path:`/v1/entities/{entityId}/blog-posts/{blogPostId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`blog-posts`,`get`],summary:`Get one company blog post`,description:`Returns one entity-owned external link by id. Any signed-in user may call this.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID owning the blog post row.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`blogPostId`,optionKey:`blogPostId`,flag:`--blog-post-id <uuid>`,required:!0,description:`Blog post UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listEntityBlogPosts`,method:`GET`,path:`/v1/entities/{entityId}/blog-posts`,resource:`entities`,intent:`read`,cliPath:[`entities`,`blog-posts`,`list`],summary:`List a company's blog posts`,description:"Returns active external blog post links stored in research.res_blog_article. NOT FOR: News/press coverage; use `news list`.",scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID owning the blog post rows.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`includeInactive`,optionKey:`includeInactive`,flag:`--include-inactive <true|false>`,required:!1,description:`Include inactive research blog post rows.`,schemaType:`boolean`,defaultValue:!1,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`10`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,defaultValue:[`publishedAt,desc`],location:`query`}]},{operationId:`listEntityClassifications`,method:`GET`,path:`/v1/entities/{entityId}/classifications`,resource:`entities`,intent:`read`,cliPath:[`entities`,`classifications`,`list`],summary:`List a company's classifications`,description:`Returns joins grouped by bucket. The default view includes current rows; includeInactive=true adds historical rows and requires read auth. Callers with private-visibility authority can also resolve hidden or private entities; setting includePrivate=true requires that authority. Signed-in callers without it can access public entities, while hidden entities return 404.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`includeInactive`,optionKey:`includeInactive`,flag:`--include-inactive <true|false>`,required:!1,description:`Include inactive/historical entity classification join rows; default false returns only current joins.`,schemaType:`boolean`,defaultValue:!1,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes private or hidden entity classification rows when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`,location:`query`}]},{operationId:`listEntityContent`,method:`GET`,path:`/v1/entities/{entityId}/content`,resource:`entities`,intent:`read`,cliPath:[`entities`,`content`,`list`],summary:`List a company's publications`,description:`Returns news articles, blog posts, repositories, websites, and pages related to an entity. Any signed-in user may call this.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID whose publications are listed.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`topic`,optionKey:`topic`,flag:`--topic <topic>`,required:!1,description:`Topic key or source category.`,schemaType:`string`,location:`query`},{name:`contentType`,optionKey:`contentType`,flag:`--content-type <content-type>`,required:!1,description:`Public content type filter. Allowed values: newsArticle, blogPost, externalSocialPost, repositoryOwner, repository, webSite, webPage, researchPaper.`,schemaType:`string`,choices:[`newsArticle`,`blogPost`,`externalSocialPost`,`repositoryOwner`,`repository`,`webSite`,`webPage`,`researchPaper`],location:`query`},{name:`relation`,optionKey:`relation`,flag:`--relation <relation>`,required:!1,description:`Owner relation filter. Allowed values: by, about.`,schemaType:`string`,choices:[`by`,`about`],location:`query`},{name:`year`,optionKey:`year`,flag:`--year <integer>`,required:!1,description:`Best-effort content year filter.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`existenceProbe`,optionKey:`existenceProbe`,flag:`--existence-probe <true|false>`,required:!1,description:`Set true for first-page content-existence probes that do not need exact totals or stable ordering.`,schemaType:`boolean`,defaultValue:!1,location:`query`}]},{operationId:`searchEntityContent`,method:`POST`,path:`/v1/entities/{entityId}/content/search`,resource:`entities`,intent:`search`,cliPath:[`entities`,`content`,`search`],summary:`Search a company's publications`,description:`Translates plain-English constraints for one entity's content index. Any signed-in user may call this.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/natural/search`,schemaName:`NaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English search request. The server plans the query into the target domain filter plus sort, then runs that domain's canonical list engine.`,required:!0,requiredPath:[`query`],parameter:[{name:`mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value; news and federated search accept only `auto` and `keyword`; content search accepts only `auto`. Allowed values: auto, exact, keyword, semantic, natural.",schemaType:`string`,defaultValue:`auto`,choices:[`auto`,`exact`,`keyword`,`semantic`,`natural`],location:`body`},{name:`model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Optional chat model for planning; null uses the configured natural-search default. A caller without admin authority may only choose an allowlisted model; admin callers are unrestricted.`,schemaType:`string`,location:`body`},{name:`query`,optionKey:`query`,flag:`--query <query>`,required:!0,description:`Plain-English search request.`,schemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID whose publications are searched.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`listEntityEmployeeCounts`,method:`GET`,path:`/v1/entities/{entityId}/employee-counts`,resource:`entities`,intent:`read`,cliPath:[`entities`,`employee-counts`,`list`],summary:`List a company's headcount over time`,description:`Returns employee-count time series for the entity at this address. Results are sorted newest first. This endpoint does not support custom sorting.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned; maximum 500.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`25`,location:`query`}]},{operationId:`enrichEntity`,method:`POST`,path:`/v1/entities/{entityId}/enrichments`,resource:`entities`,intent:`write`,cliPath:[`entities`,`enrichments`,`enrich`],summary:`Enrich one company, product, or service`,description:"Queues a run that researches the addressed entity and updates its aVenture profile, owned by the authenticated caller. Take entityId from match.owner when POST /v1/lookup or POST /v1/entities/lookup returns MATCHED (CLI: lookup, entities lookup). When a run for this entity is already queued or running, returns that run instead of queuing and charging another; a new run spends one `company` research unit from the plan's research allowance. After the run completes, read the updated profile with GET /v1/entities/{entityId} (CLI: entities get). Check the run's progress with GET /v1/harness/runs/{runId} (CLI: harness runs get).",scope:`write`,auth:`bearer`,errorResponse:[{status:`402`,description:`The authenticated caller's subscription tier does not include research runs.`}],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:`COMPREHENSIVE (the default) researches the whole profile; INDIVIDUAL runs only the tasks named in taskPresetKey. Allowed values: COMPREHENSIVE, INDIVIDUAL.`,schemaType:`string`,choices:[`COMPREHENSIVE`,`INDIVIDUAL`],location:`query`},{name:`model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Model id for the run's lead agent; omit to use aVenture's default model.`,schemaType:`string`,location:`query`},{name:`userPrompt`,optionKey:`userPrompt`,flag:`--user-prompt <user-prompt>`,required:!1,description:`Plain-language instruction for this run, such as which facts or sources to check first.`,schemaType:`string`,location:`query`},{name:`taskPresetKey`,optionKey:`taskPresetKey`,flag:`--task-preset-key <task-preset-key...>`,required:!1,description:`Task preset keys that scope or emphasize this run; at least one is required when mode is INDIVIDUAL, and an unknown key is a 400.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`listEntityFilters`,method:`GET`,path:`/v1/entities/filters`,resource:`entities`,intent:`read`,cliPath:[`entities`,`filters`,`list`],summary:`List the company filter options`,description:`Get available filter options`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`typeGroup`,optionKey:`typeGroup`,flag:`--type-group <type-group>`,required:!1,description:`Type group for default filter scope. Ignored when typeRecord is provided. Allowed values: Organization, Investor.`,schemaType:`string`,choices:[`Organization`,`Investor`],location:`query`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record>`,required:!1,description:`Filter by entity type (Company, Investor, etc.).`,schemaType:`string`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Include governed expanded values available to authorized callers.`,schemaType:`boolean`,defaultValue:!1,location:`query`},{name:`includeDistribution`,optionKey:`includeDistribution`,flag:`--include-distribution <true|false>`,required:!1,description:`Include range distribution charts.`,schemaType:`boolean`,defaultValue:!1,location:`query`},{name:`distributionKey`,optionKey:`distributionKey`,flag:`--distribution-key <distribution-key...>`,required:!1,description:`Comma-separated or repeated filter keys for chart distribution (for example amountRaised,totalRaised).`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`refineEntityFilters`,method:`POST`,path:`/v1/entities/filters/refine`,resource:`entities`,intent:`lookup`,cliPath:[`entities`,`filters`,`refine`],summary:`Refine the company filter options`,description:`Return filter metadata scoped by current filters. Each filter entry reports choiceOptionTotal and choiceOptionTruncated so CLI and MCP callers can tell when the displayed choiceOption list is only the top scoped subset. Use the filter search endpoint with the same scopeFilter to look up values not shown in the refine response.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/filter`,schemaName:`EntityFilterSchema`,kind:`json`,contentType:`application/json`,description:`Entity list and search filters. GET flattens these fields as query parameters; POST accepts the same shape as JSON.`,required:!0,requiredPath:[],parameter:[{name:`employeeCountRange[].min`,optionKey:`employeeCountRangeMin`,flag:`--employee-count-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.amountInvestedRange[].min`,optionKey:`fundraiseAmountInvestedRangeMin`,flag:`--fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.amountRaisedRange[].min`,optionKey:`fundraiseAmountRaisedRangeMin`,flag:`--fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityAverageAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityLargestAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityTotalAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.totalInvestmentRange[].min`,optionKey:`fundraiseInvestorActivityTotalInvestmentRangeMin`,flag:`--fundraise-investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.lastRoundYearRange[].min`,optionKey:`fundraiseLastRoundYearRangeMin`,flag:`--fundraise-last-round-year-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.totalRaisedRange[].min`,optionKey:`fundraiseTotalRaisedRangeMin`,flag:`--fundraise-total-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.valuationRange[].min`,optionKey:`fundraiseValuationRangeMin`,flag:`--fundraise-valuation-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`yearFoundedRange[].min`,optionKey:`yearFoundedRangeMin`,flag:`--year-founded-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`employeeCountRange[].max`,optionKey:`employeeCountRangeMax`,flag:`--employee-count-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.amountInvestedRange[].max`,optionKey:`fundraiseAmountInvestedRangeMax`,flag:`--fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.amountRaisedRange[].max`,optionKey:`fundraiseAmountRaisedRangeMax`,flag:`--fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityAverageAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityLargestAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityTotalAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.totalInvestmentRange[].max`,optionKey:`fundraiseInvestorActivityTotalInvestmentRangeMax`,flag:`--fundraise-investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.lastRoundYearRange[].max`,optionKey:`fundraiseLastRoundYearRangeMax`,flag:`--fundraise-last-round-year-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.totalRaisedRange[].max`,optionKey:`fundraiseTotalRaisedRangeMax`,flag:`--fundraise-total-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.valuationRange[].max`,optionKey:`fundraiseValuationRangeMax`,flag:`--fundraise-valuation-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`yearFoundedRange[].max`,optionKey:`yearFoundedRangeMax`,flag:`--year-founded-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`acceleratorBrand`,optionKey:`acceleratorBrand`,flag:`--accelerator-brand <accelerator-brand...>`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`acceleratorCohort`,optionKey:`acceleratorCohort`,flag:`--accelerator-cohort <accelerator-cohort...>`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`acceleratorName`,optionKey:`acceleratorName`,flag:`--accelerator-name <accelerator-name...>`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`acceleratorStatus`,optionKey:`acceleratorStatus`,flag:`--accelerator-status <accelerator-status...>`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`affinity`,optionKey:`affinity`,flag:`--affinity <affinity...>`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <entity-id...>`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityName`,optionKey:`entityName`,flag:`--entity-name <entity-name...>`,required:!1,description:`Exact normalized match against entity brand or legal names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`featured`,optionKey:`featured`,flag:`--featured <true|false>`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`,location:`body`},{name:`fundraiseActivity.investedCompanyName`,optionKey:`fundraiseInvestedCompanyName`,flag:`--fundraise-invested-company-name <fundraise-invested-company-name...>`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`fundraiseActivity.round`,optionKey:`fundraiseRound`,flag:`--fundraise-round <fundraise-round...>`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`hasFundraising`,optionKey:`hasFundraising`,flag:`--has-fundraising <true|false>`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`,location:`body`},{name:`headquartersCity`,optionKey:`headquartersCity`,flag:`--headquarters-city <headquarters-city...>`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`headquartersCountry`,optionKey:`headquartersCountry`,flag:`--headquarters-country <headquarters-country...>`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`headquartersState`,optionKey:`headquartersState`,flag:`--headquarters-state <headquarters-state...>`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`industry`,optionKey:`industry`,flag:`--industry <industry...>`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`letter`,optionKey:`letter`,flag:`--letter <letter>`,required:!1,description:`First letter of the display name.`,schemaType:`string`,location:`body`},{name:`location`,optionKey:`location`,flag:`--location <location...>`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`logoOption.sortPriority`,optionKey:`logoSortPriority`,flag:`--logo-sort-priority <logo-sort-priority>`,required:!1,description:`Logo sort priority. Allowed values: NONE, ANY_LOGO_FIRST, REAL_LOGO_FIRST.`,schemaType:`string`,choices:[`NONE`,`ANY_LOGO_FIRST`,`REAL_LOGO_FIRST`],location:`body`},{name:`mainProduct`,optionKey:`mainProduct`,flag:`--main-product <main-product...>`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`operatingStatus`,optionKey:`operatingStatus`,flag:`--operating-status <operating-status...>`,required:!1,description:`Operating states to include; omit to include every state. Allowed values: Operating, Acquired, Acquired Subsidiary, Closed, Closed (Acquihire), Inactive.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`],location:`body`},{name:`person`,optionKey:`person`,flag:`--person <person...>`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`portfolioHeadquartersCity`,optionKey:`portfolioHeadquartersCity`,flag:`--portfolio-headquarters-city <portfolio-headquarters-city...>`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`portfolioHeadquartersCountry`,optionKey:`portfolioHeadquartersCountry`,flag:`--portfolio-headquarters-country <portfolio-headquarters-country...>`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`portfolioHeadquartersState`,optionKey:`portfolioHeadquartersState`,flag:`--portfolio-headquarters-state <portfolio-headquarters-state...>`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`qualityGate`,optionKey:`qualityGate`,flag:`--quality-gate <quality-gate>`,required:!1,description:`Named server-owned list quality gate. Allowed values: NONE, COMPANY_LISTING_READY.`,schemaType:`string`,choices:[`NONE`,`COMPANY_LISTING_READY`],location:`body`},{name:`slug`,optionKey:`slug`,flag:`--slug <slug...>`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`stage`,optionKey:`stage`,flag:`--stage <stage...>`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`suppressNonOperating`,optionKey:`suppressNonOperating`,flag:`--suppress-non-operating <true|false>`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`,location:`body`},{name:`suppressZeroTotalRaised`,optionKey:`suppressZeroTotalRaised`,flag:`--suppress-zero-total-raised <true|false>`,required:!1,description:`Suppress entities whose total raised is zero.`,schemaType:`boolean`,location:`body`},{name:`tag`,optionKey:`tag`,flag:`--tag <tag...>`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`textSearch`,optionKey:`textSearch`,flag:`--text-search <text-search>`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`,location:`body`},{name:`typeCustomer`,optionKey:`typeCustomer`,flag:`--type-customer <type-customer...>`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`typeModel`,optionKey:`typeModel`,flag:`--type-model <type-model...>`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`typeOwnership`,optionKey:`typeOwnership`,flag:`--type-ownership <type-ownership...>`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`typeRevenue`,optionKey:`typeRevenue`,flag:`--type-revenue <type-revenue...>`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`typeTechnologyUsed`,optionKey:`typeTechnologyUsed`,flag:`--type-technology-used <type-technology-used...>`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`url`,optionKey:`url`,flag:`--url <url>`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`,location:`body`},{name:`urlDomain`,optionKey:`urlDomain`,flag:`--url-domain <url-domain>`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`,location:`body`},{name:`urlMatchMode`,optionKey:`urlMatchMode`,flag:`--url-match-mode <url-match-mode>`,required:!1,description:`URL matching mode: hostPath uses host and path; domain uses the root domain. Allowed values: hostPath, domain.`,schemaType:`string`,choices:[`hostPath`,`domain`],location:`body`},{name:`urlType`,optionKey:`urlType`,flag:`--url-type <url-type>`,required:!1,description:`Restrict URL matching to one URL type. Allowed values: website, linkedin, twitter, github, facebook, instagram, tiktok, youtube, subreddit, forum, documentation, support, statuspage, changelog, roadmap, discord, crunchbase, wellfound, angellist, glassdoor, theorg, ycombinator, wikipedia, pitchbook, morningstar, bloomberg, nyse, nasdaq, g2, producthunt, trustpilot, alternativeto, gartnerpeerinsights, getapp, sourceforge, appstore, googleplay, capterra, trustradius, hubspotmarketplace, slackappdirectory, awsmarketplace, salesforceappexchange, chromewebstore, vscodemarketplace, npm, pypi, maven, dockerhub, homebrew, crates, huggingface.`,schemaType:`string`,choices:`website.linkedin.twitter.github.facebook.instagram.tiktok.youtube.subreddit.forum.documentation.support.statuspage.changelog.roadmap.discord.crunchbase.wellfound.angellist.glassdoor.theorg.ycombinator.wikipedia.pitchbook.morningstar.bloomberg.nyse.nasdaq.g2.producthunt.trustpilot.alternativeto.gartnerpeerinsights.getapp.sourceforge.appstore.googleplay.capterra.trustradius.hubspotmarketplace.slackappdirectory.awsmarketplace.salesforceappexchange.chromewebstore.vscodemarketplace.npm.pypi.maven.dockerhub.homebrew.crates.huggingface`.split(`.`),location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],parameters:[]},{operationId:`searchEntityFilters`,method:`POST`,path:`/v1/entities/filters/search`,resource:`entities`,intent:`search`,cliPath:[`entities`,`filters`,`search`],summary:`Look up filter values inside the current search`,description:`Live search within the full eligible filter universe using current entity filters. Pass the same scopeFilter used for list/refine work; the searched filter excludes its own current values so callers can expand a facet without clearing the rest of the query.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/filter-search`,schemaName:`EntityFilterSearchSchema`,kind:`json`,contentType:`application/json`,description:`Record representing a filter search request`,required:!0,requiredPath:[`filterKey`,`limit`,`query`,`scopeFilter`],parameter:[{name:`scopeFilter.employeeCountRange[].min`,optionKey:`scopeFilterEmployeeCountRangeMin`,flag:`--scope-filter-employee-count-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`scopeFilter.fundraiseActivity.amountInvestedRange[].min`,optionKey:`scopeFilterFundraiseAmountInvestedRangeMin`,flag:`--scope-filter-fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.amountRaisedRange[].min`,optionKey:`scopeFilterFundraiseAmountRaisedRangeMin`,flag:`--scope-filter-fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].min`,optionKey:`scopeFilterFundraiseInvestorActivityAverageAmountInvestedUsdRangeMin`,flag:`--scope-filter-fundraise-investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].min`,optionKey:`scopeFilterFundraiseInvestorActivityLargestAmountInvestedUsdRangeMin`,flag:`--scope-filter-fundraise-investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].min`,optionKey:`scopeFilterFundraiseInvestorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--scope-filter-fundraise-investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].min`,optionKey:`scopeFilterFundraiseInvestorActivityTotalAmountInvestedUsdRangeMin`,flag:`--scope-filter-fundraise-investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.totalInvestmentRange[].min`,optionKey:`scopeFilterFundraiseInvestorActivityTotalInvestmentRangeMin`,flag:`--scope-filter-fundraise-investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`scopeFilter.fundraiseActivity.lastRoundYearRange[].min`,optionKey:`scopeFilterFundraiseLastRoundYearRangeMin`,flag:`--scope-filter-fundraise-last-round-year-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`scopeFilter.fundraiseActivity.totalRaisedRange[].min`,optionKey:`scopeFilterFundraiseTotalRaisedRangeMin`,flag:`--scope-filter-fundraise-total-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.valuationRange[].min`,optionKey:`scopeFilterFundraiseValuationRangeMin`,flag:`--scope-filter-fundraise-valuation-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.yearFoundedRange[].min`,optionKey:`scopeFilterYearFoundedRangeMin`,flag:`--scope-filter-year-founded-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`scopeFilter.employeeCountRange[].max`,optionKey:`scopeFilterEmployeeCountRangeMax`,flag:`--scope-filter-employee-count-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`scopeFilter.fundraiseActivity.amountInvestedRange[].max`,optionKey:`scopeFilterFundraiseAmountInvestedRangeMax`,flag:`--scope-filter-fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.amountRaisedRange[].max`,optionKey:`scopeFilterFundraiseAmountRaisedRangeMax`,flag:`--scope-filter-fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].max`,optionKey:`scopeFilterFundraiseInvestorActivityAverageAmountInvestedUsdRangeMax`,flag:`--scope-filter-fundraise-investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].max`,optionKey:`scopeFilterFundraiseInvestorActivityLargestAmountInvestedUsdRangeMax`,flag:`--scope-filter-fundraise-investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].max`,optionKey:`scopeFilterFundraiseInvestorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--scope-filter-fundraise-investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].max`,optionKey:`scopeFilterFundraiseInvestorActivityTotalAmountInvestedUsdRangeMax`,flag:`--scope-filter-fundraise-investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.totalInvestmentRange[].max`,optionKey:`scopeFilterFundraiseInvestorActivityTotalInvestmentRangeMax`,flag:`--scope-filter-fundraise-investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`scopeFilter.fundraiseActivity.lastRoundYearRange[].max`,optionKey:`scopeFilterFundraiseLastRoundYearRangeMax`,flag:`--scope-filter-fundraise-last-round-year-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`scopeFilter.fundraiseActivity.totalRaisedRange[].max`,optionKey:`scopeFilterFundraiseTotalRaisedRangeMax`,flag:`--scope-filter-fundraise-total-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.valuationRange[].max`,optionKey:`scopeFilterFundraiseValuationRangeMax`,flag:`--scope-filter-fundraise-valuation-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.yearFoundedRange[].max`,optionKey:`scopeFilterYearFoundedRangeMax`,flag:`--scope-filter-year-founded-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filterKey`,optionKey:`filterKey`,flag:`--filter-key <filter-key>`,required:!0,description:`Filter key.`,schemaType:`string`,location:`body`},{name:`limit`,optionKey:`limit`,flag:`--limit <integer>`,required:!0,description:`Maximum number of search results.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`query`,optionKey:`query`,flag:`--query <query>`,required:!0,description:`Query.`,schemaType:`string`,location:`body`},{name:`scopeFilter.acceleratorBrand`,optionKey:`scopeFilterAcceleratorBrand`,flag:`--scope-filter-accelerator-brand <scope-filter-accelerator-brand...>`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.acceleratorCohort`,optionKey:`scopeFilterAcceleratorCohort`,flag:`--scope-filter-accelerator-cohort <scope-filter-accelerator-cohort...>`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.acceleratorName`,optionKey:`scopeFilterAcceleratorName`,flag:`--scope-filter-accelerator-name <scope-filter-accelerator-name...>`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.acceleratorStatus`,optionKey:`scopeFilterAcceleratorStatus`,flag:`--scope-filter-accelerator-status <scope-filter-accelerator-status...>`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.affinity`,optionKey:`scopeFilterAffinity`,flag:`--scope-filter-affinity <scope-filter-affinity...>`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.entityId`,optionKey:`scopeFilterEntityId`,flag:`--scope-filter-entity-id <scope-filter-entity-id...>`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.entityName`,optionKey:`scopeFilterEntityName`,flag:`--scope-filter-entity-name <scope-filter-entity-name...>`,required:!1,description:`Exact normalized match against entity brand or legal names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.featured`,optionKey:`scopeFilterFeatured`,flag:`--scope-filter-featured <true|false>`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`,location:`body`},{name:`scopeFilter.fundraiseActivity.investedCompanyName`,optionKey:`scopeFilterFundraiseInvestedCompanyName`,flag:`--scope-filter-fundraise-invested-company-name <scope-filter-fundraise-invested-company-name...>`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.fundraiseActivity.round`,optionKey:`scopeFilterFundraiseRound`,flag:`--scope-filter-fundraise-round <scope-filter-fundraise-round...>`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.hasFundraising`,optionKey:`scopeFilterHasFundraising`,flag:`--scope-filter-has-fundraising <true|false>`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`,location:`body`},{name:`scopeFilter.headquartersCity`,optionKey:`scopeFilterHeadquartersCity`,flag:`--scope-filter-headquarters-city <scope-filter-headquarters-city...>`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.headquartersCountry`,optionKey:`scopeFilterHeadquartersCountry`,flag:`--scope-filter-headquarters-country <scope-filter-headquarters-country...>`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.headquartersState`,optionKey:`scopeFilterHeadquartersState`,flag:`--scope-filter-headquarters-state <scope-filter-headquarters-state...>`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.industry`,optionKey:`scopeFilterIndustry`,flag:`--scope-filter-industry <scope-filter-industry...>`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.letter`,optionKey:`scopeFilterLetter`,flag:`--scope-filter-letter <scope-filter-letter>`,required:!1,description:`First letter of the display name.`,schemaType:`string`,location:`body`},{name:`scopeFilter.location`,optionKey:`scopeFilterLocation`,flag:`--scope-filter-location <scope-filter-location...>`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.logoOption.sortPriority`,optionKey:`scopeFilterLogoSortPriority`,flag:`--scope-filter-logo-sort-priority <scope-filter-logo-sort-priority>`,required:!1,description:`Logo sort priority. Allowed values: NONE, ANY_LOGO_FIRST, REAL_LOGO_FIRST.`,schemaType:`string`,choices:[`NONE`,`ANY_LOGO_FIRST`,`REAL_LOGO_FIRST`],location:`body`},{name:`scopeFilter.mainProduct`,optionKey:`scopeFilterMainProduct`,flag:`--scope-filter-main-product <scope-filter-main-product...>`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.operatingStatus`,optionKey:`scopeFilterOperatingStatus`,flag:`--scope-filter-operating-status <scope-filter-operating-status...>`,required:!1,description:`Operating states to include; omit to include every state. Allowed values: Operating, Acquired, Acquired Subsidiary, Closed, Closed (Acquihire), Inactive.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`],location:`body`},{name:`scopeFilter.person`,optionKey:`scopeFilterPerson`,flag:`--scope-filter-person <scope-filter-person...>`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.portfolioHeadquartersCity`,optionKey:`scopeFilterPortfolioHeadquartersCity`,flag:`--scope-filter-portfolio-headquarters-city <scope-filter-portfolio-headquarters-city...>`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.portfolioHeadquartersCountry`,optionKey:`scopeFilterPortfolioHeadquartersCountry`,flag:`--scope-filter-portfolio-headquarters-country <scope-filter-portfolio-headquarters-country...>`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.portfolioHeadquartersState`,optionKey:`scopeFilterPortfolioHeadquartersState`,flag:`--scope-filter-portfolio-headquarters-state <scope-filter-portfolio-headquarters-state...>`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.qualityGate`,optionKey:`scopeFilterQualityGate`,flag:`--scope-filter-quality-gate <scope-filter-quality-gate>`,required:!1,description:`Named server-owned list quality gate. Allowed values: NONE, COMPANY_LISTING_READY.`,schemaType:`string`,choices:[`NONE`,`COMPANY_LISTING_READY`],location:`body`},{name:`scopeFilter.slug`,optionKey:`scopeFilterSlug`,flag:`--scope-filter-slug <scope-filter-slug...>`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.stage`,optionKey:`scopeFilterStage`,flag:`--scope-filter-stage <scope-filter-stage...>`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.suppressNonOperating`,optionKey:`scopeFilterSuppressNonOperating`,flag:`--scope-filter-suppress-non-operating <true|false>`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`,location:`body`},{name:`scopeFilter.suppressZeroTotalRaised`,optionKey:`scopeFilterSuppressZeroTotalRaised`,flag:`--scope-filter-suppress-zero-total-raised <true|false>`,required:!1,description:`Suppress entities whose total raised is zero.`,schemaType:`boolean`,location:`body`},{name:`scopeFilter.tag`,optionKey:`scopeFilterTag`,flag:`--scope-filter-tag <scope-filter-tag...>`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.textSearch`,optionKey:`scopeFilterTextSearch`,flag:`--scope-filter-text-search <scope-filter-text-search>`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`,location:`body`},{name:`scopeFilter.typeCustomer`,optionKey:`scopeFilterTypeCustomer`,flag:`--scope-filter-type-customer <scope-filter-type-customer...>`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.typeModel`,optionKey:`scopeFilterTypeModel`,flag:`--scope-filter-type-model <scope-filter-type-model...>`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.typeOwnership`,optionKey:`scopeFilterTypeOwnership`,flag:`--scope-filter-type-ownership <scope-filter-type-ownership...>`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.typeRecord`,optionKey:`scopeFilterTypeRecord`,flag:`--scope-filter-type-record <scope-filter-type-record...>`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`scopeFilter.typeRevenue`,optionKey:`scopeFilterTypeRevenue`,flag:`--scope-filter-type-revenue <scope-filter-type-revenue...>`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.typeTechnologyUsed`,optionKey:`scopeFilterTypeTechnologyUsed`,flag:`--scope-filter-type-technology-used <scope-filter-type-technology-used...>`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.url`,optionKey:`scopeFilterUrl`,flag:`--scope-filter-url <scope-filter-url>`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`,location:`body`},{name:`scopeFilter.urlDomain`,optionKey:`scopeFilterUrlDomain`,flag:`--scope-filter-url-domain <scope-filter-url-domain>`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`,location:`body`},{name:`scopeFilter.urlMatchMode`,optionKey:`scopeFilterUrlMatchMode`,flag:`--scope-filter-url-match-mode <scope-filter-url-match-mode>`,required:!1,description:`URL matching mode: hostPath uses host and path; domain uses the root domain. Allowed values: hostPath, domain.`,schemaType:`string`,choices:[`hostPath`,`domain`],location:`body`},{name:`scopeFilter.urlType`,optionKey:`scopeFilterUrlType`,flag:`--scope-filter-url-type <scope-filter-url-type>`,required:!1,description:`Restrict URL matching to one URL type. Allowed values: website, linkedin, twitter, github, facebook, instagram, tiktok, youtube, subreddit, forum, documentation, support, statuspage, changelog, roadmap, discord, crunchbase, wellfound, angellist, glassdoor, theorg, ycombinator, wikipedia, pitchbook, morningstar, bloomberg, nyse, nasdaq, g2, producthunt, trustpilot, alternativeto, gartnerpeerinsights, getapp, sourceforge, appstore, googleplay, capterra, trustradius, hubspotmarketplace, slackappdirectory, awsmarketplace, salesforceappexchange, chromewebstore, vscodemarketplace, npm, pypi, maven, dockerhub, homebrew, crates, huggingface.`,schemaType:`string`,choices:`website.linkedin.twitter.github.facebook.instagram.tiktok.youtube.subreddit.forum.documentation.support.statuspage.changelog.roadmap.discord.crunchbase.wellfound.angellist.glassdoor.theorg.ycombinator.wikipedia.pitchbook.morningstar.bloomberg.nyse.nasdaq.g2.producthunt.trustpilot.alternativeto.gartnerpeerinsights.getapp.sourceforge.appstore.googleplay.capterra.trustradius.hubspotmarketplace.slackappdirectory.awsmarketplace.salesforceappexchange.chromewebstore.vscodemarketplace.npm.pypi.maven.dockerhub.homebrew.crates.huggingface`.split(`.`),location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],parameters:[]},{operationId:`getEntityFundraiseInvestorJoin`,method:`GET`,path:`/v1/entities/{entityId}/fundraise-investor-joins/{joinId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise-investor-joins`,`get`],summary:`Get one investor on a funding round`,description:`Gets one entity or person investor join by join id.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`joinId`,optionKey:`fundraiseInvestorJoinId`,flag:`--fundraise-investor-join-id <uuid>`,required:!0,description:`Fundraise investor join identifier.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listEntityFundraiseInvestorJoins`,method:`GET`,path:`/v1/entities/{entityId}/fundraise-investor-joins`,resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise-investor-joins`,`list`],summary:`List the investors in a funding round`,description:`Lists entity or person investors joined to a fundraise round, including join-level amountInvested attribution. amountInvested is a plain decimal number in the fundraise transaction currency. Send a JSON number such as 220000 or 123456.78. Do not send currency signs, currency codes, comma grouping, quoted numeric strings, or abbreviations such as 220k or 0.22M. PATCH with amountInvested:null clears the value. Use entityId for the fundraising/portfolio company that raised the round — always a company, never the fund or investment firm that supplied the capital. For an Investment Firm's outgoing investment, pass the portfolio company that received the money here and identify the firm with investorEntityId or investorEntitySlug. Use transactionId for the round id, or round plus dateAnnounced when transactionId is unknown. Investor entity/person selectors reference existing records only. Create a referenced investor entity first with POST /v1/entities/detail or a referenced investor person first with POST /v1/people, then create the join.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`joinId`,optionKey:`fundraiseInvestorJoinId`,flag:`--fundraise-investor-join-id <uuid>`,required:!1,description:`Join identifier. When present, lookup ignores transaction and investor query parameters.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`transactionId`,optionKey:`transactionId`,flag:`--transaction-id <uuid>`,required:!1,description:`Fundraise round transaction id. The target entity id/slug is the entity that raised the round; for an Investment Firm investment, use the portfolio/fundraising company as target and identify the firm with investorEntityId or investorEntitySlug. When omitted, lookup uses the target entity plus round/dateAnnounced.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`round`,optionKey:`round`,flag:`--round <round>`,required:!1,description:`Raw fundraise round label used when transactionId is omitted.`,schemaType:`string`,location:`query`},{name:`dateAnnounced`,optionKey:`dateAnnounced`,flag:`--date-announced <date-time>`,required:!1,description:`Exact announced timestamp used to disambiguate same-label rounds.`,schemaType:`string`,schemaFormat:`date-time`,location:`query`},{name:`investorEntityId`,optionKey:`investorEntityId`,flag:`--investor-entity-id <uuid>`,required:!1,description:`Existing investor entity identifier. The entity must already exist; create a referenced investor entity first with POST /v1/entities/detail.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`investorEntitySlug`,optionKey:`investorEntitySlug`,flag:`--investor-entity-slug <investor-entity-slug>`,required:!1,description:`Existing investor entity slug when investorEntityId is omitted. The entity must already exist; create it first with POST /v1/entities/detail.`,schemaType:`string`,location:`query`},{name:`investorPersonId`,optionKey:`investorPersonId`,flag:`--investor-person-id <uuid>`,required:!1,description:`Existing investor person identifier. The person must already exist; create a referenced investor person first with POST /v1/people.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`investorPersonSlug`,optionKey:`investorPersonSlug`,flag:`--investor-person-slug <investor-person-slug>`,required:!1,description:`Existing investor person slug when investorPersonId is omitted. The person must already exist; create it first with POST /v1/people.`,schemaType:`string`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`25`,location:`query`}]},{operationId:`getEntityFundraiseRound`,method:`GET`,path:`/v1/entities/{entityId}/fundraise-rounds/{fundraiseRoundId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise-rounds`,`get`],summary:`Get one funding round`,description:`Gets one fundraise round for an entity. Use entityId for the fundraising/portfolio company that raised the round - always a company, never the fund or investment firm. For an investment made by an Investment Firm, pass the portfolio company that received the money here, not the investment firm id and not the round id. Use fundraiseRoundId for the round id.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`fundraiseRoundId`,optionKey:`fundraiseRoundId`,flag:`--fundraise-round-id <uuid>`,required:!0,description:`Fundraise round id. Use this with the entityId path segment that owns the round.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listEntityFundraiseRounds`,method:`GET`,path:`/v1/entities/{entityId}/fundraise-rounds`,resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise-rounds`,`list`],summary:`List a company's funding rounds`,description:`Lists fundraise rounds for an entity. Use entityId for the fundraising/portfolio company that raised the round - always a company, never the fund or investment firm. For an investment made by an Investment Firm, pass the portfolio company that received the money here, not the investment firm id and not the round id.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`round`,optionKey:`round`,flag:`--round <round>`,required:!1,description:`Round label contains filter.`,schemaType:`string`,location:`query`},{name:`dateFrom`,optionKey:`dateFrom`,flag:`--date-from <date>`,required:!1,description:`Inclusive minimum announced date.`,schemaType:`string`,schemaFormat:`date`,location:`query`},{name:`dateTo`,optionKey:`dateTo`,flag:`--date-to <date>`,required:!1,description:`Inclusive maximum announced date.`,schemaType:`string`,schemaFormat:`date`,location:`query`},{name:`minAmount`,optionKey:`minAmount`,flag:`--min-amount <integer>`,required:!1,description:`Inclusive minimum amount raised. Use a plain whole-number amount such as 500000; do not include currency signs, codes, comma grouping, decimals, or strings.`,schemaType:`integer`,schemaFormat:`int64`,location:`query`},{name:`maxAmount`,optionKey:`maxAmount`,flag:`--max-amount <integer>`,required:!1,description:`Inclusive maximum amount raised. Use a plain whole-number amount such as 50000000; do not include currency signs, codes, comma grouping, decimals, or strings.`,schemaType:`integer`,schemaFormat:`int64`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Permit monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort.`,schemaType:`string`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`listEntityInvestments`,method:`GET`,path:`/v1/entities/{entityId}/investments`,resource:`entities`,intent:`read`,cliPath:[`entities`,`investments`,`list`],summary:`List the investments a company made`,description:`Lists investments made by the requesting investor entity. Use entityId to select the investor, then filter by round, dateFrom/dateTo, minAmount/maxAmount, and latestPerEntity. amountInvested appears only inside investorAttribution, is a plain decimal number in the fundraise transaction currency, and is not added to amountRaised. Valid sort syntax is sort=amountInvested,desc; do not use investorAttribution.amountInvested, amount_invested, currency signs, currency codes, comma grouping, or abbreviated values. Deep traversal uses cursor: pass the prior X-Next-Cursor value as cursor and reuse the same filters and sort.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`round`,optionKey:`round`,flag:`--round <round>`,required:!1,description:`Round label contains filter.`,schemaType:`string`,location:`query`},{name:`dateFrom`,optionKey:`dateFrom`,flag:`--date-from <date>`,required:!1,description:`Inclusive minimum announced date.`,schemaType:`string`,schemaFormat:`date`,location:`query`},{name:`dateTo`,optionKey:`dateTo`,flag:`--date-to <date>`,required:!1,description:`Inclusive maximum announced date.`,schemaType:`string`,schemaFormat:`date`,location:`query`},{name:`minAmount`,optionKey:`minAmount`,flag:`--min-amount <integer>`,required:!1,description:`Inclusive minimum amount raised. Use a plain whole-number amount such as 500000; do not include currency signs, codes, comma grouping, decimals, or strings.`,schemaType:`integer`,schemaFormat:`int64`,location:`query`},{name:`maxAmount`,optionKey:`maxAmount`,flag:`--max-amount <integer>`,required:!1,description:`Inclusive maximum amount raised. Use a plain whole-number amount such as 50000000; do not include currency signs, codes, comma grouping, decimals, or strings.`,schemaType:`integer`,schemaFormat:`int64`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Permit monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`latestPerEntity`,optionKey:`latestPerEntity`,flag:`--latest-per-entity <true|false>`,required:!1,description:`Return latest transaction per entity.`,schemaType:`boolean`,location:`query`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort.`,schemaType:`string`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes private fundraise data when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getEntityInvestorActivity`,method:`GET`,path:`/v1/entities/{entityId}/investor-activity`,resource:`entities`,intent:`read`,cliPath:[`entities`,`investor-activity`,`get`],summary:`Get investor activity`,description:`Gets the investor-perspective activity aggregate (total investments, current portfolio count, exits, and top investment stages) for an investor. Use entityId for the investor — the fund, investment firm, or company that supplied the capital — not a portfolio company that raised a round.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listEntityInvestors`,method:`GET`,path:`/v1/entities/{entityId}/investors`,resource:`entities`,intent:`read`,cliPath:[`entities`,`investors`,`list`],summary:`List a company's investors`,description:`Lists entity investors with per-round investorAttribution rows. Use entityId for the fundraising/portfolio company being invested in, whose investors to list — always a company, never an investor fund or firm. amountInvested appears only inside investorAttribution, is a plain decimal number in the fundraise transaction currency, and is not added to amountRaised. Valid sort syntax is sort=amountInvested,desc; do not use investorAttribution.amountInvested, amount_invested, currency signs, currency codes, comma grouping, or abbreviated values.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Permit generated monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort.`,schemaType:`string`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes private fundraise data when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getEntityLookup`,method:`GET`,path:`/v1/entities/lookup-exact`,resource:`entities`,intent:`read`,cliPath:[`entities`,`lookup-exact`,`get`],summary:`Read full entity detail by exact slug, URL, or domain`,description:`Exact read: returns the full detail of the one entity a slug, URL, or domain proves, and 404 or 409 instead of guessing. To identify a company by name and clues, use the POST lookup (CLI entities lookup). Detail qualifiers and visibility rules apply. UUIDs use the item route; id query parameters are rejected. Changed slugs redirect canonically. A signed-in user's read charges one view per distinct returned record against the monthly entity or person view allowance; a repeat read of the same record in the month is free, and an exhausted cap answers 429 with Retry-After. Reads made without a signed-in user are never charged.`,scope:`read`,auth:`none`,errorResponse:[{status:`400`,description:`Conflicting or unusable identity input: name, nameBrand, and nameLegal must identify the same entity, and exactly one identifier form may be supplied.`},{status:`404`,description:`No entity resolved: fuzzy candidate signals below the review threshold without identity proof are exhausted, which does not prove the record is absent or safe to create — search POST /v1/entities/search with textSearch first (searchEntities). An existing but filtered row instead reports its reason as the ProblemDetail title: Entity Exists but Is Not Public (retry with includePrivate=true), Product Not Public: Missing Provider Relationship, or Fund Not Public: No Public Manager Firm.`},{status:`409`,description:`Ambiguous identity: review-level candidates, unresolved identity proof, multiple exact normalized-name matches, or a Product/Service slug shared across provider pairs. ProblemDetail carries candidates; read each returned id with GET /v1/entities/{entityId}. Resolve the Product/Service ambiguity with companySlug plus slug or a provider's productService relationship.`}],parameters:[{name:`slug`,optionKey:`entitySlug`,flag:`--entity-slug <entity-slug>`,required:!1,description:`Exact entity slug.`,schemaType:`string`,location:`query`},{name:`companySlug`,optionKey:`companySlug`,flag:`--company-slug <company-slug>`,required:!1,description:`Provider slug for Product/Service slug lookup; providerTypeRecord can narrow this to Company, Nonprofit, or Government routes.`,schemaType:`string`,location:`query`},{name:`providerTypeRecord`,optionKey:`providerTypeRecord`,flag:`--provider-type-record <provider-type-record>`,required:!1,description:"Concrete provider type qualifier for a Product/Service provider route; group-only Organization is invalid. Use with companySlug when resolving `/companies/{slug}/products-services/{product}`, `/non-profits/{slug}/products-services/{product}`, or `/government/{slug}/products-services/{product}`.",schemaType:`string`,location:`query`},{name:`url`,optionKey:`url`,flag:`--url <url>`,required:!1,description:`Entity URL matched by host and path unless urlMatchMode=domain.`,schemaType:`string`,location:`query`},{name:`urlType`,optionKey:`urlType`,flag:`--url-type <url-type>`,required:!1,description:`URL type qualifier. List the accepted tokens with GET /v1/url-types (CLI: url-types list).`,schemaType:`string`,location:`query`},{name:`urlMatchMode`,optionKey:`urlMatchMode`,flag:`--url-match-mode <url-match-mode>`,required:!1,description:`URL matching mode: hostPath (default for url) or domain. Omit when urlDomain is supplied; urlDomain selects domain mode automatically.`,schemaType:`string`,location:`query`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record>`,required:!1,description:`Concrete entity type qualifier; group-only Organization is invalid. List the accepted concrete tokens and their aliases with GET /v1/entities/types (CLI: entities types list).`,schemaType:`string`,location:`query`},{name:`name`,optionKey:`name`,flag:`--name <name>`,required:!1,description:`Primary entity name candidate.`,schemaType:`string`,location:`query`},{name:`nameBrand`,optionKey:`nameBrand`,flag:`--name-brand <name-brand>`,required:!1,description:`Brand name candidate.`,schemaType:`string`,location:`query`},{name:`nameLegal`,optionKey:`nameLegal`,flag:`--name-legal <name-legal>`,required:!1,description:`Legal name candidate.`,schemaType:`string`,location:`query`},{name:`location`,optionKey:`location`,flag:`--location <location>`,required:!1,description:`Location candidate: city, state, or country.`,schemaType:`string`,location:`query`},{name:`urlDomain`,optionKey:`urlDomain`,flag:`--url-domain <url-domain>`,required:!1,description:`Website domain candidate without protocol or path.`,schemaType:`string`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Allow generated monogram logo fallback.`,schemaType:`boolean`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes hidden or off-sitemap entities and hidden research snippets when the caller has private-visibility authority.`,schemaType:`boolean`,location:`query`}]},{operationId:`getEntityMedia`,method:`GET`,path:`/v1/entities/{entityId}/media/{mediaType}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`media`,`get`],summary:`Get a company media slot`,description:`Returns the selected square or standard entity logo. Empty slots return 404.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`mediaType`,optionKey:`mediaType`,flag:`--media-type <media-type>`,required:!0,description:`Media slot; entities serve logo. Allowed values: logo, photo, thumbnail.`,schemaType:`string`,choices:[`logo`,`photo`,`thumbnail`],location:`path`},{name:`logoType`,optionKey:`logoType`,flag:`--logo-type <logo-type>`,required:!1,description:`Entity logo variant; defaults to square. Allowed values: SQUARE, STANDARD.`,schemaType:`string`,choices:[`SQUARE`,`STANDARD`],location:`query`}]},{operationId:`getEntityPersonAssociation`,method:`GET`,path:`/v1/entities/{entityId}/people/{associationId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`people`,`get`],summary:`Get one person's role at a company`,description:`Returns one entity-scoped association detail. Public results hide associations to hidden entities; callers with private-visibility authority can include them.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`associationId`,optionKey:`associationId`,flag:`--association-id <integer>`,required:!0,description:`Association id.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`},{name:`search`,optionKey:`search`,flag:`--search <search>`,required:!1,description:`Search term filter.`,schemaType:`string`,location:`query`},{name:`role`,optionKey:`role`,flag:`--role <role>`,required:!1,description:`Match the complete titleName, ignoring case (for example, Co-Founder & CEO). Omit to include all titles; this does not filter titleFunction or titleLevel.`,schemaType:`string`,location:`query`},{name:`isCurrent`,optionKey:`isCurrent`,flag:`--is-current <true|false>`,required:!1,description:`Current association filter.`,schemaType:`boolean`,location:`query`},{name:`includeUrl`,optionKey:`includeUrl`,flag:`--include-url <true|false>`,required:!1,description:`Include person URL records.`,schemaType:`boolean`,location:`query`},{name:`includeAddress`,optionKey:`includeAddress`,flag:`--include-address <true|false>`,required:!1,description:`Include person address records.`,schemaType:`boolean`,location:`query`},{name:`personSlug`,optionKey:`personSlug`,flag:`--person-slug <person-slug>`,required:!1,description:`Person slug fallback for entity-keyed writes.`,schemaType:`string`,location:`query`},{name:`countOnly`,optionKey:`countOnly`,flag:`--count-only <true|false>`,required:!1,description:`Return count metadata without full content.`,schemaType:`boolean`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Permit generated monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes associations on hidden entities when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`,location:`query`}]},{operationId:`listEntityPersonAssociations`,method:`GET`,path:`/v1/entities/{entityId}/people`,resource:`entities`,intent:`read`,cliPath:[`entities`,`people`,`list`],summary:`List the people at a company`,description:`Returns people associated with one entity. Public results exclude hidden entities; callers with private-visibility authority can include them.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`search`,optionKey:`search`,flag:`--search <search>`,required:!1,description:`Search term filter.`,schemaType:`string`,location:`query`},{name:`role`,optionKey:`role`,flag:`--role <role>`,required:!1,description:`Match the complete titleName, ignoring case (for example, Co-Founder & CEO). Omit to include all titles; this does not filter titleFunction or titleLevel.`,schemaType:`string`,location:`query`},{name:`isCurrent`,optionKey:`isCurrent`,flag:`--is-current <true|false>`,required:!1,description:`Current association filter.`,schemaType:`boolean`,location:`query`},{name:`includeUrl`,optionKey:`includeUrl`,flag:`--include-url <true|false>`,required:!1,description:`Include person URL records.`,schemaType:`boolean`,location:`query`},{name:`includeAddress`,optionKey:`includeAddress`,flag:`--include-address <true|false>`,required:!1,description:`Include person address records.`,schemaType:`boolean`,location:`query`},{name:`personSlug`,optionKey:`personSlug`,flag:`--person-slug <person-slug>`,required:!1,description:`Person slug fallback for entity-keyed writes.`,schemaType:`string`,location:`query`},{name:`countOnly`,optionKey:`countOnly`,flag:`--count-only <true|false>`,required:!1,description:`Return count metadata without full content.`,schemaType:`boolean`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Permit generated monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes associations on hidden entities when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`listEntityPersonInvestors`,method:`GET`,path:`/v1/entities/{entityId}/person-investors`,resource:`entities`,intent:`read`,cliPath:[`entities`,`person-investors`,`list`],summary:`List person investors`,description:`Lists person investors with per-round investorAttribution rows. Use entityId for the fundraising/portfolio company being invested in, whose investors to list — always a company, never an investor fund or firm. amountInvested appears only inside investorAttribution, is a plain decimal number in the fundraise transaction currency, and is not added to amountRaised. Valid sort syntax is sort=amountInvested,desc; do not use investorAttribution.amountInvested, amount_invested, currency signs, currency codes, comma grouping, or abbreviated values.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Permit generated monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort.`,schemaType:`string`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes private fundraise data when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getEntityRelationship`,method:`GET`,path:`/v1/entities/relationships/{relationshipId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`relationships`,`get`],summary:`Get one relationship by id`,description:`Returns one relationship by row id, including historic and non-primary rows. The response includes isCurrent and isPrimary so hidden-row cause is explicit.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`relationshipId`,optionKey:`relationshipId`,flag:`--relationship-id <integer>`,required:!0,description:`Integer entity_relationship.id row id from EntityRelationship.id, not an entity UUID.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`}]},{operationId:`listEntityRelationships`,method:`GET`,path:`/v1/entities/{entityId}/relationships`,resource:`entities`,intent:`read`,cliPath:[`entities`,`relationships`,`list`],summary:`List a company's relationships`,description:`Returns relationship rows touching the path entity. Defaults to renderable-only rows where isCurrent=true and isPrimary=true. Set includeNonRenderable=true to surface historic and non-primary curation rows; returned rows include id, isCurrent, and isPrimary so hidden-row cause is explicit. Use entities relationships get to retrieve one row by id without an entity path.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`type`,optionKey:`type`,flag:`--type <type>`,required:!1,description:`Optional EntityRelationshipType filter, one of: acceleratorParticipant, acquirer, affinity, calculated, competingProductService, competitor, customer, fundManagerFirm, parent, productService, serviceProvider, similarCompany, spinOffFrom, successor. Use entities relationships types list for valid values.`,schemaType:`string`,location:`query`},{name:`includeNonRenderable`,optionKey:`includeNonRenderable`,flag:`--include-non-renderable <true|false>`,required:!1,description:`Include historic or non-primary rows. Default false returns only rows where isCurrent=true and isPrimary=true.`,schemaType:`boolean`,defaultValue:!1,location:`query`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort.`,schemaType:`string`,location:`query`},{name:`transitive`,optionKey:`transitive`,flag:`--transitive <true|false>`,required:!1,description:`When true, returns direct curated competitors with each competitor's provider comparison signals (sells-to, pricing, ownership, funding, website) nested under its productService row. Competition is not transitively closed: A-B plus B-C surfaces B from A, never C. Only supported for type=competingProductService; the result is capped, so cursor and includeNonRenderable are not accepted alongside transitive=true.`,schemaType:`boolean`,defaultValue:!1,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`}]},{operationId:`listEntityRepositories`,method:`GET`,path:`/v1/entities/{entityId}/repositories`,resource:`entities`,intent:`read`,cliPath:[`entities`,`repositories`,`list`],summary:`List a company's GitHub repositories`,description:`Returns the entity's synced GitHub repositories, paged. Default sort is stargazerCount desc, then name.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID owning the repositories.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`50`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getEntityResearch`,method:`GET`,path:`/v1/entities/{entityId}/research`,resource:`entities`,intent:`read`,cliPath:[`entities`,`research`,`get`],summary:`Get the research gathered about a company`,description:`Returns the consolidated research projection for an entity. Callers with private-visibility authority can include hidden research snippets and off-sitemap entities.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes hidden research snippets and off-sitemap entities when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`,location:`query`}]},{operationId:`getEntityResearchDetail`,method:`GET`,path:`/v1/entities/{entityId}/research-details/{detailId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`research-details`,`get`],summary:`Get research detail`,description:`Returns one research detail for an entity.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`detailId`,optionKey:`researchDetailId`,flag:`--research-detail-id <integer>`,required:!0,description:`Research detail id.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`}]},{operationId:`listEntityResearchDetails`,method:`GET`,path:`/v1/entities/{entityId}/research-details`,resource:`entities`,intent:`read`,cliPath:[`entities`,`research-details`,`list`],summary:`List research details`,description:`Returns paginated research details for an entity. Optionally filter by detail type. Rows for timeSeries=true types are history, not stale current state.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`25`,location:`query`},{name:`type`,optionKey:`type`,flag:`--type <type>`,required:!1,description:`Research detail type token. Run GET /v1/entities/research-details/types (CLI: entities research-details types list) for the token inventory and each token's value shape.`,schemaType:`string`,location:`query`}]},{operationId:`getEntityResearchSnippet`,method:`GET`,path:`/v1/entities/{entityId}/research-snippets/{snippetId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`research-snippets`,`get`],summary:`Get research snippet`,description:`Returns one research snippet for an entity. Public reads omit private provenance fields.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`snippetId`,optionKey:`snippetId`,flag:`--snippet-id <integer>`,required:!0,description:`Research snippet id.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`}]},{operationId:`listEntityResearchSnippets`,method:`GET`,path:`/v1/entities/{entityId}/research-snippets`,resource:`entities`,intent:`read`,cliPath:[`entities`,`research-snippets`,`list`],summary:`List research snippets`,description:`Returns paginated research snippets for one entity. Public reads omit hidden rows and private provenance fields; privileged private reads include hidden rows. Sorting is fixed by the server.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`25`,location:`query`}]},{operationId:`lookupSecCompany`,method:`GET`,path:`/v1/entities/sec`,resource:`entities`,intent:`lookup`,cliPath:[`entities`,`sec`,`lookup`],summary:`Get SEC EDGAR facts for a public company`,description:`Resolves a publicly traded US company by ticker (preferred) or company-name query. Returns the SEC EDGAR identity facts: legal name, former names, ticker, exchange, SIC industry, state of incorporation, headquarters, and whether it is an operating company. SEC supplies no brand name, website, or summary text — those stay enrichment-owned and are absent here. A 404 means the query matched no SEC registrant (e.g. a private company). Read live and never persisted.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`ticker`,optionKey:`ticker`,flag:`--ticker <ticker>`,required:!1,description:`Trading ticker symbol (preferred resolver).`,schemaType:`string`,location:`query`},{name:`name`,optionKey:`name`,flag:`--name <name>`,required:!1,description:`Company name query (used when no ticker is given).`,schemaType:`string`,location:`query`}]},{operationId:`listEntitySimilarEntities`,method:`GET`,path:`/v1/entities/{entityId}/similar`,resource:`entities`,intent:`read`,cliPath:[`entities`,`similar`,`list`],summary:`Get similar companies by id`,description:`Returns similar entities for the UUID at this address, ordered by similarity score. Rows include the entity and similarity provenance. Use relationshipType to filter stored relationships. Custom sorting is unsupported. Any signed-in user may call this on every plan. The list is free: it never counts against the monthly record-view allowance, which charges only a separate full-detail view of one record.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`relationshipType`,optionKey:`relationshipType`,flag:`--relationship-type <relationship-type>`,required:!1,description:`Filter by stored relationship type, one of: acceleratorParticipant, acquirer, affinity, calculated, competingProductService, competitor, customer, fundManagerFirm, parent, productService, serviceProvider, similarCompany, spinOffFrom, successor.`,schemaType:`string`,location:`query`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Optional entity typeRecord filter. Repeat to allow multiple entity types.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Permit monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`10`,location:`query`}]},{operationId:`getEntitySlug`,method:`GET`,path:`/v1/entities/{entityId}/slug`,resource:`entities`,intent:`read`,cliPath:[`entities`,`slug`,`get`],summary:`Get a company's slug`,description:`Returns the current slug, canonical path, and public URL. Any signed-in user may call this.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`getEntityText`,method:`GET`,path:`/v1/entities/{entityId}/texts/{textId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`texts`,`get`],summary:`Get one piece of company text`,description:`Returns one entity-owned text row by id. Requires read auth.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID owning the text row.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`textId`,optionKey:`textId`,flag:`--text-id <integer>`,required:!0,description:`Text row id.`,schemaType:`integer`,schemaFormat:`int64`,location:`path`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Include private text rows for callers with read access.`,schemaType:`boolean`,defaultValue:!1,location:`query`}]},{operationId:`listEntityTexts`,method:`GET`,path:`/v1/entities/{entityId}/texts`,resource:`entities`,intent:`read`,cliPath:[`entities`,`texts`,`list`],summary:`List a company's text`,description:`Returns paginated text rows owned by the entity. Inactive or private rows require read auth.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID owning the text rows.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`includeInactive`,optionKey:`includeInactive`,flag:`--include-inactive <true|false>`,required:!1,description:`Include inactive text rows.`,schemaType:`boolean`,defaultValue:!1,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Include private text rows for callers with read access.`,schemaType:`boolean`,defaultValue:!1,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`25`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`listEntityTrendingNews`,method:`GET`,path:`/v1/entities/{entityId}/trending-news`,resource:`entities`,intent:`read`,cliPath:[`entities`,`trending-news`,`list`],summary:`List trending news about a company`,description:`Returns trending news semantically related to the company named by the entity id path parameter.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`10`,location:`query`}]},{operationId:`listEntityTypeRecords`,method:`GET`,path:`/v1/entities/types`,resource:`entities`,intent:`read`,cliPath:[`entities`,`types`,`list`],summary:`List the accepted typeRecord values`,description:`Returns each accepted typeRecord value with its aliases, meaning, and public page path.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[]},{operationId:`getEntityUniqueId`,method:`GET`,path:`/v1/entities/{entityId}/unique-ids/{uniqueIdId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`unique-ids`,`get`],summary:`Get one company identifier`,description:`Returns one external identifier mapping after verifying it belongs to the path owner.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`uniqueIdId`,optionKey:`uniqueIdId`,flag:`--unique-id-id <integer>`,required:!0,description:`Unique-id row id.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`}]},{operationId:`listEntityUniqueIds`,method:`GET`,path:`/v1/entities/{entityId}/unique-ids`,resource:`entities`,intent:`read`,cliPath:[`entities`,`unique-ids`,`list`],summary:`List a company's identifiers`,description:`Returns paginated external identifier mappings for one owner. Sort by id, idType, identifier, createdAt, or updatedAt; default is updatedAt descending.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`50`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getEntityUrl`,method:`GET`,path:`/v1/entities/{entityId}/urls/{urlId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`urls`,`get`],summary:`Get one company URL`,description:`Returns one entity-owned URL row by id. Requires read auth.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID owning the URL row.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`urlId`,optionKey:`urlId`,flag:`--url-id <integer>`,required:!0,description:`URL link id.`,schemaType:`integer`,schemaFormat:`int64`,location:`path`}]},{operationId:`listEntityUrls`,method:`GET`,path:`/v1/entities/{entityId}/urls`,resource:`entities`,intent:`read`,cliPath:[`entities`,`urls`,`list`],summary:`List a company's URLs`,description:`Returns paged primary current URL rows owned by an entity. Set includeInactive=true as a signed-in user or with read credentials to include secondary active and inactive/historical rows.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID owning the URL rows.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`includeInactive`,optionKey:`includeInactive`,flag:`--include-inactive <true|false>`,required:!1,description:`Include secondary active and inactive/historical URL rows.`,schemaType:`boolean`,defaultValue:!1,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`25`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`listEntityValuations`,method:`GET`,path:`/v1/entities/{entityId}/valuations`,resource:`entities`,intent:`read`,cliPath:[`entities`,`valuations`,`list`],summary:`List a company's valuation over time`,description:`Returns newest-first, per-UTC-month valuation points composed from stated latestValuation research details plus fundraise-round valuations. Only researchDetail points have detailId and can be changed here; fundraiseRound points are read-only here. Custom sort is not supported.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`25`,location:`query`}]},{operationId:`getHarnessRun`,method:`GET`,path:`/v1/harness/runs/{runId}`,resource:`harness`,intent:`read`,cliPath:[`harness`,`runs`,`get`],summary:`Get one run`,description:`Returns one run with its resolved public entity and exact renderable profile URL when available. An admin API key or admin bearer credential addresses every run and receives the privileged projection; any other authenticated caller addresses only runs it owns.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`runId`,optionKey:`runId`,flag:`--run-id <uuid>`,required:!0,description:`Harness run id.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`getAgentInstruction`,method:`GET`,path:`/v1/help/instructions/{kind}/{name}`,resource:`help`,intent:`read`,cliPath:[`help`,`instructions`,`get`],summary:`Get one agent instruction document`,description:`Returns the current version and markdown content for one prompt, skill, or agent. Any signed-in user may call this.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`kind`,optionKey:`kind`,flag:`--kind <kind>`,required:!0,description:`Document kind: prompt, skill, or agent. Allowed values: PROMPT, SKILL, AGENT.`,schemaType:`string`,choices:[`PROMPT`,`SKILL`,`AGENT`],location:`path`},{name:`name`,optionKey:`name`,flag:`--name <name>`,required:!0,description:`Manifest name of the document.`,schemaType:`string`,location:`path`}]},{operationId:`createNewsFeedback`,method:`POST`,path:`/v1/news/feedback`,resource:`news`,intent:`write`,cliPath:[`news`,`feedback`,`create`],summary:`Submit news feedback`,description:`Records feedback on a news article.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/news/feedback`,schemaName:`NewsFeedbackSchema`,kind:`json`,contentType:`application/json`,description:`Feedback submission for a news article`,required:!0,requiredPath:[],parameter:[{name:`comment`,optionKey:`comment`,flag:`--comment <comment>`,required:!1,description:`Free-form feedback text.`,schemaType:`string`,location:`body`},{name:`newsId`,optionKey:`newsId`,flag:`--news-id <integer>`,required:!1,description:`News article ID.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`reaction`,optionKey:`reaction`,flag:`--reaction <reaction>`,required:!1,description:`Short reaction (like, dislike, etc.).`,schemaType:`string`,location:`body`},{name:`slug`,optionKey:`slug`,flag:`--slug <slug>`,required:!1,description:`News article slug.`,schemaType:`string`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[],parameters:[]},{operationId:`getNewsMedia`,method:`GET`,path:`/v1/news/{newsId}/media/{mediaType}`,resource:`news`,intent:`read`,cliPath:[`news`,`media`,`get`],summary:`Get news thumbnail`,description:`Returns the article's attached thumbnail. Empty slots return 404.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`newsId`,optionKey:`newsId`,flag:`--news-id <integer>`,required:!0,description:`Exact positive news article id.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`},{name:`mediaType`,optionKey:`mediaType`,flag:`--media-type <media-type>`,required:!0,description:`Media slot; news articles serve thumbnail. Allowed values: logo, photo, thumbnail.`,schemaType:`string`,choices:[`logo`,`photo`,`thumbnail`],location:`path`}]},{operationId:`listNewsRelatedEntities`,method:`GET`,path:`/v1/news/{newsId}/related-entities`,resource:`news`,intent:`read`,cliPath:[`news`,`related-entities`,`list`],summary:`List the entities a news article is about`,description:`Returns entities semantically related to a news article.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`newsId`,optionKey:`newsId`,flag:`--news-id <integer>`,required:!0,description:`News article id whose semantic neighbors should be returned.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`10`,location:`query`}]},{operationId:`getPersonAddress`,method:`GET`,path:`/v1/people/{personId}/addresses/{addressJoinId}`,resource:`people`,intent:`read`,cliPath:[`people`,`addresses`,`get`],summary:`Get one person's address`,description:`Returns the physical address group containing the selected person association.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Canonical person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`addressJoinId`,optionKey:`addressJoinId`,flag:`--address-join-id <integer>`,required:!0,description:`Integer person-address association id.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`}]},{operationId:`listPersonAddresses`,method:`GET`,path:`/v1/people/{personId}/addresses`,resource:`people`,intent:`read`,cliPath:[`people`,`addresses`,`list`],summary:`List a person's addresses`,description:`Returns physical addresses with all role-period associations for one person.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Canonical person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`getPersonBlogPost`,method:`GET`,path:`/v1/people/{personId}/blog-posts/{blogPostId}`,resource:`people`,intent:`read`,cliPath:[`people`,`blog-posts`,`get`],summary:`Get one person blog post`,description:`Returns one person-owned external link by id. Any signed-in user may call this.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID owning the blog post row.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`blogPostId`,optionKey:`blogPostId`,flag:`--blog-post-id <uuid>`,required:!0,description:`Blog post UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listPersonBlogPosts`,method:`GET`,path:`/v1/people/{personId}/blog-posts`,resource:`people`,intent:`read`,cliPath:[`people`,`blog-posts`,`list`],summary:`List a person's blog posts`,description:`Returns active external blog post links stored in research.res_blog_article.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID owning the blog post rows.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`includeInactive`,optionKey:`includeInactive`,flag:`--include-inactive <true|false>`,required:!1,description:`Include inactive research blog post rows.`,schemaType:`boolean`,defaultValue:!1,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`10`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,defaultValue:[`publishedAt,desc`],location:`query`}]},{operationId:`listPersonContent`,method:`GET`,path:`/v1/people/{personId}/content`,resource:`people`,intent:`read`,cliPath:[`people`,`content`,`list`],summary:`List a person's publications`,description:`Returns news articles, blog posts, repositories, websites, and pages related to a person. Any signed-in user may call this.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID whose publications are listed.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`topic`,optionKey:`topic`,flag:`--topic <topic>`,required:!1,description:`Topic key or source category.`,schemaType:`string`,location:`query`},{name:`contentType`,optionKey:`contentType`,flag:`--content-type <content-type>`,required:!1,description:`Public content type filter. Allowed values: newsArticle, blogPost, externalSocialPost, repositoryOwner, repository, webSite, webPage, researchPaper.`,schemaType:`string`,choices:[`newsArticle`,`blogPost`,`externalSocialPost`,`repositoryOwner`,`repository`,`webSite`,`webPage`,`researchPaper`],location:`query`},{name:`relation`,optionKey:`relation`,flag:`--relation <relation>`,required:!1,description:`Owner relation filter. Allowed values: by, about.`,schemaType:`string`,choices:[`by`,`about`],location:`query`},{name:`year`,optionKey:`year`,flag:`--year <integer>`,required:!1,description:`Best-effort content year filter.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`existenceProbe`,optionKey:`existenceProbe`,flag:`--existence-probe <true|false>`,required:!1,description:`Set true for first-page content-existence probes that do not need exact totals or stable ordering.`,schemaType:`boolean`,defaultValue:!1,location:`query`}]},{operationId:`searchPersonContent`,method:`POST`,path:`/v1/people/{personId}/content/search`,resource:`people`,intent:`search`,cliPath:[`people`,`content`,`search`],summary:`Search a person's publications`,description:`Translates plain-English constraints for one person's content index. Any signed-in user may call this.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/natural/search`,schemaName:`NaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English search request. The server plans the query into the target domain filter plus sort, then runs that domain's canonical list engine.`,required:!0,requiredPath:[`query`],parameter:[{name:`mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value; news and federated search accept only `auto` and `keyword`; content search accepts only `auto`. Allowed values: auto, exact, keyword, semantic, natural.",schemaType:`string`,defaultValue:`auto`,choices:[`auto`,`exact`,`keyword`,`semantic`,`natural`],location:`body`},{name:`model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Optional chat model for planning; null uses the configured natural-search default. A caller without admin authority may only choose an allowlisted model; admin callers are unrestricted.`,schemaType:`string`,location:`body`},{name:`query`,optionKey:`query`,flag:`--query <query>`,required:!0,description:`Plain-English search request.`,schemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID whose publications are searched.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`enrichPerson`,method:`POST`,path:`/v1/people/{personId}/enrichments`,resource:`people`,intent:`write`,cliPath:[`people`,`enrichments`,`enrich`],summary:`Enrich one person`,description:"Queues a run that researches the addressed person and updates their aVenture profile, owned by the authenticated caller. Take personId from match.owner when POST /v1/lookup or POST /v1/people/lookup returns MATCHED (CLI: lookup, people lookup). When a run for this person is already queued or running, returns that run instead of queuing and charging another; a new run spends one `person` research unit from the plan's research allowance. After the run completes, read the updated profile with GET /v1/people/{personId} (CLI: people get). Check the run's progress with GET /v1/harness/runs/{runId} (CLI: harness runs get).",scope:`write`,auth:`bearer`,errorResponse:[{status:`402`,description:`The authenticated caller's subscription tier does not include research runs.`}],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Canonical person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:`COMPREHENSIVE (the default) researches the whole profile; INDIVIDUAL runs only the tasks named in taskPresetKey. Allowed values: COMPREHENSIVE, INDIVIDUAL.`,schemaType:`string`,choices:[`COMPREHENSIVE`,`INDIVIDUAL`],location:`query`},{name:`model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Model id for the run's lead agent; omit to use aVenture's default model.`,schemaType:`string`,location:`query`},{name:`userPrompt`,optionKey:`userPrompt`,flag:`--user-prompt <user-prompt>`,required:!1,description:`Plain-language instruction for this run, such as which facts or sources to check first.`,schemaType:`string`,location:`query`},{name:`taskPresetKey`,optionKey:`taskPresetKey`,flag:`--task-preset-key <task-preset-key...>`,required:!1,description:`Task preset keys that scope or emphasize this run; at least one is required when mode is INDIVIDUAL, and an unknown key is a 400.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getPersonEntityAssociation`,method:`GET`,path:`/v1/people/{personId}/entities/{associationId}`,resource:`people`,intent:`read`,cliPath:[`people`,`entities`,`get`],summary:`Get one of a person's roles at a company`,description:`Returns one person-scoped association join row.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`associationId`,optionKey:`associationId`,flag:`--association-id <integer>`,required:!0,description:`Association id.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`},{name:`includeUrl`,optionKey:`includeUrl`,flag:`--include-url <true|false>`,required:!1,description:`Include entity URL records.`,schemaType:`boolean`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Permit generated monogram logo fallback.`,schemaType:`boolean`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes hidden people and entity associations when the caller has private-visibility authority.`,schemaType:`boolean`,defaultValue:!1,location:`query`}]},{operationId:`listPersonEntityAssociations`,method:`GET`,path:`/v1/people/{personId}/entities`,resource:`people`,intent:`read`,cliPath:[`people`,`entities`,`list`],summary:`List a person's roles at companies`,description:`Returns entity associations for one person.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`countOnly`,optionKey:`countOnly`,flag:`--count-only <true|false>`,required:!1,description:`Return count metadata without full content.`,schemaType:`boolean`,location:`query`},{name:`includeUrl`,optionKey:`includeUrl`,flag:`--include-url <true|false>`,required:!1,description:`Include entity URL records.`,schemaType:`boolean`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Permit generated monogram logo fallback.`,schemaType:`boolean`,location:`query`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Opaque URL-safe cursor token from X-Next-Cursor.`,schemaType:`string`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes hidden people and entity associations when the caller has private-visibility authority.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`listPersonFilters`,method:`GET`,path:`/v1/people/filters`,resource:`people`,intent:`read`,cliPath:[`people`,`filters`,`list`],summary:`List person filter options`,description:`Returns available people filter facets.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[]},{operationId:`searchPersonFilters`,method:`GET`,path:`/v1/people/filters/search`,resource:`people`,intent:`search`,cliPath:[`people`,`filters`,`search`],summary:`Search people filter options`,description:`Searches available people filter options.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`filterKey`,optionKey:`filterKey`,flag:`--filter-key <filter-key>`,required:!0,description:`Filter key to search within.`,schemaType:`string`,location:`query`},{name:`search`,optionKey:`search`,flag:`--search <search>`,required:!0,description:`Search keyword or phrase. Single characters valid; stop words rejected.`,schemaType:`string`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Page index is fixed to 0 for filter search.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned; filter-search default 20, maximum 100.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`}]},{operationId:`getPersonGraph`,method:`GET`,path:`/v1/people/{personId}/graph`,resource:`people`,intent:`read`,cliPath:[`people`,`graph`,`get`],summary:`Get person graph`,description:`Returns the precomputed person-graph document: career context per associated entity (entity facts, recent news, colleagues, similar entities with key people) and co-investors. Lists are capped and pre-ranked; the response is the display order. Hidden people and entities are excluded at materialization. When no document has been materialized yet, returns empty lists with computedAt=null and schedules an asynchronous recompute.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Canonical person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listPersonInvestments`,method:`GET`,path:`/v1/people/{personId}/investments`,resource:`people`,intent:`read`,cliPath:[`people`,`investments`,`list`],summary:`List a person's investments`,description:`Returns a paginated investment portfolio for a person with investorAttribution. amountInvested appears only inside investorAttribution, is a plain decimal number in the fundraise transaction currency, and is not added to amount. Valid sort syntax is sort=amountInvested,desc; do not use investorAttribution.amountInvested, amount_invested, currency signs, currency codes, comma grouping, or abbreviated values.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Permit monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`50`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getPersonInvestorActivity`,method:`GET`,path:`/v1/people/{personId}/investor-activity`,resource:`people`,intent:`read`,cliPath:[`people`,`investor-activity`,`get`],summary:`Get person investor activity`,description:`Gets the investor-perspective activity aggregate (total investments, distinct portfolio companies, current portfolio count, exits, USD-attributed money totals, and top investment stages) for a person investor by personId. personId identifies the individual who supplied the capital — an angel or individual investor, not the company that raised the round.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`getPersonLookup`,method:`GET`,path:`/v1/people/lookup-exact`,resource:`people`,intent:`read`,cliPath:[`people`,`lookup-exact`,`get`],summary:`Read one person's full detail by exact slug or URL`,description:`Exact read: returns the full detail of the one person a slug, URL, or candidate signals prove, and 404 or 409 instead of guessing. To identify a person by name and clues, use the POST lookup (CLI people lookup). Use the UUID item route for an id; any id query is rejected. Canonical redirects are preserved. A signed-in user's read charges one view per distinct returned record against the monthly entity or person view allowance; a repeat read of the same record in the month is free, and an exhausted cap answers 429 with Retry-After. Reads made without a signed-in user are never charged.`,scope:`read`,auth:`none`,errorResponse:[{status:`404`,description:`No person resolved: exact URL and bounded candidate signals are exhausted, which does not prove the record is absent — search before creating. An existing but filtered row instead reports its reason as the ProblemDetail title: Person Exists but Is Not Public (retry with includePrivate=true).`},{status:`409`,description:`Ambiguous identity: a strict-URL match or candidate set still at the review threshold resolves to more than one person. ProblemDetail carries details.candidate; review those ids, update the matching candidate, and create only when all candidates are distinct and source evidence supports the target. score and threshold are review ranking, not absence proof. Resolve directly by personId.`}],parameters:[{name:`slug`,optionKey:`personSlug`,flag:`--person-slug <person-slug>`,required:!1,description:`Group A — exact person slug (URL-friendly identifier). Mutually exclusive with id, url, and every candidate signal in group C.`,schemaType:`string`,location:`query`},{name:`url`,optionKey:`url`,flag:`--url <url>`,required:!1,description:`Group B — current person URL to resolve via strict host+path or domain-only match. Mutually exclusive with id and slug; may be combined with group-C candidate signals for URL-first fallback.`,schemaType:`string`,location:`query`},{name:`urlType`,optionKey:`urlType`,flag:`--url-type <url-type>`,required:!1,description:`Optional URL type qualifier for URL lookup (e.g., 'linkedin', 'twitter'). Narrows Group B (url) and Group C (urlDomain) matching. Not an identifier on its own.`,schemaType:`string`,location:`query`},{name:`urlMatchMode`,optionKey:`urlMatchMode`,flag:`--url-match-mode <url-match-mode>`,required:!1,description:`URL match mode qualifier: 'hostPath' (strict host + path match, default) or 'domain' (host-only match). Not an identifier on its own.`,schemaType:`string`,location:`query`},{name:`nameFull`,optionKey:`nameFull`,flag:`--name-full <name-full>`,required:!1,description:`Group C — candidate lookup signal: person full name. Combine with other group-C signals (nameAny, location, urlDomain) for bounded candidate search. Mutually exclusive with id and slug; may be combined with url for fallback.`,schemaType:`string`,location:`query`},{name:`nameAny`,optionKey:`nameAny`,flag:`--name-any <name-any>`,required:!1,description:`Group C — candidate lookup signal: loose name match (any of given/family/full). Combine with other group-C signals for disambiguation. Mutually exclusive with id and slug; may be combined with url for fallback.`,schemaType:`string`,location:`query`},{name:`location`,optionKey:`location`,flag:`--location <location>`,required:!1,description:`Group C — candidate lookup signal: person location (city, state, country). Combine with other group-C signals for bounded search. Mutually exclusive with id and slug; may be combined with url for fallback.`,schemaType:`string`,location:`query`},{name:`urlDomain`,optionKey:`urlDomain`,flag:`--url-domain <url-domain>`,required:!1,description:`Group C — candidate lookup signal: person URL domain (host only, no path). Combine with other group-C signals for disambiguation. Mutually exclusive with id and slug; may be combined with url for fallback.`,schemaType:`string`,location:`query`},{name:`includeUrl`,optionKey:`includeUrl`,flag:`--include-url <true|false>`,required:!1,description:`Projection qualifier — include URL link values in response (default: true). Set false to omit urlLink array.`,schemaType:`boolean`,location:`query`},{name:`includeAssociation`,optionKey:`includeAssociation`,flag:`--include-association <true|false>`,required:!1,description:`Projection qualifier — include association values (default: true). Set false to omit association array.`,schemaType:`boolean`,location:`query`},{name:`includeAddress`,optionKey:`includeAddress`,flag:`--include-address <true|false>`,required:!1,description:`Projection qualifier — include address values (default: true). Set false to omit address array.`,schemaType:`boolean`,location:`query`},{name:`maxAssociations`,optionKey:`maxAssociations`,flag:`--max-associations <integer>`,required:!1,description:`Projection qualifier — max association values to return; bounded internally to the association limit. Default: 40.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Permit generated monogram photo fallback (default: true). Set false to exclude monogram photos in response.`,schemaType:`boolean`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes hidden or off-sitemap people and private fields when the caller has private-visibility authority.`,schemaType:`boolean`,location:`query`}]},{operationId:`getPersonMedia`,method:`GET`,path:`/v1/people/{personId}/media/{mediaType}`,resource:`people`,intent:`read`,cliPath:[`people`,`media`,`get`],summary:`Get person photo`,description:`Returns the person's attached photo. Empty slots return 404.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Canonical person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`mediaType`,optionKey:`mediaType`,flag:`--media-type <media-type>`,required:!0,description:`Media slot; people serve photo. Allowed values: logo, photo, thumbnail.`,schemaType:`string`,choices:[`logo`,`photo`,`thumbnail`],location:`path`}]},{operationId:`listPersonRepositories`,method:`GET`,path:`/v1/people/{personId}/repositories`,resource:`people`,intent:`read`,cliPath:[`people`,`repositories`,`list`],summary:`List a person's GitHub repositories`,description:`Returns the person's synced GitHub repositories, paged. Default sort is stargazerCount desc, then name.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID owning the repositories.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`50`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`listPersonSimilarPeople`,method:`GET`,path:`/v1/people/{personId}/similar`,resource:`people`,intent:`read`,cliPath:[`people`,`similar`,`list`],summary:`List people similar to one person`,description:`Returns people similar to the person at this address. Rows carry the person shape and per-row similarity provenance; load full detail through the person read endpoint. Results are ordered by similarity score (highest first). This endpoint does not support custom sorting. Any signed-in user may call this on every plan. The list is free: it never counts against the monthly record-view allowance, which charges only a separate full-detail view of one record.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Permit monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`X-Request-Origin`,optionKey:`xRequestOrigin`,flag:`--x-request-origin <x-request-origin>`,required:!1,description:`Attribution token identifying the requesting surface; metrics-only.`,schemaType:`string`,location:`header`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`10`,location:`query`}]},{operationId:`getPersonText`,method:`GET`,path:`/v1/people/{personId}/texts/{textId}`,resource:`people`,intent:`read`,cliPath:[`people`,`texts`,`get`],summary:`Get one piece of text about a person`,description:`Returns one person-owned text row by id. Requires read auth.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID owning the text row.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`textId`,optionKey:`textId`,flag:`--text-id <integer>`,required:!0,description:`Text row id.`,schemaType:`integer`,schemaFormat:`int64`,location:`path`}]},{operationId:`listPersonTexts`,method:`GET`,path:`/v1/people/{personId}/texts`,resource:`people`,intent:`read`,cliPath:[`people`,`texts`,`list`],summary:`List text about a person`,description:`Returns paginated text rows owned by the person. Inactive rows require read auth.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID owning the text rows.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`includeInactive`,optionKey:`includeInactive`,flag:`--include-inactive <true|false>`,required:!1,description:`Include inactive text rows.`,schemaType:`boolean`,defaultValue:!1,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`25`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getPersonUniqueId`,method:`GET`,path:`/v1/people/{personId}/unique-ids/{uniqueIdId}`,resource:`people`,intent:`read`,cliPath:[`people`,`unique-ids`,`get`],summary:`Get one person identifier`,description:`Returns one external identifier mapping after verifying it belongs to the path owner.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Canonical person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`uniqueIdId`,optionKey:`uniqueIdId`,flag:`--unique-id-id <integer>`,required:!0,description:`Unique-id row id.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`}]},{operationId:`listPersonUniqueIds`,method:`GET`,path:`/v1/people/{personId}/unique-ids`,resource:`people`,intent:`read`,cliPath:[`people`,`unique-ids`,`list`],summary:`List a person's identifiers`,description:`Returns paginated external identifier mappings for one owner. Sort by id, idType, identifier, createdAt, or updatedAt; default is updatedAt descending.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Canonical person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`50`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getPersonUrl`,method:`GET`,path:`/v1/people/{personId}/urls/{urlId}`,resource:`people`,intent:`read`,cliPath:[`people`,`urls`,`get`],summary:`Get one person URL`,description:`Returns one person-owned URL row by id. Requires read auth.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID owning the URL row.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`urlId`,optionKey:`urlId`,flag:`--url-id <integer>`,required:!0,description:`URL link id.`,schemaType:`integer`,schemaFormat:`int64`,location:`path`}]},{operationId:`listPersonUrls`,method:`GET`,path:`/v1/people/{personId}/urls`,resource:`people`,intent:`read`,cliPath:[`people`,`urls`,`list`],summary:`List person URLs`,description:`Returns paged primary current URL rows owned by a person. Set includeInactive=true as a signed-in user or with read credentials to include secondary active and inactive/historical rows.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID owning the URL rows.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`includeInactive`,optionKey:`includeInactive`,flag:`--include-inactive <true|false>`,required:!1,description:`Include secondary active and inactive/historical URL rows.`,schemaType:`boolean`,defaultValue:!1,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`25`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`searchNaturalEntities`,method:`POST`,path:`/v1/search/natural/entities`,resource:`search`,intent:`search`,cliPath:[`search`,`natural`,`entities`],summary:`Find companies, startups, and investors in natural language`,description:`Translate a plain-English company, startup, investor, investment firm, or investment manager search into the canonical EntityFilter contract, execute the existing entity list engine, and return both the interpretation and ranked entity list page. Unsupported constraints are named in the interpretation instead of being silently ignored. Explicit filter fields are hard constraints: they override planner values, while the planner fills fields left unset. Example: search.query 'AI infrastructure companies founded since 2020' with size=3. The query accepts plain English; size limits the page, page starts at 0, and filter.yearFoundedRange [{"min":2020}] imposes a hard founding-year constraint. Set includePrivate=false for publicly visible results.`,explain:!0,requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/natural-search`,schemaName:`EntityNaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English entity search plus explicit hard constraints. The planner may fill only filter fields the caller leaves unset.`,required:!0,requiredPath:[`search`,`search.query`],parameter:[{name:`filter.employeeCountRange[].min`,optionKey:`employeeCountRangeMin`,flag:`--employee-count-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.fundraiseActivity.amountInvestedRange[].min`,optionKey:`fundraiseAmountInvestedRangeMin`,flag:`--fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.amountRaisedRange[].min`,optionKey:`fundraiseAmountRaisedRangeMin`,flag:`--fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityAverageAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityLargestAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityTotalAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.totalInvestmentRange[].min`,optionKey:`fundraiseInvestorActivityTotalInvestmentRangeMin`,flag:`--fundraise-investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.fundraiseActivity.lastRoundYearRange[].min`,optionKey:`fundraiseLastRoundYearRangeMin`,flag:`--fundraise-last-round-year-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.fundraiseActivity.totalRaisedRange[].min`,optionKey:`fundraiseTotalRaisedRangeMin`,flag:`--fundraise-total-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.valuationRange[].min`,optionKey:`fundraiseValuationRangeMin`,flag:`--fundraise-valuation-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.yearFoundedRange[].min`,optionKey:`yearFoundedRangeMin`,flag:`--year-founded-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.employeeCountRange[].max`,optionKey:`employeeCountRangeMax`,flag:`--employee-count-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.fundraiseActivity.amountInvestedRange[].max`,optionKey:`fundraiseAmountInvestedRangeMax`,flag:`--fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.amountRaisedRange[].max`,optionKey:`fundraiseAmountRaisedRangeMax`,flag:`--fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityAverageAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityLargestAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityTotalAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.totalInvestmentRange[].max`,optionKey:`fundraiseInvestorActivityTotalInvestmentRangeMax`,flag:`--fundraise-investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.fundraiseActivity.lastRoundYearRange[].max`,optionKey:`fundraiseLastRoundYearRangeMax`,flag:`--fundraise-last-round-year-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.fundraiseActivity.totalRaisedRange[].max`,optionKey:`fundraiseTotalRaisedRangeMax`,flag:`--fundraise-total-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.valuationRange[].max`,optionKey:`fundraiseValuationRangeMax`,flag:`--fundraise-valuation-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.yearFoundedRange[].max`,optionKey:`yearFoundedRangeMax`,flag:`--year-founded-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.acceleratorBrand`,optionKey:`acceleratorBrand`,flag:`--accelerator-brand <accelerator-brand...>`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.acceleratorCohort`,optionKey:`acceleratorCohort`,flag:`--accelerator-cohort <accelerator-cohort...>`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.acceleratorName`,optionKey:`acceleratorName`,flag:`--accelerator-name <accelerator-name...>`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.acceleratorStatus`,optionKey:`acceleratorStatus`,flag:`--accelerator-status <accelerator-status...>`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.affinity`,optionKey:`affinity`,flag:`--affinity <affinity...>`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityId`,optionKey:`entityId`,flag:`--entity-id <entity-id...>`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityName`,optionKey:`entityName`,flag:`--entity-name <entity-name...>`,required:!1,description:`Exact normalized match against entity brand or legal names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.featured`,optionKey:`featured`,flag:`--featured <true|false>`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`,location:`body`},{name:`filter.fundraiseActivity.investedCompanyName`,optionKey:`fundraiseInvestedCompanyName`,flag:`--fundraise-invested-company-name <fundraise-invested-company-name...>`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.fundraiseActivity.round`,optionKey:`fundraiseRound`,flag:`--fundraise-round <fundraise-round...>`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.hasFundraising`,optionKey:`hasFundraising`,flag:`--has-fundraising <true|false>`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`,location:`body`},{name:`filter.headquartersCity`,optionKey:`headquartersCity`,flag:`--headquarters-city <headquarters-city...>`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.headquartersCountry`,optionKey:`headquartersCountry`,flag:`--headquarters-country <headquarters-country...>`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.headquartersState`,optionKey:`headquartersState`,flag:`--headquarters-state <headquarters-state...>`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.industry`,optionKey:`industry`,flag:`--industry <industry...>`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.letter`,optionKey:`letter`,flag:`--letter <letter>`,required:!1,description:`First letter of the display name.`,schemaType:`string`,location:`body`},{name:`filter.location`,optionKey:`location`,flag:`--location <location...>`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.logoOption.sortPriority`,optionKey:`logoSortPriority`,flag:`--logo-sort-priority <logo-sort-priority>`,required:!1,description:`Logo sort priority. Allowed values: NONE, ANY_LOGO_FIRST, REAL_LOGO_FIRST.`,schemaType:`string`,choices:[`NONE`,`ANY_LOGO_FIRST`,`REAL_LOGO_FIRST`],location:`body`},{name:`filter.mainProduct`,optionKey:`mainProduct`,flag:`--main-product <main-product...>`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.operatingStatus`,optionKey:`operatingStatus`,flag:`--operating-status <operating-status...>`,required:!1,description:`Operating states to include; omit to include every state. Allowed values: Operating, Acquired, Acquired Subsidiary, Closed, Closed (Acquihire), Inactive.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`],location:`body`},{name:`filter.person`,optionKey:`person`,flag:`--person <person...>`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.portfolioHeadquartersCity`,optionKey:`portfolioHeadquartersCity`,flag:`--portfolio-headquarters-city <portfolio-headquarters-city...>`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.portfolioHeadquartersCountry`,optionKey:`portfolioHeadquartersCountry`,flag:`--portfolio-headquarters-country <portfolio-headquarters-country...>`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.portfolioHeadquartersState`,optionKey:`portfolioHeadquartersState`,flag:`--portfolio-headquarters-state <portfolio-headquarters-state...>`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.qualityGate`,optionKey:`qualityGate`,flag:`--quality-gate <quality-gate>`,required:!1,description:`Named server-owned list quality gate. Allowed values: NONE, COMPANY_LISTING_READY.`,schemaType:`string`,choices:[`NONE`,`COMPANY_LISTING_READY`],location:`body`},{name:`filter.slug`,optionKey:`slug`,flag:`--slug <slug...>`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.stage`,optionKey:`stage`,flag:`--stage <stage...>`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.suppressNonOperating`,optionKey:`suppressNonOperating`,flag:`--suppress-non-operating <true|false>`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`,location:`body`},{name:`filter.suppressZeroTotalRaised`,optionKey:`suppressZeroTotalRaised`,flag:`--suppress-zero-total-raised <true|false>`,required:!1,description:`Suppress entities whose total raised is zero.`,schemaType:`boolean`,location:`body`},{name:`filter.tag`,optionKey:`tag`,flag:`--tag <tag...>`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.textSearch`,optionKey:`textSearch`,flag:`--text-search <text-search>`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`,location:`body`},{name:`filter.typeCustomer`,optionKey:`typeCustomer`,flag:`--type-customer <type-customer...>`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.typeModel`,optionKey:`typeModel`,flag:`--type-model <type-model...>`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.typeOwnership`,optionKey:`typeOwnership`,flag:`--type-ownership <type-ownership...>`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`filter.typeRevenue`,optionKey:`typeRevenue`,flag:`--type-revenue <type-revenue...>`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.typeTechnologyUsed`,optionKey:`typeTechnologyUsed`,flag:`--type-technology-used <type-technology-used...>`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.url`,optionKey:`url`,flag:`--url <url>`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`,location:`body`},{name:`filter.urlDomain`,optionKey:`urlDomain`,flag:`--url-domain <url-domain>`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`,location:`body`},{name:`filter.urlMatchMode`,optionKey:`urlMatchMode`,flag:`--url-match-mode <url-match-mode>`,required:!1,description:`URL matching mode: hostPath uses host and path; domain uses the root domain. Allowed values: hostPath, domain.`,schemaType:`string`,choices:[`hostPath`,`domain`],location:`body`},{name:`filter.urlType`,optionKey:`urlType`,flag:`--url-type <url-type>`,required:!1,description:`Restrict URL matching to one URL type. Allowed values: website, linkedin, twitter, github, facebook, instagram, tiktok, youtube, subreddit, forum, documentation, support, statuspage, changelog, roadmap, discord, crunchbase, wellfound, angellist, glassdoor, theorg, ycombinator, wikipedia, pitchbook, morningstar, bloomberg, nyse, nasdaq, g2, producthunt, trustpilot, alternativeto, gartnerpeerinsights, getapp, sourceforge, appstore, googleplay, capterra, trustradius, hubspotmarketplace, slackappdirectory, awsmarketplace, salesforceappexchange, chromewebstore, vscodemarketplace, npm, pypi, maven, dockerhub, homebrew, crates, huggingface.`,schemaType:`string`,choices:`website.linkedin.twitter.github.facebook.instagram.tiktok.youtube.subreddit.forum.documentation.support.statuspage.changelog.roadmap.discord.crunchbase.wellfound.angellist.glassdoor.theorg.ycombinator.wikipedia.pitchbook.morningstar.bloomberg.nyse.nasdaq.g2.producthunt.trustpilot.alternativeto.gartnerpeerinsights.getapp.sourceforge.appstore.googleplay.capterra.trustradius.hubspotmarketplace.slackappdirectory.awsmarketplace.salesforceappexchange.chromewebstore.vscodemarketplace.npm.pypi.maven.dockerhub.homebrew.crates.huggingface`.split(`.`),location:`body`},{name:`search.mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value; news and federated search accept only `auto` and `keyword`; content search accepts only `auto`. Allowed values: auto, exact, keyword, semantic, natural.",schemaType:`string`,defaultValue:`auto`,choices:[`auto`,`exact`,`keyword`,`semantic`,`natural`],location:`body`},{name:`search.model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Optional chat model for planning; null uses the configured natural-search default. A caller without admin authority may only choose an allowlisted model; admin callers are unrestricted.`,schemaType:`string`,location:`body`},{name:`search.query`,optionKey:`query`,flag:`--query <query>`,required:!0,description:`Plain-English search request.`,schemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[{status:`402`,description:`The authenticated caller's subscription does not include this search.`}],parameters:[{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`When false, generated monogram logos are stripped from entity rows.`,schemaType:`boolean`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes hidden or off-sitemap entities when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`searchNaturalPeople`,method:`POST`,path:`/v1/search/natural/people`,resource:`search`,intent:`search`,cliPath:[`search`,`natural`,`people`],summary:`Find people with natural language`,description:`Translate a plain-English people search into the canonical PersonFilter contract, execute the existing people list engine, and return both the interpretation and ranked people page. Broad role and profile requests use person semantic search. Explicit filter fields are hard constraints: they override planner values, while the planner fills fields left unset.`,explain:!0,requestBody:[{schemaImport:`@aventurevc/api-schemas/person/natural-search`,schemaName:`PersonNaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English people search plus explicit hard constraints. The planner may fill only filter fields the caller leaves unset.`,required:!0,requiredPath:[`search`,`search.query`],parameter:[{name:`filter.arrayFilter.amountInvestedRange[].min`,optionKey:`fundraiseAmountInvestedRangeMin`,flag:`--fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.arrayFilter.amountRaisedRange[].min`,optionKey:`fundraiseAmountRaisedRangeMin`,flag:`--fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.arrayFilter.totalInvestmentCount[].min`,optionKey:`totalInvestmentCountMin`,flag:`--total-investment-count-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.investorActivity.averageAmountInvestedUsdRange[].min`,optionKey:`investorActivityAverageAmountInvestedUsdRangeMin`,flag:`--investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.largestAmountInvestedUsdRange[].min`,optionKey:`investorActivityLargestAmountInvestedUsdRangeMin`,flag:`--investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.smallestAmountInvestedUsdRange[].min`,optionKey:`investorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.totalAmountInvestedUsdRange[].min`,optionKey:`investorActivityTotalAmountInvestedUsdRangeMin`,flag:`--investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.totalInvestmentRange[].min`,optionKey:`investorActivityTotalInvestmentRangeMin`,flag:`--investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.arrayFilter.amountInvestedRange[].max`,optionKey:`fundraiseAmountInvestedRangeMax`,flag:`--fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.arrayFilter.amountRaisedRange[].max`,optionKey:`fundraiseAmountRaisedRangeMax`,flag:`--fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.arrayFilter.totalInvestmentCount[].max`,optionKey:`totalInvestmentCountMax`,flag:`--total-investment-count-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.investorActivity.averageAmountInvestedUsdRange[].max`,optionKey:`investorActivityAverageAmountInvestedUsdRangeMax`,flag:`--investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.largestAmountInvestedUsdRange[].max`,optionKey:`investorActivityLargestAmountInvestedUsdRangeMax`,flag:`--investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.smallestAmountInvestedUsdRange[].max`,optionKey:`investorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.totalAmountInvestedUsdRange[].max`,optionKey:`investorActivityTotalAmountInvestedUsdRangeMax`,flag:`--investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.totalInvestmentRange[].max`,optionKey:`investorActivityTotalInvestmentRangeMax`,flag:`--investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.arrayFilter.entityName`,optionKey:`entityName`,flag:`--entity-name <entity-name...>`,required:!1,description:`Associated entity names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.arrayFilter.investedCompany`,optionKey:`fundraiseInvestedCompanyName`,flag:`--fundraise-invested-company-name <fundraise-invested-company-name...>`,required:!1,description:`Invested company names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.arrayFilter.personTitle`,optionKey:`personTitle`,flag:`--person-title <person-title...>`,required:!1,description:`Person titles.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.arrayFilter.round`,optionKey:`fundraiseRound`,flag:`--fundraise-round <fundraise-round...>`,required:!1,description:`Fundraise round labels.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.arrayFilter.typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Associated entity type scope. Omit or use [] for any associated type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`filter.entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!1,description:`Associated entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`body`},{name:`filter.entitySlug`,optionKey:`entitySlug`,flag:`--entity-slug <entity-slug>`,required:!1,description:`Associated entity slug.`,schemaType:`string`,location:`body`},{name:`filter.firstName`,optionKey:`firstName`,flag:`--first-name <first-name>`,required:!1,description:`Person first name.`,schemaType:`string`,location:`body`},{name:`filter.includeAddress`,optionKey:`includeAddress`,flag:`--include-address <true|false>`,required:!1,description:`Include addresses on each person.`,schemaType:`boolean`,location:`body`},{name:`filter.includeUrl`,optionKey:`includeUrl`,flag:`--include-url <true|false>`,required:!1,description:`Include URL links on each person.`,schemaType:`boolean`,location:`body`},{name:`filter.isCurrent`,optionKey:`isCurrent`,flag:`--is-current <true|false>`,required:!1,description:`Filter current associations.`,schemaType:`boolean`,location:`body`},{name:`filter.lastName`,optionKey:`lastName`,flag:`--last-name <last-name>`,required:!1,description:`Person last name.`,schemaType:`string`,location:`body`},{name:`filter.letter`,optionKey:`letter`,flag:`--letter <letter>`,required:!1,description:`First-name initial.`,schemaType:`string`,location:`body`},{name:`filter.personId`,optionKey:`personId`,flag:`--person-id <person-id...>`,required:!1,description:`Restrict results to specific person IDs. Omit or use [] for no ID restriction.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.personName`,optionKey:`personName`,flag:`--person-name <person-name...>`,required:!1,description:`Exact normalized match against a person's full name or slug.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.role`,optionKey:`role`,flag:`--role <role>`,required:!1,description:`Associated entity role or title.`,schemaType:`string`,location:`body`},{name:`filter.search`,optionKey:`search`,flag:`--search <search>`,required:!1,description:`Search keyword or phrase. Single characters valid; stop words rejected.`,schemaType:`string`,location:`body`},{name:`filter.semanticQuery`,optionKey:`semanticQuery`,flag:`--semantic-query <semantic-query>`,required:!1,description:`Semantic person search phrase.`,schemaType:`string`,location:`body`},{name:`filter.status`,optionKey:`status`,flag:`--status <status>`,required:!1,description:`Person workflow status.`,schemaType:`string`,location:`body`},{name:`search.mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value; news and federated search accept only `auto` and `keyword`; content search accepts only `auto`. Allowed values: auto, exact, keyword, semantic, natural.",schemaType:`string`,defaultValue:`auto`,choices:[`auto`,`exact`,`keyword`,`semantic`,`natural`],location:`body`},{name:`search.model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Optional chat model for planning; null uses the configured natural-search default. A caller without admin authority may only choose an allowlisted model; admin callers are unrestricted.`,schemaType:`string`,location:`body`},{name:`search.query`,optionKey:`query`,flag:`--query <query>`,required:!0,description:`Plain-English search request.`,schemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[{status:`402`,description:`The authenticated caller's subscription does not include this search.`}],parameters:[{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`When false, generated monogram pictures are stripped from person rows.`,schemaType:`boolean`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes hidden or off-sitemap people when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`listUniqueIdTypes`,method:`GET`,path:`/v1/unique-ids/types`,resource:`unique-ids`,intent:`read`,cliPath:[`unique-ids`,`types`,`list`],summary:`List the accepted unique identifier types`,description:`Lists the recognized external identifier types (ein, secCik, ticker, lei, duns, isin, cusip, crd, orcid) with each type's label, accepted aliases, owner scope (entity and/or person), and the format pattern a value must match on write.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[]},{operationId:`getAgentInstructionManifestAtRetiredAddress`,method:`GET`,path:`/v1/agents/instructions/manifest`,resource:`agents`,intent:`read`,cliPath:[`agents`,`instructions`,`manifest`,`get`],summary:`Deprecated: get the agent instruction manifest`,description:`Deprecated: use help instructions manifest get (GET /v1/help/instructions/manifest).`,deprecated:!0,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[]},{operationId:`getAgentInstructionVersionAtRetiredAddress`,method:`GET`,path:`/v1/agents/instructions/{kind}/{name}/versions/{version}`,resource:`agents`,intent:`read`,cliPath:[`agents`,`instructions`,`versions`,`get`],summary:`Deprecated: get one agent instruction document version`,description:`Deprecated: use help instructions versions get (GET /v1/help/instructions/{kind}/{name}/versions/{version}).`,deprecated:!0,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`kind`,optionKey:`kind`,flag:`--kind <kind>`,required:!0,description:`Document kind: prompt, skill, or agent. Allowed values: PROMPT, SKILL, AGENT.`,schemaType:`string`,choices:[`PROMPT`,`SKILL`,`AGENT`],location:`path`},{name:`name`,optionKey:`name`,flag:`--name <name>`,required:!0,description:`Manifest name of the document.`,schemaType:`string`,location:`path`},{name:`version`,optionKey:`instructionVersion`,flag:`--instruction-version <instruction-version>`,required:!0,description:`Immutable content version.`,schemaType:`string`,location:`path`}]},{operationId:`authorizeOperations`,method:`POST`,path:`/v1/auth/me/permissions`,resource:`auth`,intent:`write`,cliPath:[`auth`,`me`,`permissions`,`authorize`],summary:`Authorize API operations`,description:`Returns the supplied generated API operations that the current caller may call, alongside its existing permission grant and access class. Candidate operations are checked without being executed.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/auth/operation-filter`,schemaName:`AuthOperationFilterSchema`,kind:`json`,contentType:`application/json`,description:`Bounded generated API operations to authorize for the current session.`,required:!0,requiredPath:[`operation`,`operation[].authorizationPath`,`operation[].method`,`operation[].operationId`,`operation[].path`],parameter:[{name:`operation[].authorizationPath`,optionKey:`operationAuthorizationPath`,flag:`--operation-authorization-path <operation-authorization-path>`,required:!1,description:`Concrete path for authorization. Preserve the path template's literal segments and substitute its parameters with values matching their generated schema. No request is executed against this path.`,schemaType:`string`,location:`body`},{name:`operation[].method`,optionKey:`operationMethod`,flag:`--operation-method <operation-method>`,required:!1,description:`HTTP method of the operation. Allowed values: GET, POST, PUT, PATCH, DELETE.`,schemaType:`string`,choices:[`GET`,`POST`,`PUT`,`PATCH`,`DELETE`],location:`body`},{name:`operation[].operationId`,optionKey:`operationOperationId`,flag:`--operation-operation-id <operation-operation-id>`,required:!1,description:`Generated OpenAPI operation id.`,schemaType:`string`,location:`body`},{name:`operation[].path`,optionKey:`operationPath`,flag:`--operation-path <operation-path>`,required:!1,description:`Absolute API path. A whole path segment may be an OpenAPI placeholder such as {entityId}.`,schemaType:`string`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[],parameters:[]},{operationId:`getCurrentAuthPermissions`,method:`GET`,path:`/v1/auth/me/permissions`,resource:`auth`,intent:`read`,cliPath:[`auth`,`me`,`permissions`,`get`],summary:`Current user permissions`,description:`Returns the current caller's resolved roles and permissions.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[]},{operationId:`getClassificationCatalog`,method:`GET`,path:`/v1/entities/classifications/catalog`,resource:`entities`,intent:`read`,cliPath:[`entities`,`classifications`,`catalog`,`get`],summary:`Get the company classification taxonomy`,description:"Returns active classification buckets with optional tag lists. Each bucket carries its canonical `type`, accepted `alias[]` spellings, `tagCount`, and (when includeTags=true) the active `tag[]`. Use bucketType to scope to one bucket and includeTags=false to fetch metadata only. For tag ids, prefer the classification tag list filtered by category and name over broad catalog JSON; use returned tag.id as EntityClassificationMutation.tagId when writing classifications. Dormant registry tags are intentionally omitted; type + name writes that find one return 409 with inactiveTagOverride recovery choices.",scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`bucketType`,optionKey:`bucketType`,flag:`--bucket-type <bucket-type>`,required:!1,description:`Optional classification bucket. Accepts the same values as the tags endpoint type parameter.`,schemaType:`string`,location:`query`},{name:`includeTags`,optionKey:`includeTags`,flag:`--include-tags <true|false>`,required:!1,description:"When false, returns bucket metadata without tag arrays. For tag ids, prefer `entities classifications tags list` with category and q filters instead of broad catalog JSON.",schemaType:`boolean`,location:`query`}]},{operationId:`listEntityClassificationSuggestions`,method:`GET`,path:`/v1/entities/{entityId}/classifications/suggestions`,resource:`entities`,intent:`read`,cliPath:[`entities`,`classifications`,`suggestions`,`list`],summary:`Suggest classifications for a company`,description:`Default classification discovery path for enrichment agents. Returns ranked embedding-derived tag and standardized-code suggestions; empty array means no embedding neighbors. Create joins with the entity classifications create endpoint. A signed-in user is admitted for public entities; callers with private-visibility authority can also resolve hidden or private entities; setting includePrivate=true requires that authority. Signed-in callers without it can access public entities, while hidden entities return 404.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`limit`,optionKey:`limit`,flag:`--limit <integer>`,required:!1,description:`Maximum suggestions to return; default 12, maximum 50.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Includes private or hidden entity suggestions when the caller has private-visibility authority. Omit to use the caller's default visibility.`,schemaType:`boolean`,location:`query`}]},{operationId:`listClassifications`,method:`GET`,path:`/v1/entities/classifications/tags`,resource:`entities`,intent:`read`,cliPath:[`entities`,`classifications`,`tags`,`list`],summary:`List classification tags`,description:`Returns a paginated list of editorial tags and standardized classifications. Filter by category using any bucket or standardized category spelling listed by the catalog. Results expose writable/creatable policy so callers know whether to join by id or create by type plus name. Sorting is not supported — sort returns 422.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`category`,optionKey:`category`,flag:`--category <category>`,required:!1,description:`Classification bucket or standardized category. Case- and punctuation-insensitive.`,schemaType:`string`,location:`query`},{name:`q`,optionKey:`q`,flag:`--q <q>`,required:!1,description:`Case-insensitive name substring filter (e.g. 'enterprise').`,schemaType:`string`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`25`,location:`query`}]},{operationId:`listEntityContentFacets`,method:`GET`,path:`/v1/entities/{entityId}/content/facets`,resource:`entities`,intent:`read`,cliPath:[`entities`,`content`,`facets`,`list`],summary:`Count a company's publications`,description:`Counts one entity's content cards by topic and content type across the whole index, so filters show exact totals before every page loads. Any signed-in user may call this.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID whose publications are counted.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listEntityRelationshipTypes`,method:`GET`,path:`/v1/entities/relationships/types`,resource:`entities`,intent:`read`,cliPath:[`entities`,`relationships`,`types`,`list`],summary:`List entity relationship types`,description:`Returns canonical EntityRelationshipType values, aliases, and policy flags. Use joinable=true values with entities relationships create; acquisitionManaged=true values route through entity acquisitions; exclusiveRelationshipType lists relationship types that cannot coexist for the same unordered entity pair; readOnly=true values are emitted by reads only.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[]},{operationId:`listEntityResearchDetailTypes`,method:`GET`,path:`/v1/entities/research-details/types`,resource:`entities`,intent:`read`,cliPath:[`entities`,`research-details`,`types`,`list`],summary:`List the accepted research detail types`,description:`Returns research detail type tokens and their write metadata. The metadata includes valueShape, allowedToken, range, and timeSeries. When timeSeries=true, each believable dated observation is historical data: add a new current row and delete only rows believed false.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[]},{operationId:`listEntityResearchSnippetTypes`,method:`GET`,path:`/v1/entities/research-snippets/types`,resource:`entities`,intent:`read`,cliPath:[`entities`,`research-snippets`,`types`,`list`],summary:`List the accepted research snippet types`,description:`Lists the recognized research snippet types. A textType in this list is validated against its length and paragraph rules on write and defaults to visible; a textType not in this list is still saved but defaults to visible=false (hidden from default reads). The per-row visible flag overrides the default either way. The curated and analysisRenderable flags mark public Analysis-page eligibility, not snippet display.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[]},{operationId:`listEntitySimilarSummaries`,method:`GET`,path:`/v1/entities/{entityId}/similar/summary`,resource:`entities`,intent:`read`,cliPath:[`entities`,`similar`,`summary`,`list`],summary:`Get similar company summaries by id`,description:`Returns the same similar entities, order, and totals as GET /v1/entities/{entityId}/similar with lean rows: entity core, current URL links, and similarity provenance. Use it for rails and cards that do not render list enrichment. Custom sorting is unsupported. Any signed-in user may call this on every plan. The list is free: it never counts against the monthly record-view allowance, which charges only a separate full-detail view of one record.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`relationshipType`,optionKey:`relationshipType`,flag:`--relationship-type <relationship-type>`,required:!1,description:`Filter by stored relationship type, one of: acceleratorParticipant, acquirer, affinity, calculated, competingProductService, competitor, customer, fundManagerFirm, parent, productService, serviceProvider, similarCompany, spinOffFrom, successor.`,schemaType:`string`,location:`query`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Optional entity typeRecord filter. Repeat to allow multiple entity types.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Permit monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`10`,location:`query`}]},{operationId:`listEntityTextTypes`,method:`GET`,path:`/v1/entities/texts/types`,resource:`entities`,intent:`read`,cliPath:[`entities`,`texts`,`types`,`list`],summary:`List the accepted company text types`,description:`Returns text type values accepted by entity text rows.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Include private text types for callers with read access.`,schemaType:`boolean`,defaultValue:!1,location:`query`}]},{operationId:`getAgentInstructionManifest`,method:`GET`,path:`/v1/help/instructions/manifest`,resource:`help`,intent:`read`,cliPath:[`help`,`instructions`,`manifest`,`get`],summary:`Get the agent instruction manifest`,description:`Returns the latest-pointer manifest of versioned prompt and skill documents. Any signed-in user may call this.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[]},{operationId:`getAgentInstructionVersion`,method:`GET`,path:`/v1/help/instructions/{kind}/{name}/versions/{version}`,resource:`help`,intent:`read`,cliPath:[`help`,`instructions`,`versions`,`get`],summary:`Get one agent instruction document version`,description:`Returns an immutable prompt, skill, or agent document by name and version. Any signed-in user may call this.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`kind`,optionKey:`kind`,flag:`--kind <kind>`,required:!0,description:`Document kind: prompt, skill, or agent. Allowed values: PROMPT, SKILL, AGENT.`,schemaType:`string`,choices:[`PROMPT`,`SKILL`,`AGENT`],location:`path`},{name:`name`,optionKey:`name`,flag:`--name <name>`,required:!0,description:`Manifest name of the document.`,schemaType:`string`,location:`path`},{name:`version`,optionKey:`instructionVersion`,flag:`--instruction-version <instruction-version>`,required:!0,description:`Immutable content version.`,schemaType:`string`,location:`path`}]},{operationId:`listPersonContentFacets`,method:`GET`,path:`/v1/people/{personId}/content/facets`,resource:`people`,intent:`read`,cliPath:[`people`,`content`,`facets`,`list`],summary:`Count a person's publications`,description:`Counts one person's content cards by topic and content type across the whole index, so filters show exact totals before every page loads. Any signed-in user may call this.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID whose publications are counted.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listPersonTextTypes`,method:`GET`,path:`/v1/people/texts/types`,resource:`people`,intent:`read`,cliPath:[`people`,`texts`,`types`,`list`],summary:`List the accepted person text types`,description:`Returns text type values accepted by person text rows.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[]}];export{f as _,M as a,T as c,p as d,_ as f,u as g,l as h,j as i,y as l,s as m,F as n,A as o,h as p,k as r,x as s,I as t,v as u};