@aventurevc/aventure-cli 0.7.288 → 0.7.295

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

@@ -1,3 +0,0 @@
-import{C as e,a as t,c as n,k as r,v as i}from"./person-owner-ChqQWHII.js";import{$ as a,E as o,F as s,K as c,O as ee,R as l,T as te,X as ne,a as u,et as re,g as d,q as f,r as ie,u as ae,w as oe}from"./auth-BLOLziUK.js";import{randomUUID as p}from"node:crypto";function m(e,t=[]){let n=e instanceof Error?e.message:String(e);return d(n,t)}function se(e,t=[]){let n=d(e.title,t),r=d(e.detail?.trim()??``,t);return`${e.status} ${n}${r?` — ${r}`:``}`}function h(e){let t=e.trim();if(t.length===0)throw Error(`API host must not be blank`);let n=new URL(ue(t)?t:`${de(t)}://${t}`),r=g(n.hostname);if(n.protocol!==`https:`&&n.protocol!==`http:`||n.username.length>0||n.password.length>0||n.pathname!==`/`&&n.pathname!==``||n.search.length>0||n.hash.length>0)throw Error(`API host must contain only an HTTP(S) host and optional port`);if(n.protocol===`http:`&&!r)throw Error(`personal credentials require HTTPS except for loopback API hosts`);return{host:n.host.toLowerCase(),origin:n.origin,isLoopback:r}}function ce(e){return{...e,host:h(e.host).origin}}function le(e){let t=h(e);if(t.isLoopback)return`http://localhost:3000`;if(t.host===`api.aventure.vc`)return`https://aventure.vc`;throw Error(`no first-party browser origin is configured for API host ${t.host}`)}function ue(e){return/^[a-z][a-z\d+.-]*:\/\//iu.test(e)}function de(e){let t=e.split(`/`,1)[0]?.toLowerCase()??``;try{return g(new URL(`http://${t}`).hostname)?`http`:`https`}catch{return`https`}}function g(e){let t=e.toLowerCase();return t===`localhost`||t===`127.0.0.1`||t===`0.0.0.0`||t===`[::1]`}var fe=`vc.aventure.aventure-cli.oauth`,pe=`oauth:`;function me(e,t){let n=E(t);return{client:e,expiresAt:be(D(n)),tokens:n}}async function he(e,t){let n=b(e),r=_e(n,t),i=await C(n),a;try{await i.setPassword(r)}catch(e){a=e}let o;try{o=await i.getPassword()??void 0}catch(e){throw Error(`OS OAuth credential storage write outcome is unknown (${A(a??e,[r,...S(t.tokens)])})`,{cause:e})}if(o!==r)throw Error(`OS OAuth credential storage did not confirm a durable write (${A(a,[r,...S(t.tokens)])})`,a===void 0?void 0:{cause:a});return{host:n,credential:w(n,r)}}async function _(e){let t=b(e),n;try{n=await(await C(t)).getPassword()??void 0}catch(e){return{state:`unavailable`,summary:`OS OAuth credential storage is unavailable (${A(e)})`}}return n===void 0?{state:`missing`}:{state:`found`,stored:{host:t,credential:w(t,n)}}}async function v(e){try{return await _(e)}catch(e){return{state:`invalid`,summary:m(e)}}}async function ge(e){let t=await v(e);if(t.state!==`missing`)return t;let n=await y(e);return n.state===`available`?t:n}async function y(e){let t=`${b(e)}:probe:${p()}`,n=`aventure-cli-oauth-keyring-probe:${p()}`,r;try{r=await C(t)}catch(e){return{state:`unavailable`,summary:`OS OAuth credential storage is unavailable (${A(e,[t])})`}}let i;try{await r.setPassword(n),await(await C(t)).getPassword()!==n&&(i=`Error: probe readback did not match`)}catch(e){i=A(e,[n,t])}try{let e=await r.deleteCredential(),n=await(await C(t)).getPassword();(!e||n!=null)&&(i??=`Error: probe cleanup was not confirmed`)}catch(e){i??=A(e,[n,t])}return i===void 0?{state:`available`}:{state:`unavailable`,summary:`OS OAuth credential storage is unavailable (${i})`}}function b(e){return h(e).host}function x(e){return new Date(e.expiresAt).getTime()<=Date.now()}function S(e){return[e.access_token,e.refresh_token,e.id_token]}async function C(e){let{AsyncEntry:t}=await import(`@napi-rs/keyring`);return new t(fe,`${pe}${e}`)}function _e(e,t){return JSON.stringify({client:T(e,t.client),expiresAt:O(t.expiresAt),tokens:E(t.tokens)})}function w(e,t){let n;try{n=JSON.parse(t)}catch(e){throw Error(`OS OAuth credential entry failed schema validation`,{cause:e})}if(!xe(n))throw Error(`OS OAuth credential entry failed schema validation`);return{client:T(e,ve(n.client)),expiresAt:O(n.expiresAt),tokens:E(ye(n.tokens))}}function T(e,t){if(b(t.resource)!==e)throw Error(`OAuth client resource must match the credential API host`);return t}function ve(e){let t=u.safeParse(e);if(!t.success)throw Error(`OS OAuth credential entry failed canonical client validation`,{cause:t.error});return t.data}function ye(e){let t=ie.safeParse(e);if(!t.success)throw Error(`OS OAuth credential entry failed OAuth token validation`,{cause:t.error});return t.data}function E(e){if(!k(e.access_token)||e.token_type.trim().toLowerCase()!==`bearer`)throw Error(`OAuth token response must contain a bearer access token`);if(e.refresh_token!==void 0&&!k(e.refresh_token))throw Error(`OAuth token response has an invalid refresh token`);return D(e),e}function D(e){let t=e.expires_in;if(typeof t!=`number`||!Number.isSafeInteger(t)||t<=0)throw Error(`OAuth token response must contain a positive expires_in`);return t}function be(e){let t=new Date(Date.now()+e*1e3);if(!Number.isFinite(t.getTime()))throw Error(`OAuth token response has an expiry outside the supported date range`);return t.toISOString()}function O(e){if(typeof e!=`string`)throw Error(`OS OAuth credential entry has an invalid absolute expiry`);let t=new Date(e);if(!Number.isFinite(t.getTime())||t.toISOString()!==e)throw Error(`OS OAuth credential entry has an invalid absolute expiry`);return e}function k(e){return e.trim()===e&&e.length>0}function xe(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function A(e,t=[]){if(!(e instanceof Error))return`Error`;let n=e.name||`Error`,r=m(e,t).trim();return r&&r!==n?`${n}: ${r}`:n}async function Se(e){if(M())return;let t;try{let e=a();if(e.clientSecret?.trim()||e.adminApiKey?.trim())return;t=b(e.host)}catch(t){throw N(`the API host could not select its OAuth credential`,e,t)}let n;try{n=await _(t)}catch(t){throw N(`the saved OAuth credential is invalid or expired`,e,t)}if(n.state!==`missing`){if(n.state===`unavailable`)throw N(`the saved OAuth credential could not be read`,e,Error(n.summary));await j(n.stored,e)}}async function j(e,t){if(x(e.credential))throw N(`the saved OAuth credential has expired`,t,void 0,e);let n;try{n=await ae(e.credential.tokens.access_token,new URL(e.credential.client.resource))!==null}catch(n){throw N(`the saved OAuth credential could not be verified`,t,n,e)}if(!n)throw N(`the saved OAuth credential was rejected`,t,void 0,e);M()||(process.env[f.authToken]=e.credential.tokens.access_token)}function M(){return(process.env[f.authToken]?.trim().length??0)>0}function N(e,t,n,r){let i=r===void 0?[]:S(r.credential.tokens),a=n===void 0?``:` — ${m(n,i)}`,o=t??c().bin[0];return Error(`OAuth sign-in is required: ${e}. Run \`${o} auth login\` before retrying.${a}`)}var P=i({createdAt:r({offset:!0}),description:e().nullish(),expiresAt:r({offset:!0}).nullish(),id:e().regex(/^ak_[0-9A-Fa-f]{32}$/),lastUsedAt:r({offset:!0}).nullish(),name:e(),revocationReason:e().nullish(),scopes:n(e()),status:t([`ACTIVE`,`REVOKED`,`EXPIRED`]),subject:e(),updatedAt:r({offset:!0})}),Ce=`vc.aventure.aventure-cli`,F=`aventure-cli-personal-v1`;async function we(e,t,n){let r=L(e),i=De(t,n),a=await R(r),o;try{await a.setPassword(i)}catch(e){o=e}let s;try{s=await a.getPassword()??void 0}catch(e){throw Error(`OS credential storage write outcome is unknown (${V(o??e,[i,t.secret])}); broker acknowledgment was withheld. Re-run auth status before retrying.`,{cause:e})}if(s!==i)throw Error(`OS credential storage did not confirm a durable write (${V(o,[i,t.secret])}); broker acknowledgment was withheld.`,o===void 0?void 0:{cause:o});return{host:r,activation:n,credential:t}}async function I(e){let t=L(e),n;try{n=await(await R(t)).getPassword()??void 0}catch(e){return z(V(e))}return n===void 0?{state:`missing`}:{state:`found`,stored:{host:t,...B(n)}}}async function Te(e){let t=await I(e);if(t.state!==`missing`)return t;let n=`${L(e)}:probe:${p()}`,r=`aventure-cli-keyring-probe:${p()}`,i,a;try{a=await R(n)}catch(e){return z(V(e))}try{await a.setPassword(r),await(await R(n)).getPassword()!==r&&(i=`Error: probe readback did not match`)}catch(e){i=V(e)}try{let e=await a.deleteCredential(),t=await(await R(n)).getPassword();(!e||t!=null)&&(i??=`Error: probe cleanup was not confirmed`)}catch(e){i??=V(e)}return i===void 0?t:z(i)}async function Ee(e){let t=await R(L(e)),n;try{await t.deleteCredential()}catch(e){n=e}try{if((await t.getPassword()??void 0)===void 0)return}catch(e){throw Error(`OS credential removal outcome is unknown (${V(n??e)})`,{cause:e})}throw Error(`OS credential storage did not confirm removal (${V(n)})`,{cause:n})}function L(e){return h(e).host}async function R(e){let{AsyncEntry:t}=await import(`@napi-rs/keyring`);return new t(Ce,e)}function z(e){return{state:`unavailable`,summary:`OS credential storage is unavailable (${e})`,cause:`keyring`}}function De(e,t){return`${F}:${t}\n${JSON.stringify(e.apiKey)}\n${e.secret}`}function B(e){let t=e.indexOf(`
-`),n=t<0?-1:e.indexOf(`
-`,t+1),r=t<0?e:e.slice(0,t),i=r===`${F}:active`?`active`:`pending`;if(t<0||n<0||r!==`${F}:pending`&&r!==`${F}:active`)throw Error(`OS credential entry has an unsupported format`);let a=e.slice(n+1);if(a.length===0)throw Error(`OS credential entry has an empty secret`);let o;try{o=JSON.parse(e.slice(t+1,n))}catch(e){throw Error(`OS credential entry failed canonical schema validation`,{cause:e})}let s=P.safeParse(o);if(!s.success)throw Error(`OS credential entry failed canonical schema validation`,{cause:s.error});return{activation:i,credential:{apiKey:s.data,secret:a}}}function V(e,t=[]){if(!(e instanceof Error))return`Error`;let n=e.name||`Error`,r=m(e,t).trim();return r&&r!==n?`${n}: ${r}`:n}async function Oe(){if(H())return;let e=L(a().host);try{let t=await I(e);if(t.state===`unavailable`){s(U(`keyring`,Error(t.summary)));return}t.state===`found`&&t.stored.activation===`active`&&!H()&&(process.env[f.authToken]=t.stored.credential.secret)}catch(e){l(U(`parse`,e))}}function H(){return(process.env[f.authToken]?.trim().length??0)>0}function U(e,t){return{component:`aventure-cli`,event:`personal_credential_materialization_unavailable`,message:`saved personal CLI credential could not be loaded; continuing with environment auth`,fields:{source:e},error:t}}var W={agents:{summary:`Install the aVenture agent skill bundle, read versioned agent instructions, and ask grounded platform questions`,section:`cli`},"agents instructions":{summary:`Versioned agent prompt and skill documents`},"agents instructions versions":{summary:`Versioned agent prompt and skill documents`},auth:{summary:`Authentication entry points and sign-in configuration`,section:`account`},"auth providers":{summary:`Read browser sign-in availability and CLI OAuth configuration`},classifications:{summary:`Browse and search the entity classification tag catalog`,section:`researchData`},"classifications catalog":{summary:`Fetch the full entity classification taxonomy`},"classifications search":{summary:`Search the classification taxonomy by keyword`},"classifications tags":{summary:`Search assignable entity classification tags`},content:{summary:`Public content cards: news, blog posts, social posts, repositories, websites, and papers`,section:`researchData`},entities:{summary:`Companies, funds, investors, accelerators, and other organizations`,section:`researchData`},"entities acquisitions":{summary:`Canonical acquisition event CRUD`},"entities addresses":{summary:`Nested address CRUD for entities`},"entities batch":{summary:`Batch reads: many entity records or details in one request`},"entities batch detail":{summary:`Companies, funds, investors, accelerators, and other organizations`},"entities blog-posts":{summary:`External blog and article links for entities and people`},"entities by-id":{summary:`Get entity by ID`},"entities classifications":{summary:`Read, audit, and reconcile one entity's classification tags`},"entities content":{summary:`Public content cards: news, blog posts, social posts, repositories, websites, and papers`},"entities counts":{summary:`Count entities by type`},"entities filters":{summary:`Entity filter options: list, count, refine, and search`},"entities filters counts":{summary:`Entity filter discovery: tag counts, type counts, refinement metadata, and option set search used to drive entity-listing UIs`},"entities filters refine":{summary:`Entity filter discovery: tag counts, type counts, refinement metadata, and option set search used to drive entity-listing UIs`},"entities filters search":{summary:`Entity filter discovery: tag counts, type counts, refinement metadata, and option set search used to drive entity-listing UIs`},"entities fundraise":{summary:`Funding rounds and their participating investors for an entity`},"entities fundraise investments":{summary:`Funding rounds and their participating investors for an entity`},"entities fundraise investor-activity":{summary:`Funding rounds and their participating investors for an entity`},"entities fundraise investor-joins":{summary:`Funding rounds and their participating investors for an entity`},"entities fundraise investors":{summary:`Funding rounds and their participating investors for an entity`},"entities fundraise person-investors":{summary:`Funding rounds and their participating investors for an entity`},"entities fundraise rounds":{summary:`Funding rounds and their participating investors for an entity`},"entities identifiers":{summary:`Resolve batches of external identifiers to entity records`},"entities identifiers types":{summary:`External identifier mappings (EIN, SEC CIK, ticker, LEI, DUNS, ...) for entities and people, plus reverse lookup from an identifier to its owner`},"entities lookup":{summary:`Look up one entity`},"entities lookup matches":{summary:`Companies, funds, investors, accelerators, and other organizations`},"entities media":{summary:`Logos, photos, and thumbnails for companies, people, and news`},"entities media logo":{summary:`Logos, photos, and thumbnails for companies, people, and news`},"entities news":{summary:`News linked to one entity, including semantic-similarity matches`},"entities news trending":{summary:`Related companies, trending news, and batch ingestion`},"entities people":{summary:`Person associations and employee-count records for one entity`},"entities people employee-counts":{summary:`Entity employee-count sub-resource: time series for an entity`},"entities products":{summary:`Suggest products and services for an entity`},"entities relationships":{summary:`Entity-to-entity relationships and suggested relationship candidates`},"entities relationships row":{summary:`Entity relationship endpoints`},"entities relationships types":{summary:`Entity relationship endpoints`},"entities repositories":{summary:`GitHub repositories synced per entity or person owner`},"entities research":{summary:`Entity research texts, snippets, and completion gates`},"entities research details":{summary:`Typed research details and snippets for entities, with snippet provenance`},"entities research details types":{summary:`Typed research details and snippets for entities, with snippet provenance`},"entities research snippets":{summary:`Typed research details and snippets for entities, with snippet provenance`},"entities research snippets types":{summary:`Typed research details and snippets for entities, with snippet provenance`},"entities similar":{summary:`Find entities similar to one entity`},"entities slug":{summary:`Per-domain slug changes and redirect rows`},"entities slug redirects":{summary:`Per-domain slug changes and redirect rows`},"entities summary":{summary:`List compact entity summaries`},"entities texts":{summary:`Create, read, update, and delete entity text rows`},"entities texts types":{summary:`Entity and person text endpoints`},"entities trending-news":{summary:`Related companies, trending news, and batch ingestion`},"entities type-record":{summary:`Read or set an entity's type record`},"entities type-record types":{summary:`Administrative tools for entity data maintenance`},"entities urls":{summary:`Create, read, update, and delete entity URL links`},"entities urls all":{summary:`Entity and person URL link endpoints`},"entities urls surface-misclassifications":{summary:`Entity and person URL link endpoints`},"entities urls types":{summary:`Entity and person URL link endpoints`},"entities valuations":{summary:`Entity valuation time-series reads and writes`},help:{summary:`Grounded natural-language platform help with citations`,section:`cli`},media:{summary:`Logos, photos, and thumbnails for companies, people, and news`,section:`researchData`},"media screenshots":{summary:`Crawl screenshot metadata endpoints — S3 key is the binary asset source of truth`},news:{summary:`Venture news articles linked to companies and people`,section:`researchData`},"news by-id":{summary:`Read and mutate a news article by its canonical numeric identifier`},"news feedback":{summary:`Submit reader feedback on a news article`},"news media":{summary:`Logos, photos, and thumbnails for companies, people, and news`},"news media thumbnail":{summary:`Logos, photos, and thumbnails for companies, people, and news`},"news recent":{summary:`List the most recent news articles`},"news related-companies":{summary:`Related companies, trending news, and batch ingestion`},"news similar":{summary:`Find news articles similar to one article`},"news slug":{summary:`Per-domain slug changes and redirect rows`},"news slug redirects":{summary:`Per-domain slug changes and redirect rows`},people:{summary:`Founders, executives, and investors in the venture ecosystem`,section:`researchData`},"people addresses":{summary:`Canonical nested physical-address groups for people`},"people batch":{summary:`Batch person list and detail endpoints`},"people batch detail":{summary:`Batch person list and detail endpoints`},"people blog-posts":{summary:`Create, read, update, and delete a person's blog-post links`},"people by-id":{summary:`Get person by ID`},"people by-slug":{summary:`Person reads addressed by slug instead of id`},"people by-slug blog-posts":{summary:`External blog and article links for entities and people`},"people content":{summary:`Public content cards: news, blog posts, social posts, repositories, websites, and papers`},"people entities":{summary:`Person-entity association routes`},"people filters":{summary:`Person filter, letter-count, and search metadata endpoints used to drive people-listing UI affordances`},"people filters search":{summary:`Person filter, letter-count, and search metadata endpoints used to drive people-listing UI affordances`},"people graph":{summary:`Read a person's relationship graph`},"people identifiers":{summary:`External identifier mappings (EIN, SEC CIK, ticker, LEI, DUNS, ...) for entities and people, plus reverse lookup from an identifier to its owner`},"people identifiers types":{summary:`External identifier mappings (EIN, SEC CIK, ticker, LEI, DUNS, ...) for entities and people, plus reverse lookup from an identifier to its owner`},"people investments":{summary:`List a person's investments`},"people investor-activity":{summary:`Read a person's investor-activity rollup`},"people lookup":{summary:`Look up one person`},"people media":{summary:`Logos, photos, and thumbnails for companies, people, and news`},"people media photo":{summary:`Logos, photos, and thumbnails for companies, people, and news`},"people news":{summary:`CRUD endpoints for news articles joined to people`},"people repositories":{summary:`GitHub repositories synced per entity or person owner`},"people similar":{summary:`Similar person discovery`},"people slug":{summary:`Per-domain slug changes and redirect rows`},"people slug redirects":{summary:`Per-domain slug changes and redirect rows`},"people texts":{summary:`Entity and person text endpoints`},"people texts types":{summary:`Entity and person text endpoints`},"people urls":{summary:`Entity and person URL link endpoints`},"people urls all":{summary:`Entity and person URL link endpoints`},"people urls types":{summary:`Entity and person URL link endpoints`},provenance:{summary:`Where any stored field value came from: its source, method, and time`,section:`researchData`},"provenance history":{summary:`Full provenance history for one stored record`},"provenance latest":{summary:`Latest data source recorded for one stored record`},resolve:{summary:`Universal identifier resolver: map any handle — stable public id, UUID, external registry id (ticker, LEI, EIN, ...), or slug — to its canonical entity or person`,section:`researchData`},search:{summary:`Search companies, people, and news together, or search the live web`,section:`researchData`},"search link":{summary:`Search a public page URL for related entities, people, and news`},sec:{summary:`SEC EDGAR filings, tickers, and CIKs for public companies`,section:`researchData`},"sec company":{summary:`Preview one public company from SEC EDGAR`},"url-types":{summary:`Entity and person URL link endpoints`,section:`researchData`}};function ke(e,t){let n=q(e);if(t===void 0||t.length===0)return n;let r=`Allowed values: ${t.join(`, `)}`;return n===``?`${r}.`:`${n} ${r}.`}var G={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 Ae(e){return K(e).rank}function je(e){return K(e).heading}function K(e){return e.location===`path`?G.path:e.location===`header`?G.header:e.inputType===`file`||e.schemaFormat===`binary`?G.input:e.location===`body`?G.body:G.option}var q=e=>e===``||/[.!?]$/u.test(e)?e:`${e}.`,Me={researchData:{heading:`Research data commands:`,rank:0},account:{heading:`Account commands:`,rank:1},administration:{heading:`Administration commands (require ADMIN_API_KEY or AUTH_TOKEN):`,rank:2},cli:{heading:`CLI commands:`,rank:3}};function J(e){return e!==void 0&&Y(e)===`administration`}function Y(e){return Ne[e]??W[e]?.section}var Ne={auth:`account`,app:`account`,entities:`researchData`,people:`researchData`,news:`researchData`,media:`researchData`,content:`researchData`,search:`researchData`,resolve:`researchData`,classifications:`researchData`,"url-types":`researchData`,provenance:`researchData`,sec:`researchData`,billing:`account`,harness:`administration`,jobs:`administration`,operations:`administration`,inference:`administration`,sitemap:`administration`,slug:`administration`,web:`administration`,addresses:`administration`,contacts:`administration`,research:`administration`,status:`cli`,help:`cli`,agents:`cli`};function Pe(e){let{adminApiKey:t,userBearerToken:n}=a();return Fe(e,!!(t?.trim()||n?.trim()))}function Fe(e,t){return t?e:e.filter(e=>!J(e.cliPath[0])).map(Ie).map(Le)}function Ie(e){return J(e.cliAliasPath?.[0])?{...e,cliAliasPath:void 0}:e}function Le(e){let t=e.parameters.filter(X),n=e.requestBody?.map(e=>{let t=e.parameter.filter(X);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 X=e=>e.visibility!==`private`;function Re(e,t){let n=e.indexOf(`--`),r=e.slice(0,n===-1?e.length:n);if(r.some(e=>e===`--version`||e===`-V`))return`none`;let i=new te().exitOverride().configureOutput({writeErr:()=>void 0}).addOption(new o(`--environment <environment>`,`route all API calls to a mapped API environment`).choices([...ne()])).addOption(new o(`--content-type <media-type>`)).addOption(new o(`--ask <question>`)),a=i.parseOptions([...e]).operands,s=i.opts().environment;s!==void 0&&(process.env.API_ENV=s);let c=t.find(e=>Z(a,e.cliPath)||e.cliAliasPath!==void 0&&Z(a,e.cliAliasPath)),l=i.opts().contentType;if(c!==void 0&&l!==void 0){let e=oe(c.requestBody??[],l);if(!e.ok)throw new ee(e.summary)}let u=a.at(0);return u===void 0?`optional`:[`auth`,`update`].includes(u)?`none`:r.some(e=>e===`--help`||e===`-h`)?J(u)?`optional`:`none`:J(u)?`required`:u===`help`?c===void 0?i.opts().ask===void 0?`optional`:a.length===1?`required`:`none`:`required`:u===`agents`&&a[1]===`setup`?`required`:[`command-catalog`,`completion`,`docs`].includes(u)?`optional`:u===`batch`?`required`:c===void 0?`optional`:`required`}function Z(e,t){return t.every((t,n)=>e[n]===t)}var Q=`${re/1e3}KB`,ze=[{flags:`--text`,description:`Print text (terminal default).`,conflicts:[`data`,`dataFull`,`json`]},{flags:`--data`,description:`Print data JSON (piped default); over ${Q} 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 ${Q}).`,conflicts:[`text`,`data`,`dataFull`]}];function Be(e){for(let t of ze)e.addOption(new o(t.flags,t.description).conflicts([...t.conflicts]));return e}function Ve(e,t=`auto`){return e.json===!0?`json`:e.dataFull===!0?`data-full`:e.data===!0?`data`:e.text===!0?`text`:We(e)||t===`auto`&&!process.stdout.isTTY?`data`:`text`}function He(e){return e.includes(`--text`)?!1:e.includes(`--json`)||e.includes(`--data`)||e.includes(`--data-full`)||e.includes(`--agent-chassis`)&&e.includes(`--agent-model`)||!process.stdout.isTTY}function Ue(e){return e===`data`||e===`data-full`||e===`json`}function We(e){return $(e.agentChassis)&&$(e.agentModel)}function $(e){return typeof e==`string`&&e.trim().length>0}var Ge=`cd82b96a230a21a8`,Ke=[{operationId:`getStatus`,method:`GET`,path:`/v1/status`,resource:`status`,intent:`status`,cliPath:[`status`],summary:`Get system uptime`,description:`Returns Better Stack uptime SLA. Public — callable with zero credentials. Local CLI auth provenance is reported by its auth status builtin, which calls this endpoint for uptime and resolves credential sources locally.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[]},{operationId:`listContent`,method:`GET`,path:`/v1/content`,resource:`content`,intent:`read`,cliPath:[`content`,`list`],summary:`List content`,description:`Returns a paged public content index across supported source owners. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,scope:`read`,auth:`read`,errorResponse:[],parameters:[{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:`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`},{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:`searchContent`,method:`POST`,path:`/v1/content/search`,resource:`content`,intent:`search`,cliPath:[`content`,`search`],summary:`Search content`,description:`Translates plain-English content constraints into canonical filters. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,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. Accepted values narrow per surface: entity and person natural-search take every value (`exact` is entity-only); news and federated search accept only `auto` and `keyword`; content search accepts only `auto`. Defaults to `auto`, which keeps the server-chosen pipeline; any other value forces exactly that strategy. 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. CLIENT_SECRET callers may only choose client-secret-eligible models; admin keys 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`,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:`getEntityDetail`,method:`GET`,path:`/v1/entities/detail`,resource:`entities`,intent:`read`,cliPath:[`entities`,`get`],summary:`Get company or entity detail`,description:`Returns one entity by exact id, slug, strict URL, or deterministic candidate signals. A sole exact normalized brand/legal-name or stored-URL match, or a guaranteed identity match without a competing review candidate, resolves directly. For keywords use POST /v1/entities/search with textSearch; for plain English use the search entities command (POST /v1/entities/natural-search). Default reads hide hidden or off-sitemap entities; privileged callers may set includePrivate=true for write readback. GET /v1/entities and POST /v1/entities/search list filtered records. Changed slugs redirect; error responses document every unresolved outcome.`,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 (CLI: entities search --text-search). An existing but filtered row instead reports its reason as the ProblemDetail title: Entity Exists but Is Not Public (retry with includePrivate=true; CLI: --include-private 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 and names the duplicate-check endpoint (CLI: entities duplicate-check candidates list); resolve by entityId, companySlug plus slug, or a provider's productService relationship.`}],parameters:[{name:`id`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!1,description:`Exact entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{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. Historically named companySlug; 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/entities/urls/types (CLI: entities urls 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 type-record 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:`Privileged admin readback scope. Includes hidden or off-sitemap entities and hidden research snippets. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,schemaType:`boolean`,location:`query`}]},{operationId:`listEntities`,method:`GET`,path:`/v1/entities`,resource:`entities`,intent:`read`,cliPath:[`entities`,`list`],summary:`List or search companies and other entities (GET)`,description:`Browse paginated entity records or apply explicit query filters. entityName is an exact normalized brand/legal-name filter; textSearch is keyword/full-text search. Organization expands to the canonical organization type group. For a plain-English or multi-constraint company request, use the search entities command (POST /v1/entities/natural-search) instead. Set semanticQuery for semantic nearest-neighbor ranking over stored content embeddings; semanticQuery uses the live priority embeddings tier and returns semanticMatch evidence. countOnly is unsupported when semanticQuery is present; count-only pages have no content, so read totalElements rather than empty. Default public visibility can filter hidden/off-sitemap records and does not prove create safety; use duplicate-check before writes that need identity review.`,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:`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 status values.`,schemaType:`array`,itemSchemaType:`string`,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:`letter`,optionKey:`letter`,flag:`--letter <letter>`,required:!1,description:`First letter of the display name.`,schemaType:`string`,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:`semanticQuery`,optionKey:`semanticQuery`,flag:`--semantic-query <semantic-query>`,required:!1,description:`Semantic entity search phrase. Supported by GET /v1/entities and POST /v1/entities/search; every other entity filter surface rejects the parameter.`,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:`Privileged admin readback scope. Includes hidden or off-sitemap entities. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,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:`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:`lookupEntity`,method:`GET`,path:`/v1/entities/lookup`,resource:`entities`,intent:`read`,cliPath:[`entities`,`lookup`],summary:`Look up one entity`,description:`Resolves one entity by slug, URL, or candidate signals with existing detail qualifiers and visibility rules. UUIDs use the item route; id query parameters are rejected. Changed slugs redirect canonically.`,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 (CLI: entities search --text-search). An existing but filtered row instead reports its reason as the ProblemDetail title: Entity Exists but Is Not Public (retry with includePrivate=true; CLI: --include-private 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 and names the duplicate-check endpoint (CLI: entities duplicate-check candidates list); resolve by entityId, companySlug plus slug, or a provider's productService relationship.`}],parameters:[{name:`slug`,optionKey:`recordSlug`,flag:`--record-slug <record-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. Historically named companySlug; 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/entities/urls/types (CLI: entities urls 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 type-record 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:`Privileged admin readback scope. Includes hidden or off-sitemap entities and hidden research snippets. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,schemaType:`boolean`,location:`query`}]},{operationId:`listEntitiesPost`,method:`POST`,path:`/v1/entities/search`,resource:`entities`,intent:`search`,cliPath:[`entities`,`search`],summary:`Search companies and other entities (POST)`,description:`Run keyword, semantic, or explicit structured entity filtering with an EntityListFilter JSON body. entityName is an exact normalized brand/legal-name filter; textSearch is keyword/full-text search. For a plain-English or multi-constraint company request, use POST /v1/entities/natural-search instead. Set semanticQuery for semantic nearest-neighbor ranking over stored content embeddings; semanticQuery uses the live priority embeddings tier and returns semanticMatch evidence. countOnly is unsupported when semanticQuery is present; count-only pages have no content, so read totalElements rather than empty. Default public visibility can filter hidden/off-sitemap records and does not prove create safety. Use duplicate-check before writes that need identity review. Structured search supports sort-aware cursor continuation with unchanged filters and sort; cursors are unsupported with semanticQuery or countOnly.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/list-filter`,schemaName:`EntityListFilterSchema`,kind:`json`,contentType:`application/json`,description:`Entity list and search filters including semantic entity search. Supported by GET /v1/entities and POST /v1/entities/search; 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 status values.`,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. Supported by GET /v1/entities and POST /v1/entities/search.`,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:`Privileged admin readback scope. Includes hidden or off-sitemap entities. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,schemaType:`boolean`,location:`query`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Opaque sort-aware entity cursor; reuse the same filters and sort. Unsupported with semanticQuery or countOnly.`,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:`answerAgentHelpQuestion`,method:`POST`,path:`/v1/agents/help`,resource:`agents`,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. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,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 CLIENT_SECRET (non-admin) caller may only choose a client-secret-eligible model (owned by app.inference.client-secret-eligible-chat-model); an ineligible model is rejected with 422. Admin keys 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:`getMedia`,method:`GET`,path:`/v1/media`,resource:`media`,intent:`read`,cliPath:[`media`,`get`],summary:`Get attached media asset`,description:`Returns current managed asset; empty slots 404; inactive media is not listed.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`mediaType`,optionKey:`mediaType`,flag:`--media-type <media-type>`,required:!0,description:`Media target type. Allowed values: ENTITY, PERSON, NEWS, BLOG.`,schemaType:`string`,choices:[`ENTITY`,`PERSON`,`NEWS`,`BLOG`],location:`query`},{name:`id`,optionKey:`mediaId`,flag:`--media-id <media-id>`,required:!1,description:`Target UUID for entity/person or integer id for news.`,schemaType:`string`,location:`query`},{name:`slug`,optionKey:`mediaSlug`,flag:`--media-slug <media-slug>`,required:!1,description:`Target slug.`,schemaType:`string`,location:`query`},{name:`logoType`,optionKey:`logoType`,flag:`--logo-type <logo-type>`,required:!1,description:`Entity logo variant. Allowed values: SQUARE, STANDARD.`,schemaType:`string`,choices:[`SQUARE`,`STANDARD`],location:`query`}]},{operationId:`getNewsDetail`,method:`GET`,path:`/v1/news/detail`,resource:`news`,intent:`read`,cliPath:[`news`,`get`],summary:`Get news detail`,description:`Returns full news article detail by id, slug, externalId, strict URL, or bounded title candidate signals. Ambiguous candidate signals return 409 ProblemDetail.details.newsCandidate; review those ids, update the matching article, and create only when all candidates are distinct and source evidence supports the target. score/threshold are review ranking, not absence proof. Handles canonical redirects for changed slugs.`,scope:`read`,auth:`read`,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:`id`,optionKey:`newsId`,flag:`--news-id <integer>`,required:!1,description:`Exact news article id. Mutually exclusive with slug, externalId, url, and title.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{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:`listNews`,method:`GET`,path:`/v1/news`,resource:`news`,intent:`read`,cliPath:[`news`,`list`],summary:`List news articles`,description:`USE FOR: Browsing news/articles in the canonical news domain with optional filtering. NOT FOR: Pre-create or pre-update identity gates; use /v1/news/duplicate-check.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{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:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`owner.personId`,optionKey:`ownerPersonId`,flag:`--owner-person-id <uuid>`,required:!1,description:`Canonical person UUID.`,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 author-initial alias; use authorInitial.`,schemaType:`string`,location:`query`},{name:`mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:`Response mode; use thin for cursor-paginated index reads.`,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:`lookupNews`,method:`GET`,path:`/v1/news/lookup`,resource:`news`,intent:`read`,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:`read`,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:`getPersonDetail`,method:`GET`,path:`/v1/people/detail`,resource:`people`,intent:`read`,cliPath:[`people`,`get`],summary:`Get person detail`,description:`Returns person detail by id, slug, strict URL, or bounded name/domain candidate signals. Default reads hide hidden or off-sitemap people; privileged callers can use includePrivate=true for write readback. Handles canonical redirects. Every non-resolving outcome is documented on this operation's error responses.`,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:`id`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!1,description:`Group A — exact person UUID. Mutually exclusive with slug, url, and every candidate signal in group C.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{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:`Privileged admin readback scope. Includes hidden or off-sitemap people and privileged private fields. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,schemaType:`boolean`,location:`query`}]},{operationId:`listPeople`,method:`GET`,path:`/v1/people`,resource:`people`,intent:`read`,cliPath:[`people`,`list`],summary:`List or search people`,description:`USE FOR: Browsing and filtering person/people/individual records in the people domain. semanticQuery uses the live priority embeddings tier and returns semanticMatch evidence. NOT FOR: Pre-create or pre-update identity gates; use /v1/people/duplicate-check.`,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:`semanticQuery`,optionKey:`semanticQuery`,flag:`--semantic-query <semantic-query>`,required:!1,description:`Semantic person search phrase.`,schemaType:`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:`Privileged read scope for admin callers. Bypasses the public visibility filter so hidden, unverified, and not-yet-published records are returned instead of being silently dropped. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,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:`GET`,path:`/v1/people/lookup`,resource:`people`,intent:`read`,cliPath:[`people`,`lookup`],summary:`Look up one person`,description:`Resolves person detail by slug, URL or bounded candidate signals with the existing projection and visibility options. Use the UUID item route for an id; any id query is rejected. Canonical redirects are preserved.`,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:`recordSlug`,flag:`--record-slug <record-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:`Privileged admin readback scope. Includes hidden or off-sitemap people and privileged private fields. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,schemaType:`boolean`,location:`query`}]},{operationId:`listPeoplePost`,method:`POST`,path:`/v1/people/search`,resource:`people`,intent:`search`,cliPath:[`people`,`search`],summary:`List people (POST)`,description:`Returns a paginated people list matching a filter request body. semanticQuery uses the live priority embeddings tier and returns semanticMatch evidence.`,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:`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:`Privileged read scope for admin callers. Bypasses the public visibility filter so hidden, unverified, and not-yet-published records are returned instead of being silently dropped. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,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:`getProvenance`,method:`GET`,path:`/v1/provenance/{provenanceId}`,resource:`provenance`,intent:`read`,cliPath:[`provenance`,`get`],summary:`Get a provenance row`,description:`Returns one field-level provenance row by its surrogate id, in the same shape the provenance history list returns. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`provenanceId`,optionKey:`provenanceId`,flag:`--provenance-id <integer>`,required:!0,description:`Provenance row surrogate id.`,schemaType:`integer`,schemaFormat:`int64`,location:`path`}]},{operationId:`resolve`,method:`GET`,path:`/v1/resolve/{token}`,resource:`resolve`,intent:`read`,cliPath:[`resolve`,`get`],summary:`Resolve any identifier to its owner`,description:`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.`,scope:`read`,auth:`read`,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:`Search entities, people, and news`,description:`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. Accepted values narrow per surface: entity and person natural-search take every value (`exact` is entity-only); news and federated search accept only `auto` and `keyword`; content search accepts only `auto`. Defaults to `auto`, which keeps the server-chosen pipeline; any other value forces exactly that strategy. 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. CLIENT_SECRET callers may only choose client-secret-eligible models; admin keys 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:`naturalSearchEntities`,method:`POST`,path:`/v1/entities/natural-search`,resource:`entities`,intent:`search`,cliPath:[`search`,`entities`],summary:`Find companies, startups, and investors with 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. CLI: search entities --query 'AI infrastructure companies founded since 2020' --size 3. The query accepts plain English; --size limits the page, --page starts at 0, and --year-founded-range-min 2020 imposes a hard founding-year constraint. Use --include-private false for publicly visible results and search entities --help for all available flags.`,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 status values.`,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. Accepted values narrow per surface: entity and person natural-search take every value (`exact` is entity-only); news and federated search accept only `auto` and `keyword`; content search accepts only `auto`. Defaults to `auto`, which keeps the server-chosen pipeline; any other value forces exactly that strategy. 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. CLIENT_SECRET callers may only choose client-secret-eligible models; admin keys 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:`Privileged admin readback scope. Includes hidden or off-sitemap entities. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,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:`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:`listNewsPost`,method:`POST`,path:`/v1/news`,resource:`news`,intent:`search`,cliPath:[`search`,`news`],summary:`Search news articles with a JSON filter body`,description:`List news articles from a JSON filter body; pagination and sort stay in query parameters.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/news/filter`,schemaName:`NewsFilterSchema`,kind:`json`,contentType:`application/json`,description:`Canonical news list/filter contract`,required:!1,requiredPath:[],parameter:[{name:`authorInitial`,optionKey:`authorInitial`,flag:`--author-initial <author-initial>`,required:!1,description:`Author initial filter.`,schemaType:`string`,location:`body`},{name:`category`,optionKey:`category`,flag:`--category <category>`,required:!1,description:`News category slug to include or exclude.`,schemaType:`string`,location:`body`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Cursor token returned by the previous thin page.`,schemaType:`string`,location:`body`},{name:`excludeId`,optionKey:`excludeId`,flag:`--exclude-id <integer>`,required:!1,description:`Exclude one news article by id.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`owner.entityId`,optionKey:`ownerEntityId`,flag:`--owner-entity-id <uuid>`,required:!1,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`body`},{name:`owner.personId`,optionKey:`ownerPersonId`,flag:`--owner-person-id <uuid>`,required:!1,description:`Canonical person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`body`},{name:`publishedAfter`,optionKey:`publishedAfter`,flag:`--published-after <date>`,required:!1,description:`Earliest publication date, inclusive.`,schemaType:`string`,schemaFormat:`date`,location:`body`},{name:`publishedBefore`,optionKey:`publishedBefore`,flag:`--published-before <date>`,required:!1,description:`Latest publication date, inclusive.`,schemaType:`string`,schemaFormat:`date`,location:`body`},{name:`search`,optionKey:`search`,flag:`--search <search>`,required:!1,description:`Full-text news search term.`,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`,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:`mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:"Search strategy. News supports `auto` and `keyword`; other canonical modes are rejected. Allowed values: auto, exact, keyword, semantic, natural.",schemaType:`string`,choices:[`auto`,`exact`,`keyword`,`semantic`,`natural`],location:`query`}]},{operationId:`naturalSearchPeople`,method:`POST`,path:`/v1/people/natural-search`,resource:`people`,intent:`search`,cliPath:[`search`,`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.`,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.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. Accepted values narrow per surface: entity and person natural-search take every value (`exact` is entity-only); news and federated search accept only `auto` and `keyword`; content search accepts only `auto`. Defaults to `auto`, which keeps the server-chosen pipeline; any other value forces exactly that strategy. 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. CLIENT_SECRET callers may only choose client-secret-eligible models; admin keys 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:`Privileged admin readback scope. Includes hidden or off-sitemap people. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,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:`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:`searchWeb`,method:`POST`,path:`/v1/search/web`,resource:`search`,intent:`search`,cliPath:[`search`,`web`],summary:`Search the live web`,description:`Runs a live web search through SerpAPI, returns a stored result when a fresh version exists, and durably records fresh results in the source-document store. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,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:`read`,auth:`read`,errorResponse:[],parameters:[]},{operationId:`listUrlTypes`,method:`GET`,path:`/v1/url-types`,resource:`url-types`,intent:`read`,cliPath:[`url-types`,`list`],summary:`List URL types`,description:`Returns canonical URL types and aliases accepted by entity and person URL rows.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[]},{operationId:`getAgentInstruction`,method:`GET`,path:`/v1/agents/instructions/{kind}/{name}`,resource:`agents`,intent:`read`,cliPath:[`agents`,`instructions`,`get`],summary:`Get one agent instruction document`,description:`Returns the current version and markdown content for one prompt, skill, or agent. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,scope:`read`,auth:`read`,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:`getAgentInstructionManifest`,method:`GET`,path:`/v1/agents/instructions/manifest`,resource:`agents`,intent:`read`,cliPath:[`agents`,`instructions`,`list`],summary:`Get the agent instruction manifest`,description:`Returns the latest-pointer manifest of versioned prompt and skill documents. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,scope:`read`,auth:`read`,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:`getCatalog`,method:`GET`,path:`/v1/classifications/catalog`,resource:`classifications`,intent:`read`,cliPath:[`classifications`,`catalog`,`get`],summary:`Fetch the entity 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 `classifications tags --type <bucket> --q <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:`read`,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 `classifications tags` with type and q filters instead of broad catalog JSON.",schemaType:`boolean`,location:`query`}]},{operationId:`searchClassifications`,method:`GET`,path:`/v1/classifications`,resource:`classifications`,intent:`read`,cliPath:[`classifications`,`search`,`get`],summary:`Search classifications`,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:`read`,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:`searchTags`,method:`GET`,path:`/v1/classifications/tags`,resource:`classifications`,intent:`read`,cliPath:[`classifications`,`tags`,`search`],summary:`Search entity classification tags`,description:"Returns a paginated list of active tags from the entity classification registry. Filter by bucket via `type` (any spelling listed on the corresponding ClassificationCatalogBucket — `type` plus its `alias[]`) and optionally by a name keyword via `q`. Results are ordered by bucket then by name; sorting is not supported — `sort` returns 422. Dormant registry tags are not returned by this read surface.",scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`type`,optionKey:`type`,flag:`--type <type>`,required:!1,description:"Classification bucket. Case- and punctuation-insensitive. Accepts the bucket wire value or any entry from its `alias[]` — discover both via GET /v1/classifications/catalog?includeTags=false.",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:`getAcquisition`,method:`GET`,path:`/v1/entities/{entityId}/acquisitions/{relationshipId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`acquisitions`,`get`],summary:`Get acquisition for an entity`,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:`listAcquisitions`,method:`GET`,path:`/v1/entities/{entityId}/acquisitions`,resource:`entities`,intent:`read`,cliPath:[`entities`,`acquisitions`,`list`],summary:`List acquisitions for an entity`,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 a single entity address join row`,description:`Returns the physical address group containing the selected entity address association.`,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:`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 entity addresses`,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).",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:`listEntitiesBatch`,method:`POST`,path:`/v1/entities/batch`,resource:`entities`,intent:`lookup`,cliPath:[`entities`,`batch`,`lookup`],summary:`Batch entity list`,description:`List entities with pagination or cursor continuation while preserving the raw page body. Rows use the EntityList projection: core, enrichment, list-safe research, and fundraise rounds without detail-only relationship, newsArticle, person, sitemap, or research snippet sections.`,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:!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 status values.`,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:[{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:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Permit monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Privileged read scope for admin callers. Bypasses the public visibility filter so hidden, unverified, and not-yet-published records are returned instead of being silently dropped. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,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`},{name:`includeFullDetail`,optionKey:`includeFullDetail`,flag:`--include-full-detail <true|false>`,required:!1,description:`Privileged read flag. Send the exact lowercase literal "true" to return the /v1/entities/detail payload, or "false" (or omit it) for the list payload. Any other spelling is rejected.`,schemaType:`boolean`,location:`query`}]},{operationId:`getEntityBlogPost`,method:`GET`,path:`/v1/entities/{entityId}/blog-posts/{blogPostId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`blog-posts`,`get`],summary:`Get entity blog post`,description:`Returns one entity-owned external link by id. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,scope:`read`,auth:`read`,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 entity 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:`getEntityById`,method:`GET`,path:`/v1/entities/{entityId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`by-id`,`get`],summary:`Get entity by ID`,description:`Returns entity detail by exact UUID. Use lookup for a slug, URL, or candidate signals.`,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 type-record 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:`Privileged admin readback scope. Includes hidden or off-sitemap entities and hidden research snippets. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,schemaType:`boolean`,location:`query`}]},{operationId:`getEntityClassifications`,method:`GET`,path:`/v1/entities/{entityId}/classifications`,resource:`entities`,intent:`read`,cliPath:[`entities`,`classifications`,`list`],summary:`Get entity classification joins`,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 (admin key or ROLE_ADMIN) also resolve hidden/private entities; includePrivate=true requires that authority, and a signed-in user without it is admitted for public entities but hidden entities 404.`,scope:`read`,auth:`read`,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:`Include private/hidden entity classification rows when the caller has private-visibility authority (admin key or ROLE_ADMIN). Without that authority hidden/private entities 404.`,schemaType:`boolean`,location:`query`}]},{operationId:`suggestEntityClassifications`,method:`GET`,path:`/v1/entities/{entityId}/classifications/suggestions`,resource:`entities`,intent:`read`,cliPath:[`entities`,`classifications`,`suggest`],summary:`Suggest entity classifications`,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 (admin key or ROLE_ADMIN) also resolve hidden/private entities, and includePrivate=true requires that authority, otherwise hidden/private entities 404.`,scope:`read`,auth:`read`,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:`Include private/hidden entity suggestions when the caller has private-visibility authority (admin key or ROLE_ADMIN). Without that authority hidden/private entities 404.`,schemaType:`boolean`,location:`query`}]},{operationId:`listEntityContent`,method:`GET`,path:`/v1/entities/{entityId}/content`,resource:`entities`,intent:`read`,cliPath:[`entities`,`content`,`list`],summary:`List entity content`,description:`Returns news articles, blog posts, repositories, websites, and pages related to an entity. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID whose content is 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:`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`},{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 entity content`,description:`Translates plain-English constraints for one entity's content index. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,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. Accepted values narrow per surface: entity and person natural-search take every value (`exact` is entity-only); news and federated search accept only `auto` and `keyword`; content search accepts only `auto`. Defaults to `auto`, which keeps the server-chosen pipeline; any other value forces exactly that strategy. 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. CLIENT_SECRET callers may only choose client-secret-eligible models; admin keys 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 content is 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:`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:`entityCountsByType`,method:`GET`,path:`/v1/entities/counts`,resource:`entities`,intent:`read`,cliPath:[`entities`,`counts`,`get`],summary:`Count entities by type`,description:`Return total visible entity count for each entity type`,scope:`read`,auth:`none`,errorResponse:[],parameters:[]},{operationId:`entityFilters`,method:`GET`,path:`/v1/entities/filters`,resource:`entities`,intent:`read`,cliPath:[`entities`,`filters`,`list`],summary:`List entity 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.`,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:`getEntityUniqueId`,method:`GET`,path:`/v1/entities/{entityId}/unique-ids/{uniqueIdId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`identifiers`,`get`],summary:`Get an entity identifier`,description:`Returns one external identifier mapping after verifying it belongs to the path owner.`,scope:`read`,auth:`read`,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`,`identifiers`,`list`],summary:`List entity 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:`read`,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:`lookupUniqueId`,method:`GET`,path:`/v1/unique-ids/lookup`,resource:`unique-ids`,intent:`read`,cliPath:[`entities`,`identifiers`,`lookup`],cliAliasPath:[`people`,`identifiers`,`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:`read`,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:`postEntityDetailResolve`,method:`POST`,path:`/v1/entities/detail/resolve`,resource:`entities`,intent:`lookup`,cliPath:[`entities`,`identifiers`,`resolve`],summary:`Resolve entity identifiers (deprecated detail path)`,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).`,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:`Privileged read scope for admin callers. Returns hidden, unverified, and not-yet-published entities instead of resolving them as MISSING. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,schemaType:`boolean`,location:`query`}]},{operationId:`lookupEntityBatch`,method:`POST`,path:`/v1/entities/lookup/batch`,resource:`entities`,intent:`lookup`,cliPath:[`entities`,`lookup`,`batch`],summary:`Batch entity lookup`,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.`,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:`Privileged read scope for admin callers. Bypasses the public visibility filter so hidden, unverified, and not-yet-published entities are returned instead of being silently dropped. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,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:`listEntityNews`,method:`GET`,path:`/v1/entities/detail/news`,resource:`entities`,intent:`read`,cliPath:[`entities`,`news`,`list`],summary:`List news joined to an entity`,description:`Returns news joined to the entity directly or via its public products/services; mutations require a direct join. Fixed sort (publishedAt DESC); page/size only.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`id`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!1,description:`Owner-scoped resource UUID selector.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`slug`,optionKey:`entitySlug`,flag:`--entity-slug <entity-slug>`,required:!1,description:`Owner-scoped resource slug selector.`,schemaType:`string`,location:`query`},{name:`search`,optionKey:`search`,flag:`--search <search>`,required:!1,description:`Full-text search query.`,schemaType:`string`,location:`query`},{name:`category`,optionKey:`category`,flag:`--category <category>`,required:!1,description:`Category include/exclude CSV.`,schemaType:`string`,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`,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:`getEntityPeopleAssociation`,method:`GET`,path:`/v1/entities/{entityId}/people/{associationId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`people`,`get`],summary:`Get entity people association`,description:`Returns one entity-scoped association detail. Public and client-secret reads hide associations to hidden entities; trusted admin credentials can read them back.`,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:`id`,optionKey:`recordId`,flag:`--record-id <uuid>`,required:!1,description:`Entity unique identifier (UUID) — at least one of id or slug required.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`slug`,optionKey:`recordSlug`,flag:`--record-slug <record-slug>`,required:!1,description:`Entity URL-friendly identifier — at least one of id or slug required.`,schemaType:`string`,location:`query`},{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:`Association role filter.`,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:`Privileged read scope. Includes associations on hidden entities. Defaults to private visibility for admin API key or ROLE_ADMIN callers; explicit true requires that authority.`,schemaType:`boolean`,location:`query`}]},{operationId:`listEntityPeopleAssociations`,method:`GET`,path:`/v1/entities/{entityId}/people`,resource:`entities`,intent:`read`,cliPath:[`entities`,`people`,`list`],summary:`List entity people associations`,description:`Returns people associated with one entity. Public and client-secret reads exclude hidden entities; trusted admin credentials include them for write readback.`,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:`id`,optionKey:`recordId`,flag:`--record-id <uuid>`,required:!1,description:`Entity unique identifier (UUID) — at least one of id or slug required.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`slug`,optionKey:`recordSlug`,flag:`--record-slug <record-slug>`,required:!1,description:`Entity URL-friendly identifier — at least one of id or slug required.`,schemaType:`string`,location:`query`},{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:`Association role filter.`,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:`Privileged read scope. Includes associations on hidden entities. Defaults to private visibility for admin API key or ROLE_ADMIN callers; explicit true requires that 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:`suggestProducts`,method:`GET`,path:`/v1/entities/{entityId}/products/suggestions`,resource:`entities`,intent:`read`,cliPath:[`entities`,`products`,`suggest`],summary:`Suggest entity products or services`,description:`Semantic suggestions for this slot only. NOT a completeness signal. Each candidate is a hypothesis — verify with web search before writing. exhaustive is always false. See coverage for the remaining details and the owning read that proves each.`,scope:`read`,auth:`read`,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:`Whether to include private completion coverage when the caller has private-visibility authority.`,schemaType:`boolean`,location:`query`}]},{operationId:`listEntityRelationships`,method:`GET`,path:`/v1/entities/{entityId}/relationships`,resource:`entities`,intent:`read`,cliPath:[`entities`,`relationships`,`list`],summary:`List entity 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 row 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 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:`suggestRelationships`,method:`GET`,path:`/v1/entities/{entityId}/relationships/suggestions`,resource:`entities`,intent:`read`,cliPath:[`entities`,`relationships`,`suggest`],summary:`Suggest entity relationships`,description:`Semantic suggestions for this slot only. NOT a completeness signal. Each candidate is a hypothesis — verify with web search before writing. exhaustive is always false. See coverage for the remaining details and the owning read that proves each.`,scope:`read`,auth:`read`,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:`Whether to include private completion coverage when the caller has private-visibility authority.`,schemaType:`boolean`,location:`query`}]},{operationId:`listEntityRepositories`,method:`GET`,path:`/v1/entities/{entityId}/repositories`,resource:`entities`,intent:`read`,cliPath:[`entities`,`repositories`,`list`],summary:`List entity repositories`,description:`Returns the entity's synced GitHub repositories, paged. Default sort is stargazerCount desc, then name.`,scope:`read`,auth:`read`,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:`Entity research projection`,description:`Returns the consolidated research projection for an entity. Use includePrivate to include hidden research snippets and off-sitemap entities.`,scope:`read`,auth:`read`,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:`Include hidden research snippets (visible=false) and off-sitemap entities.`,schemaType:`boolean`,location:`query`}]},{operationId:`listSimilarEntitiesByEntityId`,method:`GET`,path:`/v1/entities/{entityId}/similar`,resource:`entities`,intent:`read`,cliPath:[`entities`,`similar`,`get`],summary:`List entities similar to one entity by UUID`,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.`,scope:`read`,auth:`read`,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:`listSimilarEntities`,method:`GET`,path:`/v1/entities/detail/similar`,resource:`entities`,intent:`read`,cliPath:[`entities`,`similar`,`list`],summary:`List entities similar to one entity`,description:`Requires one entity identity: id or slug (CLI: --entity-id or --entity-slug). Neither is individually required, but the request fails without one of them; id wins when both are sent. Returns similar entities by id or slug. Results include the entity list row and per-row similarity provenance; load full detail through the entity detail endpoints. Results are ordered by similarity score (highest first). Use relationshipType to filter by specific stored relationships (e.g., competitor). This endpoint does not support custom sorting.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`id`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!1,description:`Entity unique identifier (UUID) — at least one of id or slug required.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`slug`,optionKey:`entitySlug`,flag:`--entity-slug <entity-slug>`,required:!1,description:`Entity URL-friendly identifier (slug) — at least one of id or slug required.`,schemaType:`string`,location:`query`},{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 entity slug`,description:`Returns the current slug, canonical path, and public URL. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listEntitySummaries`,method:`GET`,path:`/v1/entities/summary`,resource:`entities`,intent:`read`,cliPath:[`entities`,`summary`,`list`],summary:`List entity summaries`,description:`List lean entity rows for homepage and card surfaces. Returns core identity, funding rollup, and fundraise rounds while omitting heavier list enrichment, research, address, text, classification, and URL sections.`,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:`recordSlug`,flag:`--record-slug <record-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:`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 status values.`,schemaType:`array`,itemSchemaType:`string`,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:`letter`,optionKey:`letter`,flag:`--letter <letter>`,required:!1,description:`First letter of the display name.`,schemaType:`string`,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:`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:`getEntityText`,method:`GET`,path:`/v1/entities/{entityId}/texts/{textId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`texts`,`get`],summary:`Get one entity text row`,description:`Returns one entity-owned text row by id. Requires read auth.`,scope:`read`,auth:`read`,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.`,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 entity text rows`,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.`,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:`Get trending news for an entity`,description:`Returns trending news semantically related to an entity.`,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:`getTypeRecord`,method:`GET`,path:`/v1/entities/{entityId}/type-record`,resource:`entities`,intent:`read`,cliPath:[`entities`,`type-record`,`get`],summary:`Get entity typeRecord`,description:`Returns the current canonical EntityType for an existing entity.`,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`}]},{operationId:`getEntityUrl`,method:`GET`,path:`/v1/entities/{entityId}/urls/{urlId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`urls`,`get`],summary:`Get one entity URL`,description:`Returns one entity-owned URL row by id. Requires read auth.`,scope:`read`,auth:`read`,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 entity 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:`getValuationTimeSeries`,method:`GET`,path:`/v1/entities/{entityId}/valuations`,resource:`entities`,intent:`read`,cliPath:[`entities`,`valuations`,`list`],summary:`Entity valuation time series`,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:`getById`,method:`GET`,path:`/v1/media/screenshots/{screenshotId}`,resource:`media`,intent:`read`,cliPath:[`media`,`screenshots`,`get`],summary:`Get screenshot by id`,description:`Returns a single screenshot metadata record by its surrogate id. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`screenshotId`,optionKey:`screenshotId`,flag:`--screenshot-id <integer>`,required:!0,description:`Screenshot surrogate id from the crawl_screenshot table.`,schemaType:`integer`,schemaFormat:`int64`,location:`path`}]},{operationId:`listByUrl`,method:`GET`,path:`/v1/media/screenshots`,resource:`media`,intent:`read`,cliPath:[`media`,`screenshots`,`list`],summary:`List screenshots for a URL`,description:`Returns paginated screenshot metadata for the given URL, newest crawl first. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`url`,optionKey:`url`,flag:`--url <url>`,required:!0,description:`Page URL whose crawl screenshots should be listed (encoded query value).`,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:`20`,location:`query`}]},{operationId:`getNewsById`,method:`GET`,path:`/v1/news/{newsId}`,resource:`news`,intent:`read`,cliPath:[`news`,`by-id`,`get`],summary:`Get news article by ID`,description:`Returns news detail by exact positive ID. Use lookup for a slug, external ID, URL, or title candidates.`,scope:`read`,auth:`read`,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:`submitFeedback`,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:`write`,errorResponse:[],parameters:[]},{operationId:`listRecentNews`,method:`GET`,path:`/v1/news/recent`,resource:`news`,intent:`read`,cliPath:[`news`,`recent`,`list`],summary:`List recent news`,description:`Returns recent news articles.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`category`,optionKey:`category`,flag:`--category <category>`,required:!1,description:`Optional category slug to filter recent news.`,schemaType:`string`,location:`query`},{name:`excludeId`,optionKey:`excludeId`,flag:`--exclude-id <integer>`,required:!1,description:`News id to exclude from results (typically the article currently in view).`,schemaType:`integer`,schemaFormat:`int32`,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:`12`,location:`query`}]},{operationId:`relatedCompanies`,method:`GET`,path:`/v1/news/{newsId}/related-companies`,resource:`news`,intent:`read`,cliPath:[`news`,`related-companies`,`get`],summary:`Get related companies for a news article`,description:`Returns companies 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:`listSimilarNews`,method:`GET`,path:`/v1/news/similar`,resource:`news`,intent:`read`,cliPath:[`news`,`similar`,`list`],summary:`Find similar news`,description:`Returns news articles similar to the article specified by exactly one id or slug. When similarity stages return nothing, falls back to recent articles excluding the target. The similarity embedding model is pinned to qwen-4b-fp16; embeddingModel, when provided, must equal qwen-4b-fp16. Source: https://huggingface.co/Qwen/Qwen3-Embedding-4B-GGUF?show_file_info=Qwen3-Embedding-4B-f16.gguf.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`id`,optionKey:`newsId`,flag:`--news-id <integer>`,required:!1,description:"News article id — exactly one of `id` or `slug` is required.",schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`slug`,optionKey:`newsSlug`,flag:`--news-slug <news-slug>`,required:!1,description:"News article slug — exactly one of `id` or `slug` is required.",schemaType:`string`,location:`query`},{name:`embeddingModel`,optionKey:`embeddingModel`,flag:`--embedding-model <embedding-model>`,required:!1,description:`Pinned similarity embedding model. Allowed values: qwen-4b-fp16.`,schemaType:`string`,choices:[`qwen-4b-fp16`],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:`4`,location:`query`}]},{operationId:`getAddress`,method:`GET`,path:`/v1/people/{personId}/addresses/{addressJoinId}`,resource:`people`,intent:`read`,cliPath:[`people`,`addresses`,`get`],summary:`Get person 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:`listAddresses`,method:`GET`,path:`/v1/people/{personId}/addresses`,resource:`people`,intent:`read`,cliPath:[`people`,`addresses`,`list`],summary:`List person 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:`listPeopleBatch`,method:`POST`,path:`/v1/people/batch`,resource:`people`,intent:`lookup`,cliPath:[`people`,`batch`,`lookup`],summary:`Batch person list`,description:`List people with Spring pageable request params and a typed PersonFilter body. Use projection=association to include bounded association detail rows while preserving the raw page body and cursor semantics.`,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:`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:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Cursor for pagination (format: timestamp::uuid). Omit when search is present; use page pagination for relevance-ranked results.`,schemaType:`string`,location:`query`},{name:`maxAssociations`,optionKey:`maxAssociations`,flag:`--max-associations <integer>`,required:!1,description:`Max association values per person.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`hasImageFirst`,optionKey:`hasImageFirst`,flag:`--has-image-first <true|false>`,required:!1,description:`Prioritize people with images before the default sort.`,schemaType:`boolean`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram <true|false>`,required:!1,description:`Permit monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`includePrivate`,optionKey:`includePrivate`,flag:`--include-private <true|false>`,required:!1,description:`Include private fields. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,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`},{name:`projection`,optionKey:`projection`,flag:`--projection <projection>`,required:!1,description:`Batch projection mode. Omit or use core for Person rows; association returns PersonDetail rows with bounded associations. Allowed values: core, association.`,schemaType:`string`,choices:[`core`,`association`],location:`query`}]},{operationId:`getPersonBlogPost`,method:`GET`,path:`/v1/people/{personId}/blog-posts/{blogPostId}`,resource:`people`,intent:`read`,cliPath:[`people`,`blog-posts`,`get`],summary:`Get person blog post`,description:`Returns one person-owned external link by id. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,scope:`read`,auth:`read`,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 person 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:`getPersonById`,method:`GET`,path:`/v1/people/{personId}`,resource:`people`,intent:`read`,cliPath:[`people`,`by-id`,`get`],summary:`Get person by ID`,description:`Returns person detail by exact UUID. Use lookup for a slug, URL, or candidate signals.`,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:`Privileged admin readback scope. Includes hidden or off-sitemap people and privileged private fields. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,schemaType:`boolean`,location:`query`}]},{operationId:`listPersonContent`,method:`GET`,path:`/v1/people/{personId}/content`,resource:`people`,intent:`read`,cliPath:[`people`,`content`,`list`],summary:`List person content`,description:`Returns news articles, blog posts, repositories, websites, and pages related to a person. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID whose content is 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:`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`},{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 person content`,description:`Translates plain-English constraints for one person's content index. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,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. Accepted values narrow per surface: entity and person natural-search take every value (`exact` is entity-only); news and federated search accept only `auto` and `keyword`; content search accepts only `auto`. Defaults to `auto`, which keeps the server-chosen pipeline; any other value forces exactly that strategy. 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. CLIENT_SECRET callers may only choose client-secret-eligible models; admin keys 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 content is 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:`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:`getPersonEntityAssociation`,method:`GET`,path:`/v1/people/{personId}/entities/{associationId}`,resource:`people`,intent:`read`,cliPath:[`people`,`entities`,`get`],summary:`Get person entity association`,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:`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:`Include hidden people and entity associations. Defaults false; true requires an admin API key or ROLE_ADMIN.`,schemaType:`boolean`,location:`query`}]},{operationId:`listPersonEntityAssociations`,method:`GET`,path:`/v1/people/{personId}/entities`,resource:`people`,intent:`read`,cliPath:[`people`,`entities`,`list`],summary:`List person entity associations`,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:`Include hidden people and entity associations. Defaults false; true requires an admin API key or ROLE_ADMIN.`,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:`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:`filters`,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:`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:`getPersonUniqueId`,method:`GET`,path:`/v1/people/{personId}/unique-ids/{uniqueIdId}`,resource:`people`,intent:`read`,cliPath:[`people`,`identifiers`,`get`],summary:`Get a person identifier`,description:`Returns one external identifier mapping after verifying it belongs to the path owner.`,scope:`read`,auth:`read`,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`,`identifiers`,`list`],summary:`List person 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:`read`,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:`getPersonInvestments`,method:`GET`,path:`/v1/people/detail/investments`,resource:`people`,intent:`read`,cliPath:[`people`,`investments`,`list`],summary:`Get person investments`,description:`Returns a paginated investment portfolio for a person by id or slug 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 or --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:`id`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!1,description:`Person unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`slug`,optionKey:`personSlug`,flag:`--person-slug <person-slug>`,required:!1,description:`Person URL-friendly identifier (slug).`,schemaType:`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`,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/detail/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 id or slug. Use --id or --slug for 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:`id`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!1,description:`Person unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`slug`,optionKey:`personSlug`,flag:`--person-slug <person-slug>`,required:!1,description:`Person URL-friendly identifier (slug).`,schemaType:`string`,location:`query`}]},{operationId:`lookupPersonBatch`,method:`POST`,path:`/v1/people/lookup/batch`,resource:`people`,intent:`lookup`,cliPath:[`people`,`lookup`,`batch`],summary:`Batch person lookup`,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.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/person/detail-batch`,schemaName:`PersonDetailBatchSchema`,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:`Include private fields. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,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:`listPersonNews`,method:`GET`,path:`/v1/people/detail/news`,resource:`people`,intent:`read`,cliPath:[`people`,`news`,`list`],summary:`List news joined to a person`,description:`Returns news articles linked to a person. Uses fixed sort (publishedAt DESC). Sorting is not supported; use page/size params only.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`id`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!1,description:`Owner-scoped resource UUID selector.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`slug`,optionKey:`personSlug`,flag:`--person-slug <person-slug>`,required:!1,description:`Owner-scoped resource slug selector.`,schemaType:`string`,location:`query`},{name:`search`,optionKey:`search`,flag:`--search <search>`,required:!1,description:`Full-text search query.`,schemaType:`string`,location:`query`},{name:`category`,optionKey:`category`,flag:`--category <category>`,required:!1,description:`Category include/exclude CSV.`,schemaType:`string`,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`,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:`listPersonRepositories`,method:`GET`,path:`/v1/people/{personId}/repositories`,resource:`people`,intent:`read`,cliPath:[`people`,`repositories`,`list`],summary:`List person repositories`,description:`Returns the person's synced GitHub repositories, paged. Default sort is stargazerCount desc, then name.`,scope:`read`,auth:`read`,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:`listSimilarPeople`,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.`,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:`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 person text row`,description:`Returns one person-owned text row by id. Requires read auth.`,scope:`read`,auth:`read`,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 person text rows`,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:`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:`read`,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:`getHistory`,method:`GET`,path:`/v1/provenance/history`,resource:`provenance`,intent:`read`,cliPath:[`provenance`,`history`,`list`],summary:`Provenance history for a record`,description:`Returns paginated field-level provenance rows ordered by effectiveAt DESC. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`tableName`,optionKey:`tableName`,flag:`--table-name <table-name>`,required:!0,description:"Tracked resource. Canonical form is the camelCase wire token (e.g. `entity`, `newsArticle`); the legacy Postgres table name (`res_entity`) is still accepted for backwards compatibility. Allowed values: entity, person, newsArticle, entityPersonJoin, newsArticleEntityJoin, newsArticlePersonJoin, entityRelationship, entityTypeJoin, entityAddressJoin, entityClassificationJoin, entityDetail, entityResearchSnippets, personAddressJoin, fundraiseTransaction, fundraiseTransactionInvestorJoin, text, urlLink, deployTarget.",schemaType:`string`,choices:[`entity`,`person`,`newsArticle`,`entityPersonJoin`,`newsArticleEntityJoin`,`newsArticlePersonJoin`,`entityRelationship`,`entityTypeJoin`,`entityAddressJoin`,`entityClassificationJoin`,`entityDetail`,`entityResearchSnippets`,`personAddressJoin`,`fundraiseTransaction`,`fundraiseTransactionInvestorJoin`,`text`,`urlLink`,`deployTarget`],location:`query`},{name:`recordId`,optionKey:`recordId`,flag:`--record-id <record-id>`,required:!1,description:`Record key of the tracked row (text).`,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:`getLatestSource`,method:`GET`,path:`/v1/provenance/latest`,resource:`provenance`,intent:`read`,cliPath:[`provenance`,`latest`,`get`],summary:`Latest data source for a record`,description:`Returns the most recent provenance row for a tracked record. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`tableName`,optionKey:`tableName`,flag:`--table-name <table-name>`,required:!0,description:"Tracked resource. Canonical form is the camelCase wire token (e.g. `entity`, `newsArticle`); the legacy Postgres table name (`res_entity`) is still accepted for backwards compatibility. Allowed values: entity, person, newsArticle, entityPersonJoin, newsArticleEntityJoin, newsArticlePersonJoin, entityRelationship, entityTypeJoin, entityAddressJoin, entityClassificationJoin, entityDetail, entityResearchSnippets, personAddressJoin, fundraiseTransaction, fundraiseTransactionInvestorJoin, text, urlLink, deployTarget.",schemaType:`string`,choices:[`entity`,`person`,`newsArticle`,`entityPersonJoin`,`newsArticleEntityJoin`,`newsArticlePersonJoin`,`entityRelationship`,`entityTypeJoin`,`entityAddressJoin`,`entityClassificationJoin`,`entityDetail`,`entityResearchSnippets`,`personAddressJoin`,`fundraiseTransaction`,`fundraiseTransactionInvestorJoin`,`text`,`urlLink`,`deployTarget`],location:`query`},{name:`recordId`,optionKey:`recordId`,flag:`--record-id <record-id>`,required:!1,description:`Record key of the tracked row (text).`,schemaType:`string`,location:`query`}]},{operationId:`searchLink`,method:`GET`,path:`/v1/search/link`,resource:`search`,intent:`read`,cliPath:[`search`,`link`,`get`],summary:`Search from a shared article or 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 503, never an empty result. For direct URL-to-record identity resolution use the entities lookup operation (GET /v1/entities/lookup?url=...) instead.`,scope:`read`,auth:`none`,errorResponse:[],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:`previewCompany`,method:`GET`,path:`/v1/sec/company`,resource:`sec`,intent:`read`,cliPath:[`sec`,`company`,`get`],summary:`Preview a public company from SEC EDGAR`,description:`Resolves a publicly traded US company by ticker (preferred) or company-name query and 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:`read`,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:`getAgentInstructionVersion`,method:`GET`,path:`/v1/agents/instructions/{kind}/{name}/versions/{version}`,resource:`agents`,intent:`read`,cliPath:[`agents`,`instructions`,`versions`,`get`],summary:`Get one agent instruction document version`,description:`Returns an immutable prompt, skill, or agent document by name and version. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,scope:`read`,auth:`read`,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:`version`,flag:`--version <version>`,required:!0,description:`Immutable content version.`,schemaType:`string`,location:`path`}]},{operationId:`postEntityDetailBatch`,method:`POST`,path:`/v1/entities/detail/batch`,resource:`entities`,intent:`lookup`,cliPath:[`entities`,`batch`,`detail`,`lookup`],summary:`Batch entity detail retrieval (POST)`,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.`,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:`Privileged read scope for admin callers. Bypasses the public visibility filter so hidden, unverified, and not-yet-published entities are returned instead of being silently dropped. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,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:`listEntityFilterCounts`,method:`GET`,path:`/v1/entities/filters/counts`,resource:`entities`,intent:`read`,cliPath:[`entities`,`filters`,`counts`,`list`],summary:`List entity filter tag counts`,description:`Return tag counts for entities by repeated name query parameters`,scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record>`,required:!1,description:`Entity type (Company, Investment Firm, etc.).`,schemaType:`string`,location:`query`},{name:`name`,optionKey:`name`,flag:`--name <name...>`,required:!1,description:`Tag name values to filter counts.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`Maximum number of results.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`minCount`,optionKey:`minCount`,flag:`--min-count <integer>`,required:!1,description:`Minimum count threshold.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`}]},{operationId:`entityFilterCounts`,method:`POST`,path:`/v1/entities/filters/counts`,resource:`entities`,intent:`lookup`,cliPath:[`entities`,`filters`,`counts`,`lookup`],summary:`Count entity filter tags`,description:`Return tag counts for entities by name`,requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/filter-count`,schemaName:`EntityFilterCountSchema`,kind:`json`,contentType:`application/json`,description:`Entity filter tag count criteria`,required:!1,requiredPath:[`name`],parameter:[{name:`minCount`,optionKey:`minCount`,flag:`--min-count <integer>`,required:!1,description:`Minimum count threshold.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`name`,optionKey:`name`,flag:`--name <name...>`,required:!0,description:`Tag name values to filter counts.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`Maximum number of results.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record>`,required:!1,description:`Entity type (Company, Investment Firm, etc.).`,schemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],parameters:[]},{operationId:`entityFiltersRefined`,method:`POST`,path:`/v1/entities/filters/refine`,resource:`entities`,intent:`lookup`,cliPath:[`entities`,`filters`,`refine`,`lookup`],summary:`Refine entity 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 status values.`,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:`entityFilterSearch`,method:`GET`,path:`/v1/entities/filters/search`,resource:`entities`,intent:`read`,cliPath:[`entities`,`filters`,`search`,`get`],summary:`Search filter options`,description:`Live search within filter values. Use filterKey to choose a filter, search to match values, and typeRecord to scope the eligible entity universe.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`filterKey`,optionKey:`filterKey`,flag:`--filter-key <filter-key>`,required:!0,description:`Filter key to search in (e.g. industry, tag).`,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`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record>`,required:!1,description:`Filter by entity type.`,schemaType:`string`,location:`query`}]},{operationId:`entityFilterSearchScoped`,method:`POST`,path:`/v1/entities/filters/search`,resource:`entities`,intent:`lookup`,cliPath:[`entities`,`filters`,`search`,`lookup`],summary:`Search filter options (scoped)`,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 status values.`,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:`entityInvestments`,method:`GET`,path:`/v1/entities/{entityId}/investments`,resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise`,`investments`,`list`],summary:`List investments made by an entity`,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 or --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:`Privileged private readback scope. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret frontend reads stay public.`,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:`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:`investorActivity`,method:`GET`,path:`/v1/entities/{entityId}/investor-activity`,resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise`,`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:`getFundraiseInvestorJoin`,method:`GET`,path:`/v1/entities/detail/fundraise-investor-joins/{joinId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise`,`investor-joins`,`get`],summary:`Get fundraise investor join`,description:`Gets one entity or person investor join by join id.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`id`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!1,description:`Owner-scoped resource UUID selector.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`slug`,optionKey:`entitySlug`,flag:`--entity-slug <entity-slug>`,required:!1,description:`Owner-scoped resource slug selector.`,schemaType:`string`,location:`query`},{name:`joinId`,optionKey:`fundraiseInvestorJoinId`,flag:`--fundraise-investor-join-id <uuid>`,required:!0,description:`Fundraise investor join identifier.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listFundraiseInvestorJoins`,method:`GET`,path:`/v1/entities/detail/fundraise-investor-joins`,resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise`,`investor-joins`,`list`],summary:`List fundraise investor joins`,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. API and MCP request bodies use JSON numbers such as 220000 or 123456.78; CLI callers use --amount-invested 220000 or --amount-invested 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 --entity-id or --entity-slug 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 --investor-entity-id or --investor-entity-slug. 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/detail, then create the join.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`id`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!1,description:`Owner-scoped resource UUID selector.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`slug`,optionKey:`entitySlug`,flag:`--entity-slug <entity-slug>`,required:!1,description:`Owner-scoped resource slug selector.`,schemaType:`string`,location:`query`},{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/detail.`,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/detail.`,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:`entityInvestors`,method:`GET`,path:`/v1/entities/{entityId}/investors`,resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise`,`investors`,`list`],summary:`List entity 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 or --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:`Privileged private readback scope. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret frontend reads stay public.`,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:`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:`entityPersonInvestors`,method:`GET`,path:`/v1/entities/{entityId}/person-investors`,resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise`,`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 or --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:`Privileged private readback scope. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret frontend reads stay public.`,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:`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:`getFundraiseTransaction`,method:`GET`,path:`/v1/entities/{entityId}/fundraise-rounds/{fundraiseRoundId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise`,`rounds`,`get`],summary:`Get fundraise 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:`entityFundraises`,method:`GET`,path:`/v1/entities/{entityId}/fundraise-rounds`,resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise`,`rounds`,`list`],summary:`List fundraise 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:`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:`uniqueIdTypes`,method:`GET`,path:`/v1/unique-ids/types`,resource:`unique-ids`,intent:`read`,cliPath:[`entities`,`identifiers`,`types`,`get`],cliAliasPath:[`people`,`identifiers`,`types`,`get`],summary:`List 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:`lookupEntityMatches`,method:`POST`,path:`/v1/entities/lookup/matches`,resource:`entities`,intent:`lookup`,cliPath:[`entities`,`lookup`,`matches`,`lookup`],summary:`Resolve entity identifiers (POST)`,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).`,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:`Privileged read scope for admin callers. Returns hidden, unverified, and not-yet-published entities instead of resolving them as MISSING. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,schemaType:`boolean`,location:`query`}]},{operationId:`getEntityMedia`,method:`GET`,path:`/v1/entities/{entityId}/media/logo`,resource:`entities`,intent:`read`,cliPath:[`entities`,`media`,`logo`,`get`],summary:`Get entity logo`,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:`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:`trendingNews`,method:`GET`,path:`/v1/entities/detail/trending-news`,resource:`entities`,intent:`read`,cliPath:[`entities`,`news`,`trending`,`list`],summary:`Get trending news for an entity (deprecated detail path)`,description:`Returns trending news semantically related to an entity.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`id`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!1,description:`Entity unique identifier (UUID) — at least one of id or slug required.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`slug`,optionKey:`entitySlug`,flag:`--entity-slug <entity-slug>`,required:!1,description:`Entity URL-friendly identifier (slug) — at least one of id or slug required.`,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:`10`,location:`query`}]},{operationId:`getEmployeeCountTimeSeries`,method:`GET`,path:`/v1/entities/{entityId}/people/time-series`,resource:`entities`,intent:`read`,cliPath:[`entities`,`people`,`employee-counts`,`list`],summary:`Entity employee count time series`,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:`getRelationship`,method:`GET`,path:`/v1/entities/relationships/{relationshipId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`relationships`,`row`,`get`],summary:`Get relationship row 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:`listRelationshipTypes`,method:`GET`,path:`/v1/entities/relationships/types`,resource:`entities`,intent:`read`,cliPath:[`entities`,`relationships`,`types`,`list`],summary:`List relationship types`,description:`Returns canonical EntityRelationshipType values, aliases, and policy flags. Use joinable=true values with entities relationships join; 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:`getResearchDetail`,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:`read`,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:`listResearchDetails`,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:`read`,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 filter.`,schemaType:`string`,location:`query`}]},{operationId:`getResearchSnippet`,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:`read`,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:`listResearchSnippets`,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:`read`,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:`listEntityRedirects`,method:`GET`,path:`/v1/entities/{entityId}/slug/redirects`,resource:`entities`,intent:`read`,cliPath:[`entities`,`slug`,`redirects`,`list`],summary:`List entity slug redirects`,description:`Lists redirects whose newUrl targets the record's current public URL. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`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:`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:`entityTextTypes`,method:`GET`,path:`/v1/entities/texts/types`,resource:`entities`,intent:`read`,cliPath:[`entities`,`texts`,`types`,`list`],summary:`List entity 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.`,schemaType:`boolean`,defaultValue:!1,location:`query`}]},{operationId:`entityTypes`,method:`GET`,path:`/v1/entities/types`,resource:`entities`,intent:`read`,cliPath:[`entities`,`type-record`,`types`,`list`],summary:`List writable entity typeRecords with accepted alias tokens`,description:`Returns typeRecord alias guidance for API help and CLI command suggestions.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[]},{operationId:`listAllEntityUrls`,method:`GET`,path:`/v1/entities/{entityId}/urls/all`,resource:`entities`,intent:`read`,cliPath:[`entities`,`urls`,`all`,`list`],summary:`List all entity URLs`,description:`Returns paged active and inactive URL rows owned by an entity.`,scope:`read`,auth:`read`,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:`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:`urlSurfaceMisclassifications`,method:`GET`,path:`/v1/entities/urls/surface-misclassifications`,resource:`entities`,intent:`read`,cliPath:[`entities`,`urls`,`surface-misclassifications`,`list`],summary:`List URL surface misclassification rules`,description:`Returns URL shapes whose attempted write surface is deterministically wrong. Consumers route these before writing; news/press articles belong on News.newsUrlOriginal via news create, not EntityUrl.urlType=website.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[]},{operationId:`entityUrlTypes`,method:`GET`,path:`/v1/entities/urls/types`,resource:`entities`,intent:`read`,cliPath:[`entities`,`urls`,`types`,`list`],summary:`List entity URL types`,description:`Returns canonical URL types and aliases accepted by entity URL rows.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[]},{operationId:`getNewsMedia`,method:`GET`,path:`/v1/news/{newsId}/media/thumbnail`,resource:`news`,intent:`read`,cliPath:[`news`,`media`,`thumbnail`,`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`}]},{operationId:`listNewsRedirects`,method:`GET`,path:`/v1/news/{newsId}/slug/redirects`,resource:`news`,intent:`read`,cliPath:[`news`,`slug`,`redirects`,`list`],summary:`List news slug redirects`,description:`Lists redirects whose newUrl targets the record's current public URL. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`newsId`,optionKey:`newsId`,flag:`--news-id <integer>`,required:!0,description:`News article id.`,schemaType:`integer`,schemaFormat:`int32`,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:`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:`getPersonDetailBatch`,method:`POST`,path:`/v1/people/detail/batch`,resource:`people`,intent:`lookup`,cliPath:[`people`,`batch`,`detail`,`lookup`],summary:`Batch person detail enrichment`,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.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/person/detail-batch`,schemaName:`PersonDetailBatchSchema`,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:`Include private fields. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.`,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:`listPersonBlogPostsBySlug`,method:`GET`,path:`/v1/people/{slug}/blog-posts`,resource:`people`,intent:`read`,cliPath:[`people`,`by-slug`,`blog-posts`,`list`],summary:`List person blog posts by slug`,description:`Returns active external links for a person by slug.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[{name:`slug`,optionKey:`personSlug`,flag:`--person-slug <person-slug>`,required:!0,description:`Person URL-friendly identifier.`,schemaType:`string`,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:`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:`filterSearch`,method:`GET`,path:`/v1/people/filters/search`,resource:`people`,intent:`read`,cliPath:[`people`,`filters`,`search`,`get`],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:`getPersonMedia`,method:`GET`,path:`/v1/people/{personId}/media/photo`,resource:`people`,intent:`read`,cliPath:[`people`,`media`,`photo`,`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`}]},{operationId:`listPersonRedirects`,method:`GET`,path:`/v1/people/{personId}/slug/redirects`,resource:`people`,intent:`read`,cliPath:[`people`,`slug`,`redirects`,`list`],summary:`List person slug redirects`,description:`Lists redirects whose newUrl targets the record's current public URL. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.`,scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`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:`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:`personTextTypes`,method:`GET`,path:`/v1/people/texts/types`,resource:`people`,intent:`read`,cliPath:[`people`,`texts`,`types`,`list`],summary:`List person text types`,description:`Returns text type values accepted by person text rows.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[]},{operationId:`listAllPersonUrls`,method:`GET`,path:`/v1/people/{personId}/urls/all`,resource:`people`,intent:`read`,cliPath:[`people`,`urls`,`all`,`list`],summary:`List all person URLs`,description:`Returns paged active and inactive URL rows owned by a person.`,scope:`read`,auth:`read`,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:`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:`personUrlTypes`,method:`GET`,path:`/v1/people/urls/types`,resource:`people`,intent:`read`,cliPath:[`people`,`urls`,`types`,`list`],summary:`List person URL types`,description:`Returns canonical URL types and aliases accepted by person URL rows.`,scope:`read`,auth:`none`,errorResponse:[],parameters:[]},{operationId:`researchDetailTypes`,method:`GET`,path:`/v1/entities/research/details/types`,resource:`entities`,intent:`read`,cliPath:[`entities`,`research`,`details`,`types`,`list`],summary:`List research detail types`,description:`Returns research detail type tokens and write metadata, including 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:`read`,errorResponse:[],parameters:[]},{operationId:`researchSnippetTypes`,method:`GET`,path:`/v1/entities/research/snippets/types`,resource:`entities`,intent:`read`,cliPath:[`entities`,`research`,`snippets`,`types`,`list`],summary:`List 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:[]}];export{y as A,Se as C,ge as D,v as E,m as F,se as I,le as M,g as N,x as O,ce as P,P as S,me as T,L as _,Ue as a,I as b,Pe as c,ke as d,Ae as f,Oe as g,W as h,He as i,he as j,S as k,Me as l,q as m,Ge as n,Ve as o,je as p,Be as r,Re as s,Ke as t,Y as u,Ee as v,b as w,we as x,Te as y};