# Commune Articles API

**Canonical:** https://apis.io/apis/usecommune/usecommune-articles-api/  
**Provider:** Commune — https://apis.io/providers/usecommune/  
**Base URL:** https://api.usecommune.com  
**Documentation:** https://api-reference.usecommune.dev/

Commune Articles API is one of 18 APIs that [Commune](https://apis.io/providers/usecommune/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Articles. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

An article is one thing a newsletter published: written in Commune and sent, or imported from the newsletter's provider. Two rules gate every article read and are described on each operation. First, an article stamped with an audience is visible only to the newsletter's team and to subscribers holding one of its tags. Second, an article dated in the future is invisible until that moment passes. An article written in Commune can be created and edited here, its body sent and returned as Markdown, and moved through its life: sent to a test address, queued for a time, taken back off the schedule, sent to the list, and re-attempted for the recipients a dispatch could not reach. An imported article is read only. What one reader did with an article is here too, from their side of it. `GET /saved-articles` and `GET /liked-articles` are the articles an account put aside and the articles it liked, across every newsletter it reads, and they need `account: read` rather than `content`. Both obey the two rules above, applied against the person rather than against a newsletter, so an article they may no longer read leaves the page on its own.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| GET | `/newsletters/{newsletter}/articles` | List a newsletter's articles |
| POST | `/newsletters/{newsletter}/articles` | Create an article |
| GET | `/articles/{article}` | Retrieve an article |
| PATCH | `/articles/{article}` | Edit an article |
| GET | `/articles/{article}/authors` | List an article's authors |
| POST | `/articles/{article}/images` | Store an image for an article |
| POST | `/articles/{article}/test-send` | Send a test copy of an article |
| POST | `/articles/{article}/schedule` | Schedule an article |
| POST | `/articles/{article}/unschedule` | Cancel a scheduled article |
| POST | `/articles/{article}/send` | Send an article to the list |
| GET | `/saved-articles` | List the articles this account saved |
| GET | `/liked-articles` | List the articles this account liked |

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/usecommune/refs/heads/main/openapi/usecommune-articles-api-openapi.yml
- **Documentation** — https://api-reference.usecommune.dev/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/usecommune/refs/heads/main/json-schema/usecommune-newsletter-stats-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/usecommune/refs/heads/main/json-schema/usecommune-api-key-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/usecommune/refs/heads/main/json-schema/usecommune-delivery-attempt-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/usecommune/refs/heads/main/json-schema/usecommune-article-performance-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/usecommune/refs/heads/main/json-schema/usecommune-article-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/usecommune/refs/heads/main/json-schema/usecommune-send-schema.json
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/usecommune/refs/heads/main/apis.yml

## Other Commune APIs (12)

- [Commune Engagement API](https://apis.io/apis/usecommune/usecommune-engagement-api/)
- [Commune Event delivery API](https://apis.io/apis/usecommune/usecommune-event-delivery-api/)
- [Commune Highlights API](https://apis.io/apis/usecommune/usecommune-highlights-api/)
- [Commune Messages API](https://apis.io/apis/usecommune/usecommune-messages-api/)
- [Commune Metrics API](https://apis.io/apis/usecommune/usecommune-metrics-api/)
- [Commune Newsletters API](https://apis.io/apis/usecommune/usecommune-newsletters-api/)
- [Commune Platform API](https://apis.io/apis/usecommune/usecommune-platform-api/)
- [Commune Search API](https://apis.io/apis/usecommune/usecommune-search-api/)
- [Commune Senders API](https://apis.io/apis/usecommune/usecommune-senders-api/)
- [Commune Sends API](https://apis.io/apis/usecommune/usecommune-sends-api/)
- [Commune Subscriber tags API](https://apis.io/apis/usecommune/usecommune-subscriber-tags-api/)
- [Commune Subscribers API](https://apis.io/apis/usecommune/usecommune-subscribers-api/)

## Tags

Articles

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/usecommune/usecommune-articles-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/usecommune/.