Creation of a Tweet

v1.0.0

Causes the User to create a Tweet under the authorized account.

Input

{
  "type": "object",
  "properties": {
    "card_uri": {
      "type": "string",
      "description": "Card Uri Parameter. This is mutually exclusive from Quote Tweet Id, Poll, Media, and Direct Message Deep Link."
    },
    "direct_message_deep_link": {
      "type": "string",
      "description": "Link to take the conversation from the public timeline to a private Direct Message."
    },
    "for_super_followers_only": {
      "type": "boolean",
      "description": "Exclusive Tweet for super followers."
    },
    "geo": {
      "type": "object",
      "description": "Place ID being attached to the Tweet for geo location.",
      "properties": {
        "place_id": {
          "type": "string"
        }
      },
      "additionalProperties": false
    },
    "media": {
      "type": "object",
      "description": "Media information being attached to created Tweet. This is mutually exclusive from Quote Tweet Id, Poll, and Card URI.",
      "required": [
        "media_ids"
      ],
      "properties": {
        "media_ids": {
          "type": "array",
          "description": "A list of Media Ids to be attached to a created Tweet.",
          "items": {
            "type": "string",
            "description": "The unique identifier of this Media."
          }
        },
        "tagged_user_ids": {
          "type": "array",
          "description": "A list of User Ids to be tagged in the media for created Tweet.",
          "items": {
            "type": "string",
            "description": "Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers."
          }
        }
      },
      "additionalProperties": false
    },
    "nullcast": {
      "type": "boolean",
      "description": "Nullcasted (promoted-only) Tweets do not appear in the public timeline and are not served to followers."
    },
    "poll": {
      "type": "object",
      "description": "Poll options for a Tweet with a poll. This is mutually exclusive from Media, Quote Tweet Id, and Card URI.",
      "required": [
        "duration_minutes",
        "options"
      ],
      "properties": {
        "duration_minutes": {
          "type": "integer",
          "format": "int32",
          "description": "Duration of the poll in minutes."
        },
        "options": {
          "type": "array",
          "items": {
            "type": "string",
            "description": "The text of a poll choice."
          }
        },
        "reply_settings": {
          "type": "string",
          "description": "Settings to indicate who can reply to the Tweet.",
          "enum": [
            "following",
            "mentionedUsers"
          ]
        }
      },
      "additionalProperties": false
    },
    "quote_tweet_id": {
      "type": "string",
      "description": "Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers."
    },
    "reply": {
      "type": "object",
      "description": "Tweet information of the Tweet being replied to.",
      "required": [
        "in_reply_to_tweet_id"
      ],
      "properties": {
        "exclude_reply_user_ids": {
          "type": "array",
          "description": "A list of User Ids to be excluded from the reply Tweet.",
          "items": {
            "type": "string",
            "description": "Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers."
          }
        },
        "in_reply_to_tweet_id": {
          "type": "string",
          "description": "Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers."
        }
      },
      "additionalProperties": false
    },
    "reply_settings": {
      "type": "string",
      "description": "Settings to indicate who can reply to the Tweet.",
      "enum": [
        "following",
        "mentionedUsers"
      ]
    },
    "text": {
      "type": "string",
      "description": "The content of the Tweet."
    }
  },
  "additionalProperties": false
}

Output

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "id",
        "text"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers."
        },
        "text": {
          "type": "string",
          "description": "The content of the Tweet."
        }
      }
    },
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "description": "An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).",
        "required": [
          "type",
          "title"
        ],
        "properties": {
          "detail": {
            "type": "string"
          },
          "status": {
            "type": "integer"
          },
          "title": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      }
    }
  }
}