Replace news article for entity
Full replacement for a news article directly joined to the entity; product/service-joined list rows 404 here (see GET /v1/news/detail).
Authentication
User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key
Admin API key for system-to-system write operations
Path parameters
Query parameters
Owner-scoped resource UUID selector.
Owner-scoped resource slug selector.
Provider name for provider-native IDs or slugs.
Provider-native source ID.
Provider-native source slug.
Actor type; inferred as agent when agentChassis and agentModel are supplied, or as employee from an authenticated user JWT session.
Agent chassis token for agent-authored writes.
Agent model id for agent-authored writes.
Source-backed reason for overriding the returned gate requirement.
Request
Override suspected shell-strip rejection for intentional prose; prefer —from-file.
Comma-separated category tags (e.g. “Fintech,Startups”); array syntax is rejected.
Article content body. Required on CREATE for internal articles (externalNewsArticle=false); external articles (the default) omit it and render via redirect to newsUrlOriginal.
Entity ids for the replacement entity join set; scoped routes keep route entity
Match status applied to every entityJoinId replacement join; matchStatus must be auto-match|needs-review|approved|rejected with optional audit metadata
Article excerpt/summary. Required on CREATE for external articles (the default).
External article flag. Defaults to true (external/third-party article) when omitted; set false only for an internal aVenture-hosted article, which requires content.
Preferred detail-update slug rename field; omit on create.
Managed news thumbnail path returned by media upload/import; sourceDetail must match stored media provenance.
Original live news article URL. Required on CREATE for external articles. Rejected (422): ycombinator.com/companies/{company-slug}, pitchbook.com/profiles/, linkedin.com/company/, producthunt.com/products/**, and other entity/profile URLs; use the ProblemDetail surface, usually EntityUrl.urlType=* via entities urls create.
Score for the person match (0-100)
Match status for the replacement person join; matchStatus must be auto-match|needs-review|approved|rejected with optional audit metadata
Publication/source name. Required on CREATE for external articles (the default).
Deprecated: caller-supplied article embeddings are rejected. Canonical section-fusion embeddings refresh from saved article content. Embedding vector pinned to qwen-4b-fp16 (Qwen3-Embedding-4B-f16.gguf) from https://huggingface.co/Qwen/Qwen3-Embedding-4B-GGUF?show_file_info=Qwen3-Embedding-4B-f16.gguf; only this fp16 model is accepted and exactly 2560 floats are required
Article slug. Omit for the dated slug generated from publishedAt and title; detail updates may rename through this field or newSlug.
Response
Resolved entity mentions — read-only display projections. News mutations attach entities only via flat entityJoinId values, never these nested objects.
Resolved person mentions — read-only display projections. News mutations attach people only via flat personId/personSlug values, never these nested objects.