From 3adbabd3b87ba298dcf46e3c98158fefd550e983 Mon Sep 17 00:00:00 2001 From: Areg Harutyunyan Date: Mon, 24 May 2021 22:00:56 +0100 Subject: [PATCH] Clarify creating public posts via the API --- source/index.html.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/index.html.md b/source/index.html.md index b9e0bcd6200..440890c10f5 100644 --- a/source/index.html.md +++ b/source/index.html.md @@ -244,6 +244,8 @@ This creates a new post, associating it with a user account if authenticated. If * writeas7pm7rcdqg.onion/`{id}` * paste.as/`{id}` -- if `font` was _code_ or _mono_ +The created post will be published as a draft, since it will not be part of any blog/collection. To make the post public, move that draft to a blog/collection with the [Move a Post](#move-a-post-to-a-collection) endpoint. + ### Authentication This can be done anonymously or while [authenticated](#authentication). @@ -1106,6 +1108,8 @@ client.movePost(token: "00000000-0000-0000-0000-000000000000", postId: "rf3t35fk This adds a group of posts to a collection. This works for either posts that were created anonymously (i.e. don't belong to the user account) or posts already owned by the user account. +If you are trying to publish a draft post to be public, use this endpoint to assign the draft post to a blog. + ### Definition `POST /api/collections/{COLLECTION_ALIAS}/collect`