{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/twexapi-io/json-schema/twexapi-io-post-tweet-query-schema.json",
  "title": "PostTweetQuery",
  "description": "Parameters for posting a tweet",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/twexapi-io-openapi.json#/components/schemas/PostTweetQuery",
  "properties": {
    "media_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Media Url",
      "description": "Single media URL: image, GIF, or video. Prefer media_urls for multiple images."
    },
    "media_urls": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array",
          "maxItems": 4
        },
        {
          "type": "null"
        }
      ],
      "title": "Media Urls",
      "description": "Media URLs to attach (max 4 images, or 1 GIF, or 1 video). Cannot mix GIF/video with other media."
    },
    "tweet_content": {
      "type": "string",
      "title": "Tweet Content",
      "description": "Content of the tweet to post"
    },
    "delegated_account_username": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Delegated Account Username",
      "description": "delegated account username"
    },
    "schedule": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Schedule",
      "description": "Schedule time for the tweet in ISO format"
    },
    "reply_tweet_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Reply Tweet Id",
      "description": "ID of tweet to reply to"
    },
    "cookie": {
      "type": "string",
      "title": "Cookie",
      "description": "The user's own authorized Twitter session credentials or auth_token (BYOC — Bring Your Own Cookie). Stateless proxy execution with zero credential retention. See [Authentication Security](/authentication#write-operations--byoc-bring-your-own-cookie) and [How to get Cookie](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie)."
    },
    "community_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Community Name",
      "description": "Name of Twitter community to post in or community id"
    },
    "proxy": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Proxy",
      "description": "The proxy to use.Please use high-quality residential proxies and avoid free proxies.Required.Example: http://username:password@ip:port . You can get proxy from: https://app.proxy-cheap.com/r/qiMxub"
    }
  },
  "type": "object",
  "required": [
    "tweet_content",
    "cookie"
  ]
}