---
title: "Create/Update News Article"
method: PUT
path: "/external/api/partner/v1/article/"
---

# Create/Update News Article

`PUT /external/api/partner/v1/article/`

## Headers

- `authorization` string

## Request body

- object
  - `publication_url` string — Fully escaped in https://www.example.com format
  - `guid` string — Primary key of your article
  - `content_url` string — Link to the article
  - `title` string — Title of the article
  - `description` string — Description of the article
  - `media` string, json — { "type": "image" | "video", "url": "<ARTICLE_COVER_MEDIA_URL>", "image_alt_text": "<IMAGE_ALT_TEXT>"}
  - `published_at` string — ARTICLE_PUBLISHED_AT_ISO_8601_TIMESTAMP
  - `modified_at` string — ARTICLE_MODIFIED_AT_ISO_8601_TIMESTAMP
  - `content` string — This will not be displayed but is EXTREMELY IMPORTANT as it is used for ML models for targeting and distribution
  - `authors` string[] — (optional) author names
  - `tags` string[] — (optional) used for content understanding, not display

## Response `200`

200

## Other responses

- `400` — 400

---

[API](https://skmtc.net/nextdoor/apis/share-api.md) · [All operations](https://skmtc.net/nextdoor/apis/share-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nextdoor/share-api/versions/e267916612d6/schema)