aVenture APIEntity Fundraise

Delete fundraise investor join

View as Markdown
Hard-deletes an investor join from a fundraise round and returns the deleted join as confirmation. 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.

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

Query parameters

idstringOptionalformat: "uuid"

Owner-scoped resource UUID selector.

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

Owner-scoped resource slug selector.

joinIdstringOptionalformat: "uuid"
Join identifier. When present, lookup ignores transaction and investor query parameters.
transactionIdstringOptionalformat: "uuid"

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.

roundstringOptional
Raw fundraise round label used when transactionId is omitted
dateAnnounceddatetimeOptional

Exact announced timestamp used to disambiguate same-label rounds

investorEntityIdstringOptionalformat: "uuid"

Existing investor entity identifier. The entity must already exist; create a referenced investor entity first with POST /v1/entities/detail.

investorEntitySlugstringOptional

Existing investor entity slug when investorEntityId is omitted. The entity must already exist; create it first with POST /v1/entities/detail.

investorPersonIdstringOptionalformat: "uuid"

Existing investor person identifier. The person must already exist; create a referenced investor person first with POST /v1/people/detail.

investorPersonSlugstringOptional

Existing investor person slug when investorPersonId is omitted. The person must already exist; create it first with POST /v1/people/detail.

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.

Response

OK
createdAtdatetime
Created timestamp
idstringformat: "uuid"
Fundraise investor join identifier
investorobject

Investor identity, nested: investor.entityId for a firm/fund investor or investor.personId for an angel — exactly one is set. Read responses carry ids only, never flat investor* fields or names; resolve display names with GET /v1/entities/detail or GET /v1/people/detail.

leadInvestorboolean

Whether this investor is the lead investor for the round — the lead/anchor investor that set the round terms or made the primary commitment.

transactionIdstringformat: "uuid"
Fundraise transaction identifier
updatedAtdatetime
Updated timestamp
amountInvesteddouble or nullOptional

Investor-level attributed amount invested in the fundraise transaction currency. Serialized as a plain JSON number such as 220000 or 123456.78; no currency sign, currency code, comma grouping, or abbreviated amount text is valid.

financialInstrumentTypeenum or nullOptional

Financial instrument/vehicle for this investor’s participation in the round (e.g. SAFE, Preferred Stock, Convertible Note). Distinct from the round-level financialInstrumentType: a single round can record different vehicles per investor join — e.g. an accelerator batch holding a capped SAFE and an uncapped-MFN SAFE as two joins.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error