Sharkey/src/web/docs/api/endpoints/posts/create.yaml

endpoint: "posts/create"

desc:
  ja: "投稿します。"
  en: "Compose new post."

params:
  - name: "text"
    type: "string"
    optional: true
    desc:
      ja: "投稿の本文"
      en: "Text of a post"
  - name: "media_ids"
    type: "id(DriveFile)[]"
    optional: true
    desc:
      ja: "添付するメディア(1~4つ)"
      en: "Media you want to attach (1~4)"
  - name: "reply_id"
    type: "id(Post)"
    optional: true
    desc:
      ja: "返信する投稿"
      en: "A post you want to reply"
  - name: "repost_id"
    type: "id(Post)"
    optional: true
    desc:
      ja: "引用する投稿"
      en: "A post you want to quote"
  - name: "poll"
    type: "object"
    optional: true
    desc:
      ja: "投票"
      en: "A poll"
    defName: "poll"
    def:
      - name: "choices"
        type: "string[]"
        optional: false
        desc:
          ja: "投票の選択肢"
          en: "Choices of a poll"

res:
  - name: "created_post"
    type: "entity(Post)"
    optional: false
    desc:
      ja: "作成した投稿"
      en: "A post that created"