aVenture APIEntity Financial Valuation

Merge-patch entity valuation datapoint by detail id

View as Markdown

Merge-patches the stated research-detail valuation identified by detailId from entities valuations list. Omitted fields are preserved. Fundraise-derived points have null detailId and cannot be targeted here. Response is the updated point.

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

detailIdintegerRequired
Research detail row id for the valuation datapoint

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

This endpoint expects an object.
asOfDatedatetime or nullOptional
Effective timestamp. Create allows one stated valuation per UTC calendar month.
confidenceenum or nullOptional

Confidence tier. Create and full replace default to medium when omitted; merge-patch preserves the existing value when omitted.

currencystring or nullOptional
ISO 4217 currency code, uppercase
kindenum or nullOptional

Declared basis for valuation. reported is charted as post-money by convention.

sourcestring or nullOptional
Evidence URL stored on the valuation detail. Distinct from the sourceType and sourceDetail query provenance.
valuationlong or nullOptional
Positive valuation amount in full currency units.

Response

OK
asOfDatedatetime
Effective timestamp for this valuation datapoint.
confidenceenum
Confidence tier for this datapoint.
currencystring
ISO 4217 currency code.
declaredBasisenum
Basis declared by the original source.
derivationenum

How pre-money and post-money fields were obtained.

sourceenum
Canonical store that supplied the point.
sourceRefstring

detail-<id> or fundraise-<transactionId> display reference.

amountRaisedlong or nullOptional
Amount raised in the same currency, only for fundraise rows.
detailIdinteger or nullOptional

Research detail id for stated valuation rows. Null for fundraise-derived rows, which cannot be updated or deleted on this valuation surface.

labelstring or nullOptional
Fundraise round label or legacy detail display text, when present.
valuationPostMoneylong or nullOptional

Post-money valuation in full currency units, when known.

valuationPreMoneylong or nullOptional

Pre-money valuation in full currency units, when known.

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