aVenture APIEntity Fundraise

Patch fundraise round

View as Markdown
Patches a fundraise round for an entity. Use --entity-id or --entity-slug 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 transactionId for the round id. dateAnnounced is required after create, replace, and merge-patch; use the announcement date, earliest source publication date, first day of a known month, or YYYY-01-01T00:00:00Z when only a year remains after source-tier search.

Authentication

AuthorizationBearer

User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key

OR
X-API-Keystring

Admin API key for system-to-system write operations

Path parameters

transactionIdstringRequiredformat: "uuid"

Fundraise round transaction id. Use this with the —entity-id or —entity-slug selector that owns the round.

Query parameters

idstringOptionalformat: "uuid"

Owner-scoped resource UUID selector.

slugstringOptionalformat: "^[a-z0-9_-]+$"<=255 characters

Owner-scoped resource slug selector.

sourceTypeenumRequired
Write provenance source type.
sourceDetailstringRequired
Source detail or reviewer reference for the write.
sourceProviderstringOptional

Provider name for provider-native IDs or slugs.

sourceProviderIdstringOptional

Provider-native source ID.

sourceProviderSlugstringOptional

Provider-native source slug.

actorTypeenumOptional

Actor type; inferred as agent when agentChassis and agentModel are supplied, or as employee from an authenticated user JWT session.

Allowed values:
agentChassisstringOptional

Agent chassis token for agent-authored writes.

agentModelstringOptional

Agent model id for agent-authored writes.

Request

Fundraise fields to update (RFC 7396 merge patch)

dateAnnounceddatetime or nullRequired

Required occurrence date for the round. Use the announcement date; otherwise use the earliest source publication date announcing the round. For month/year evidence use the first day of that month; after source-tier search with only a year, use YYYY-01-01T00:00:00Z.

amountRaisedlong or nullOptional

Amount raised in this round only, in currency units (full units, not minor). Never include amounts from prior rounds, even when a press release reports a combined headline figure — record each round separately. Requires currency when supplied.

creatorstring or nullOptional
Creator label
currencystring or nullOptional

Required when amountRaised is supplied; ISO 4217 currency code.

dataConfidenceenum or nullOptional
Data confidence level
dateFundingCompletedatetime or nullOptional
Date funding completed
dateInvestorExitdatetime or nullOptional
Investor exit date
financialInstrumentTypeenum or nullOptional
Financial instrument type
investorCountinteger or nullOptional

Source-reported number of investors in the round. This can exceed the identified investor joins when a source reports a total without naming every investor; it is not derived from raw join-row count.

roundstring or nullOptional

Round label (e.g. Pre-Seed, Seed, Series A). One row per round — never collapse multiple rounds into a single transaction even when press reports a combined headline.

roundTypestring or nullOptional
Round type
statusenum or nullOptional
Transaction status
valuationPostMoneylong or nullOptional

Post-money valuation

valuationPreMoneylong or nullOptional

Pre-money valuation

Response

OK
idstringformat: "uuid"
Canonical fundraise transaction UUID
sourceAttributionlist of objects
amountRaisedlong or nullOptional
createdAtdatetime or nullOptional
currencystring or nullOptional
dataConfidenceenum or nullOptional
Data confidence level
dateAnnounceddatetime or nullOptional
dateFundingCompletedatetime or nullOptional
dateInvestorExitdatetime or nullOptional
entityobject or nullOptional
Entity projection used inside FundraiseTransaction responses
investorAttributionobject or nullOptional

Investor-specific attribution when returned from investor-perspective investment views. amountInvested is not added to amountRaised; it is the selected investor’s attributed participation amount for this round.

investorCountinteger or nullOptional

Source-reported number of investors in the round. This can exceed the identified investor joins when a source reports a total without naming every investor.

roundstring or nullOptional
updatedAtdatetime or nullOptional
valuationPostMoneylong or nullOptional
valuationPreMoneylong or nullOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
406
Not Acceptable Error
409
Conflict Error
415
Unsupported Media Type Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error