Clarify Story API

app/src/main/java/org/pixeldroid/app/utils/api/PixelfedAPI.kt

@@ -165,6 +165,7 @@ interface PixelfedAPI {
         @Field("poll[expires_in]") poll_expires: List<String>? = null,
         @Field("poll[multiple]") poll_multiple: List<String>? = null,
         @Field("poll[hide_totals]") poll_hideTotals: List<String>? = null,
+        //FIXME this should be able to take a boolean or at least "true"/"false" but only "0"/"1" works
         @Field("sensitive") sensitive: Int? = null,
         @Field("spoiler_text") spoiler_text: String? = null,
         @Field("visibility") visibility: String = "public",
@@ -253,14 +254,14 @@ interface PixelfedAPI {
     @POST("/api/v1.1/stories/add")
     fun storyUpload(
         @Part file: MultipartBody.Part,
+        // The API takes this value but then overwrites it in /api/v1.1/stories/publish, so ignore this
         @Part duration: MultipartBody.Part? = null,
     ): Observable<Attachment>
 
     @POST("/api/v1.1/stories/publish")
     suspend fun storyPublish(
         @Query("media_id") media_id: String,
-        //From 0 to 30
-        //TODO figure out what this duration means
+        //From 0 to 30, duration in seconds of the story
         @Query("duration") duration: Int = 10,
         //FIXME this should be able to take a boolean or at least "true"/"false" but only "0"/"1" works. Same issue as sensitive boolean in postStatus
         @Query("can_reply") can_reply: String,