action discourse_create_topic_post_pm {
  label: "Creates a new topic, a new post, or a private message"
  provider: discourse
  method: POST
  path: "/posts.json"
  encoding: json
  input: {
    required: ["raw"]
    properties: {
      archetype: {
        type: "string"
        description: "Required for new private message."
      }
      category: {
        type: "integer"
        description: "Optional if creating a new topic, and ignored if creating\na new post."
      }
      created_at: {
        type: "string"
      }
      embed_url: {
        type: "string"
        description: "Provide a URL from a remote system to associate a forum\ntopic with that URL, typically for using Discourse as a comments\nsystem for an external blog."
      }
      external_id: {
        type: "string"
        description: "Provide an external_id from a remote system to associate\na forum topic with that id."
      }
      raw: {
        type: "string"
      }
      target_recipients: {
        type: "string"
        description: "Required for private message, comma separated."
      }
      target_usernames: {
        type: "string"
        description: "Deprecated. Use target_recipients instead."
      }
      title: {
        type: "string"
        description: "Required if creating a new topic or new private message."
      }
      topic_id: {
        type: "integer"
        description: "Required if creating a new post."
      }
    }
    additionalProperties: false
  }
  output: {
    required: ["actions_summary", "admin", "avatar_template", "bookmarked", "can_delete", "can_edit", "can_recover", "can_view_edit_history", "can_wiki", "cooked", "created_at", "deleted_at", "display_username", "draft_sequence", "edit_reason", "flair_bg_color", "flair_color", "flair_name", "flair_url", "hidden", "id", "incoming_link_count", "moderator", "name", "post_number", "post_type", "primary_group_name", "quote_count", "readers_count", "reads", "reply_count", "reply_to_post_number", "reviewable_id", "reviewable_score_count", "reviewable_score_pending_count", "score", "staff", "topic_id", "topic_slug", "trust_level", "updated_at", "user_deleted", "user_id", "user_title", "username", "version", "wiki", "yours"]
    properties: {
      actions_summary: {
        type: "array"
        items: {
          type: "object"
          required: ["id", "can_act"]
          properties: {
            can_act: {
              type: "boolean"
            }
            id: {
              type: "integer"
            }
          }
          additionalProperties: false
        }
      }
      admin: {
        type: "boolean"
      }
      avatar_template: {
        type: "string"
      }
      bookmarked: {
        type: "boolean"
      }
      can_delete: {
        type: "boolean"
      }
      can_edit: {
        type: "boolean"
      }
      can_recover: {
        type: "boolean"
      }
      can_view_edit_history: {
        type: "boolean"
      }
      can_wiki: {
        type: "boolean"
      }
      cooked: {
        type: "string"
      }
      created_at: {
        type: "string"
      }
      deleted_at: {
        type: ["string", "null"]
      }
      display_username: {
        type: ["string", "null"]
      }
      draft_sequence: {
        type: "integer"
      }
      edit_reason: {
        type: ["string", "null"]
      }
      flair_bg_color: {
        type: ["string", "null"]
      }
      flair_color: {
        type: ["string", "null"]
      }
      flair_name: {
        type: ["string", "null"]
      }
      flair_url: {
        type: ["string", "null"]
      }
      hidden: {
        type: "boolean"
      }
      id: {
        type: "integer"
      }
      incoming_link_count: {
        type: "integer"
      }
      mentioned_users: {
        type: "array"
        items: {
          type: "object"
        }
      }
      moderator: {
        type: "boolean"
      }
      name: {
        type: ["string", "null"]
      }
      post_number: {
        type: "integer"
      }
      post_type: {
        type: "integer"
      }
      primary_group_name: {
        type: ["string", "null"]
      }
      quote_count: {
        type: "integer"
      }
      raw: {
        type: "string"
      }
      readers_count: {
        type: "integer"
      }
      reads: {
        type: "integer"
      }
      reply_count: {
        type: "integer"
      }
      reply_to_post_number: {
        type: ["string", "null"]
      }
      reviewable_id: {
        type: ["string", "null"]
      }
      reviewable_score_count: {
        type: "integer"
      }
      reviewable_score_pending_count: {
        type: "integer"
      }
      score: {
        type: "integer"
      }
      staff: {
        type: "boolean"
      }
      topic_id: {
        type: "integer"
      }
      topic_slug: {
        type: "string"
      }
      trust_level: {
        type: "integer"
      }
      updated_at: {
        type: "string"
      }
      user_deleted: {
        type: "boolean"
      }
      user_id: {
        type: "integer"
      }
      user_title: {
        type: ["string", "null"]
      }
      username: {
        type: "string"
      }
      version: {
        type: "integer"
      }
      wiki: {
        type: "boolean"
      }
      yours: {
        type: "boolean"
      }
    }
    additionalProperties: false
  }
}