Create news article for entity
Creates a news article and links it to an entity. When an article with the same canonical newsUrlOriginal (or externalId) already exists, the existing article is reused and this entity is attached to it instead of creating a duplicate.
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
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.
Source-backed evidence that the access-walled canonical URL is the article.
Must be true when the publisher blocks direct acquisition of a native article image; the managed import lane may still recover the image through the Web Unlocker.
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
Existing article matched; entity attached
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.