{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/twexapi-io/json-schema/twexapi-io-get-conversations-v3-query-schema.json",
  "title": "GetConversationsV3Query",
  "description": "Parameters for getting XChat conversation list",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/twexapi-io-dm-endpoints-api-openapi.yml#/components/schemas/GetConversationsV3Query",
  "properties": {
    "count": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 200,
          "minimum": 10
        },
        {
          "type": "null"
        }
      ],
      "title": "Count",
      "description": "Max conversations per page (10–200, default 20).",
      "default": 100
    },
    "all": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "All",
      "description": "Follow the inbox cursor and return every conversation (may be slow).",
      "default": false
    },
    "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": [
    "cookie"
  ]
}