Creates a new topic, a new post, or a private message

v1.0.0

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
}