> 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. # Patch one person URL PATCH https://api.aventure.vc/v1/people/{personId}/urls/{urlId} Content-Type: application/merge-patch+json Applies an RFC 7396 merge patch to one person-owned URL row. Omitted isCurrent/isPrimary preserve existing values. Reference: https://docs.aventure.vc/api-reference/a-venture-api/url-links/patch-person-url ## 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 ### Path parameters - `personId` (string, required) — Person UUID owning the URL row - `urlId` (long, required) — URL link id ### Query parameters - `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/merge-patch+json) - `crawlCdnProvider` (enum, optional, nullable) — CDN or hosting provider observed during crawl checks. - Allowed values: `cloudflare`, `akamai`, `fastly`, `awsCloudfront`, `vercel`, `netlify`, `sucuri`, `incapsula`, `bunny`, `keycdn`, `cdn77`, `gcore`, `cdnetworks`, `azureCdn`, `leaseweb`, `digitalocean`, `stackpath`, `googlecloudCdn`, `none`, `unknown` - `crawlRenderMode` (enum, optional, nullable) — JavaScript rendering requirement observed during crawl checks. - Allowed values: `static`, `jsRequired`, `jsEnhanced` - `isCurrent` (boolean, optional, nullable) — Whether the owner currently uses this URL. Defaults true on create; update omits preserve the existing value. For terminal entity operatingStatus values (Acquired, Closed, Inactive), website rows must be written with isCurrent=false. - `isPrimary` (boolean, optional, nullable) — Whether this is the owner's primary URL for its urlType. Defaults true for current create rows; update omits preserve the existing value. Setting isCurrent=false forces isPrimary=false; terminal entities cannot have a current primary website row. Website primacy belongs to the homepage: while the owner has a current root-URL website row, a deep-path or query-carrying website URL cannot be primary — such a create is stored with isPrimary=false (even when requested true), and an update promoting one, or moving a primary row's URL across the root/deep boundary, is rejected (409). - `status` (string, optional, nullable) — Crawl/check status label, not lifecycle. - `statusChecked` (datetime, optional, nullable) — Last crawl/check timestamp. - `url` (string, optional, nullable) — Absolute owner URL (https://...), normalized before validation. Must be a page the owner actually operates. URL surface misclassification is rejected (422): news/press articles such as a dated article path or a techcrunch.com/businesswire.com/forbes.com article — record it through the owner's canonical news create surface, NEVER as a website link; domain-marketplace/for-sale pages (dan.com, hugedomains.com, ...); and binary assets (.png/.pdf/...). Eponymous Product/Service full-create may omit the entire URL link array when no distinct official page URL exists. Submit either `www.` or apex host form; after write the stored host form is normalized from live evidence — apex (no `www.`) when that route serves healthy without redirecting to `www.`, the `www.` form otherwise — so the persisted URL may differ from the submitted one by its `www.` label. - `urlType` (string, optional, nullable) — Canonical platform role for the URL, from EntityUrlType (website, linkedin, twitter, github, crunchbase, wikipedia, appstore, ...). Pick the platform the URL host belongs to for owner-specific platform paths. Platform host roots and first-party product pages stay `website`; security quote paths, social profiles, marketplace listings, and similar owner-specific platform paths use their platform type. Lifecycle (former domain, rebrand source) lives on isCurrent/isPrimary, never here. Required on create unless inferable from the URL host/path. ## Response ### 200 OK - `url` (string, required) — Canonical absolute HTTP URL value - validates scheme + host at construction - `urlType` (enum, required) — Canonical URL platform type such as website, linkedin, twitter, or github. Lifecycle facts belong on link flags such as isCurrent and isPrimary. - 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` - `crawlCdnProvider` (enum, optional, nullable) — CDN or hosting provider fronting a web URL. - Allowed values: `cloudflare`, `akamai`, `fastly`, `awsCloudfront`, `vercel`, `netlify`, `sucuri`, `incapsula`, `bunny`, `keycdn`, `cdn77`, `gcore`, `cdnetworks`, `azureCdn`, `leaseweb`, `digitalocean`, `stackpath`, `googlecloudCdn`, `none`, `unknown` - `crawlRenderMode` (enum, optional, nullable) — JavaScript rendering requirement for crawl checks. - Allowed values: `static`, `jsRequired`, `jsEnhanced` - `createdAt` (datetime, optional, nullable) - `id` (integer, optional, nullable) - `isCurrent` (boolean, optional, nullable) — `true` = owner currently uses this URL; `false` = historical/former (rebrand source domain, deprecated platform handle). The lifecycle state lives here, NEVER in the `urlType` discriminator. - `isPrimary` (boolean, optional, nullable) — `true` = canonical/primary URL of this `urlType` for this owner. Only one row per (owner, urlType) may be `isCurrent=true` AND `isPrimary=true`. - `owner` (object, optional, nullable) — Owning record, nested ids only: owner.entityId or owner.personId — exactly one is set, and no name fields. Writes are scoped by the owning entity/person route; owner is never a write field. - `entityId` (string, optional, nullable) — Canonical entity UUID - `personId` (string, optional, nullable) — Canonical person UUID - `sourceId` (string, optional, nullable) - `status` (string, optional, nullable) - `statusChecked` (datetime, optional, nullable) - `updatedAt` (datetime, optional, nullable) ## Examples **Request** ```json {} ``` **Response** ```json { "url": "https://example.com", "urlType": "website", "crawlCdnProvider": "cloudflare", "crawlRenderMode": "static", "createdAt": "2024-01-15T09:30:00Z", "id": 1, "isCurrent": true, "isPrimary": true, "owner": { "entityId": "string", "personId": "string" }, "sourceId": "string", "status": "string", "statusChecked": "2024-01-15T09:30:00Z", "updatedAt": "2024-01-15T09:30:00Z" } ``` **SDK Code** ```python import requests url = "https://api.aventure.vc/v1/people/personId/urls/1" querystring = {"actorType":"agent","agentChassis":"codex-cli","sourceDetail":"aventure.vc","sourceProvider":"TechCrunch","sourceProviderId":"tc-2026-05-20-example-round","sourceProviderSlug":"example-round","sourceType":"requestChangeForm"} payload = "{}" headers = { "Authorization": "Bearer ", "Content-Type": "application/merge-patch+json" } response = requests.patch(url, data=payload, headers=headers, params=querystring) print(response.json()) ``` ```javascript const url = 'https://api.aventure.vc/v1/people/personId/urls/1?actorType=agent&agentChassis=codex-cli&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm'; const options = { method: 'PATCH', headers: { Authorization: 'Bearer ', 'Content-Type': 'application/merge-patch+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/people/personId/urls/1?actorType=agent&agentChassis=codex-cli&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm" payload := strings.NewReader("{}") req, _ := http.NewRequest("PATCH", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/merge-patch+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/people/personId/urls/1?actorType=agent&agentChassis=codex-cli&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::Patch.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/merge-patch+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.patch("https://api.aventure.vc/v1/people/personId/urls/1?actorType=agent&agentChassis=codex-cli&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm") .header("Authorization", "Bearer ") .header("Content-Type", "application/merge-patch+json") .body("{}") .asString(); ``` ```php request('PATCH', 'https://api.aventure.vc/v1/people/personId/urls/1?actorType=agent&agentChassis=codex-cli&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm', [ 'body' => '{}', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/merge-patch+json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.aventure.vc/v1/people/personId/urls/1?actorType=agent&agentChassis=codex-cli&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm"); var request = new RestRequest(Method.PATCH); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/merge-patch+json"); request.AddParameter("application/merge-patch+json", "{}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/merge-patch+json" ] let postData = NSData(data: "{}".data(using: String.Encoding.utf8)!) let request = NSMutableURLRequest(url: NSURL(string: "https://api.aventure.vc/v1/people/personId/urls/1?actorType=agent&agentChassis=codex-cli&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 = "PATCH" 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() ```