> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.aventure.vc/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.aventure.vc/_mcp/server. # Join fundraise investor POST https://api.aventure.vc/v1/entities/detail/fundraise-investor-joins Content-Type: application/json Joins an entity or person investor to a fundraise round with optional 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; aventure-cli uses --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. Reference: https://docs.aventure.vc/api-reference/a-venture-api/entity-fundraise/create-fundraise-investor-join ## Authentication - `Authorization` header (bearer token, required) — User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key - `X-API-Key` header (required) — Admin API key for system-to-system write operations ## Request ### Query parameters - `id` (string, optional) — Owner-scoped resource UUID selector. - `slug` (string, optional) — Owner-scoped resource slug selector. - `sourceType` (enum, required) — Write provenance source type. - Allowed values: `requestChangeForm`, `newsArticle`, `blogArticle`, `firstPartyWebsite`, `relatedPartyWebsite`, `thirdPartyWebsite`, `llm`, `aventureStaff` - `sourceDetail` (string, required) — Source detail or reviewer reference for the write. - `sourceProvider` (string, optional) — Provider name for provider-native IDs or slugs. - `sourceProviderId` (string, optional) — Provider-native source ID. - `sourceProviderSlug` (string, optional) — Provider-native source slug. - `actorType` (enum, optional) — Actor type; inferred as agent when agentChassis and agentModel are supplied, or as employee from an authenticated user JWT session. - Allowed values: `agent`, `employee` - `agentChassis` (string, optional) — Agent chassis token for agent-authored writes. - `agentModel` (string, optional) — Agent model id for agent-authored writes. ### Body (application/json) - `amountInvested` (double, optional, nullable) — Investor-level attributed amount invested in the fundraise transaction currency. API and MCP request bodies use a JSON number such as 220000 or 123456.78; aventure-cli uses --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. In PATCH application/merge-patch+json, amountInvested:null clears the value. - `dateAnnounced` (datetime, optional, nullable) — Exact announced timestamp used to disambiguate same-label rounds - `financialInstrumentType` (enum, optional, nullable) — Financial instrument/vehicle for this investor's participation (e.g. SAFE, Preferred Stock, Convertible Note). Lets one round carry distinct vehicles per investor join. In PATCH application/merge-patch+json, omit to preserve the current value; financialInstrumentType:null clears it. - Allowed values: `SAFE`, `Convertible Note`, `Preferred Stock`, `Common Stock`, `Other Equity`, `Bond`, `Loan`, `Other Debt`, `Grant`, `Token` - `investorEntityId` (string, optional, nullable) — Existing investor entity identifier. The entity must already exist; create a referenced investor entity first with POST /v1/entities/detail. - `investorEntitySlug` (string, optional, nullable) — Existing investor entity slug when investorEntityId is omitted. The entity must already exist; create it first with POST /v1/entities/detail. - `investorPersonId` (string, optional, nullable) — Existing investor person identifier. The person must already exist; create a referenced investor person first with POST /v1/people/detail. - `investorPersonSlug` (string, optional, nullable) — Existing investor person slug when investorPersonId is omitted. The person must already exist; create it first with POST /v1/people/detail. - `leadInvestor` (boolean, optional, nullable) — Whether this investor led the round — the lead/anchor investor that set terms or made the primary commitment. Optional: defaults to false on create and replace when omitted; in PATCH application/merge-patch+json, omit to preserve the current value. - `round` (string, optional, nullable) — Raw fundraise round label used when transactionId is omitted - `transactionId` (string, optional, nullable) — 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, round lookup uses the target entity plus round/dateAnnounced. ## Response ### 201 Created - `createdAt` (datetime, required) — Created timestamp - `id` (string, required) — Fundraise investor join identifier - `investor` (object, required) — 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. - `entityId` (string, optional, nullable) — Canonical entity UUID - `personId` (string, optional, nullable) — Canonical person UUID - `leadInvestor` (boolean, required) — Whether this investor is the lead investor for the round — the lead/anchor investor that set the round terms or made the primary commitment. - `transactionId` (string, required) — Fundraise transaction identifier - `updatedAt` (datetime, required) — Updated timestamp - `amountInvested` (double, optional, nullable) — 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. - `financialInstrumentType` (enum, optional, nullable) — 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. - Allowed values: `SAFE`, `Convertible Note`, `Preferred Stock`, `Common Stock`, `Other Equity`, `Bond`, `Loan`, `Other Debt`, `Grant`, `Token` ## Examples **Request** ```json {} ``` **Response** ```json { "createdAt": "2024-01-15T09:30:00Z", "id": "string", "investor": { "entityId": "string", "personId": "string" }, "leadInvestor": true, "transactionId": "string", "updatedAt": "2024-01-15T09:30:00Z", "amountInvested": 1.1, "financialInstrumentType": "SAFE" } ``` **SDK Code** ```python import requests url = "https://api.aventure.vc/v1/entities/detail/fundraise-investor-joins" querystring = {"actorType":"agent","agentChassis":"codex-cli","id":"04e2bf9c-a100-72ad-83ff-ba69c647b30b","slug":"acme-corp","sourceDetail":"aventure.vc","sourceProvider":"TechCrunch","sourceProviderId":"tc-2026-05-20-example-round","sourceProviderSlug":"example-round","sourceType":"requestChangeForm"} payload = {} headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers, params=querystring) print(response.json()) ``` ```javascript const url = 'https://api.aventure.vc/v1/entities/detail/fundraise-investor-joins?actorType=agent&agentChassis=codex-cli&id=04e2bf9c-a100-72ad-83ff-ba69c647b30b&slug=acme-corp&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.aventure.vc/v1/entities/detail/fundraise-investor-joins?actorType=agent&agentChassis=codex-cli&id=04e2bf9c-a100-72ad-83ff-ba69c647b30b&slug=acme-corp&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm" payload := strings.NewReader("{}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.aventure.vc/v1/entities/detail/fundraise-investor-joins?actorType=agent&agentChassis=codex-cli&id=04e2bf9c-a100-72ad-83ff-ba69c647b30b&slug=acme-corp&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.aventure.vc/v1/entities/detail/fundraise-investor-joins?actorType=agent&agentChassis=codex-cli&id=04e2bf9c-a100-72ad-83ff-ba69c647b30b&slug=acme-corp&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{}") .asString(); ``` ```php request('POST', 'https://api.aventure.vc/v1/entities/detail/fundraise-investor-joins?actorType=agent&agentChassis=codex-cli&id=04e2bf9c-a100-72ad-83ff-ba69c647b30b&slug=acme-corp&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm', [ 'body' => '{}', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.aventure.vc/v1/entities/detail/fundraise-investor-joins?actorType=agent&agentChassis=codex-cli&id=04e2bf9c-a100-72ad-83ff-ba69c647b30b&slug=acme-corp&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.aventure.vc/v1/entities/detail/fundraise-investor-joins?actorType=agent&agentChassis=codex-cli&id=04e2bf9c-a100-72ad-83ff-ba69c647b30b&slug=acme-corp&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```