Sign in
articles

Create a new article

Changed on
post/api/articles

Request

  • The document declares no server URL.
  • Auth: none declared

Request body

titlestring required

Response

Article created

author_display_namestring required
author_handlestring nullable
author_public_rolesstring[] required
author_user_idstring required
created_atstring required
descriptionstring nullable
htmlstring required
idstring required
latest_review_request_idstring nullable

Most recent review request of any status (owner only) — the author's entry point to the review page and its history.

markdownstring required
pending_review_request_idstring nullable

Pending review request on this article, if any. Populated for the owner (get_user_article) only; absent on public endpoints.

published_atstring nullable
quoting_disabledboolean required

Admin-set: suppress the reader's sentence-selection layer, for articles that read as blog posts rather than quotable scholarship.

slugstring required
status'draft' | 'published' | 'archived' required

An article's lifecycle state. Stored as the Postgres enum article_status.

titlestring required
updated_atstring required

Changes

  • 7ebaeb4dcc3cRevision changes
    • info

      added the required property to the response with the status

  • 1f567b50f90cRevision changes
    • warning

      added the new archived enum value to the response property for the response status

    • warning

      added the new draft enum value to the response property for the response status

    • warning

      added the new published enum value to the response property for the response status