{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/twexapi-io/json-schema/twexapi-io-send-dm-v3-query-schema.json",
  "title": "SendDmV3Query",
  "description": "Parameters for sending DM via XChat v3",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/twexapi-io-openapi.json#/components/schemas/SendDmV3Query",
  "properties": {
    "recipient": {
      "type": "string",
      "title": "Recipient",
      "description": "User id, @handle, or a group id (g...) for an existing group."
    },
    "text": {
      "type": "string",
      "title": "Text",
      "description": "Message body."
    },
    "media_urls": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array",
          "maxItems": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Media Urls",
      "description": "Public URL of one image to attach (max 1). Mutually exclusive with video_url."
    },
    "video_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Video Url",
      "description": "Public http(s) URL of one video to attach (mutually exclusive with image)."
    },
    "pin": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Pin",
      "description": "Identity PIN (default 1234).",
      "default": "1234"
    },
    "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)."
    },
    "proxy": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Proxy",
      "description": "Optional HTTP proxy. Example: http://username:password@ip:port"
    }
  },
  "type": "object",
  "required": [
    "recipient",
    "text",
    "cookie"
  ]
}