summaryrefslogtreecommitdiff
path: root/doc/API.md
diff options
context:
space:
mode:
authorShyam Sunder <sgsunder1@gmail.com>2020-03-21 18:36:52 -0400
committerShyam Sunder <sgsunder1@gmail.com>2020-04-01 21:01:20 -0400
commit08e62ec8853d7564ac718471be7fd32739a0bf90 (patch)
treefb34f58cef003522c8f1b3bf005aaf112b039db7 /doc/API.md
parent65202189e10027770f6737c46ab0b87884150b5e (diff)
client/posts: don't define flags on post upload
Diffstat (limited to 'doc/API.md')
-rw-r--r--doc/API.md19
1 files changed, 10 insertions, 9 deletions
diff --git a/doc/API.md b/doc/API.md
index c23f045..6a733f7 100644
--- a/doc/API.md
+++ b/doc/API.md
@@ -843,12 +843,13 @@ data.
automatically created. Tags created automatically have no implications, no
suggestions, one name and their category is set to the first tag category
found. Safety must be any of `"safe"`, `"sketchy"` or `"unsafe"`. Relations
- must contain valid post IDs. `<flag>` currently can be only `"loop"` to
- enable looping for video posts. Sending empty `thumbnail` will cause the
- post to use default thumbnail. If `anonymous` is set to truthy value, the
- uploader name won't be recorded (privilege verification still applies; it's
- possible to disallow anonymous uploads completely from config.) For details
- how to pass `content` and `thumbnail`, see [file uploads](#file-uploads).
+ must contain valid post IDs. If `<flag>` is omitted, they will be defined
+ by default (`"loop"` will be set for all video posts, and `"sound"` will be
+ auto-detected). Sending empty `thumbnail` will cause the post to use default
+ thumbnail. If `anonymous` is set to truthy value, the uploader name won't be
+ recorded (privilege verification still applies; it's possible to disallow
+ anonymous uploads completely from config.) For details on how to pass `content`
+ and `thumbnail`, see [file uploads](#file-uploads).
## Updating post
- **Request**
@@ -892,9 +893,9 @@ data.
automatically created. Tags created automatically have no implications, no
suggestions, one name and their category is set to the first tag category
found. Safety must be any of `"safe"`, `"sketchy"` or `"unsafe"`. Relations
- must contain valid post IDs. `<flag>` currently can be only `"loop"` to
- enable looping for video posts. Sending empty `thumbnail` will reset the
- post thumbnail to default. For details how to pass `content` and
+ must contain valid post IDs. `<flag>` can be either `"loop"` to enable looping
+ for video posts or `"sound"` to indicate sound. Sending empty `thumbnail` will
+ reset the post thumbnail to default. For details how to pass `content` and
`thumbnail`, see [file uploads](#file-uploads). All fields except the
[`version`](#versioning) are optional - update concerns only provided
fields.