Destination

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/deploy-social/json-schema/deploy-social-destination-schema.json",
  "title": "Destination",
  "description": "A social account connected to your workspace.",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/deploy-social-openapi.yml#/components/schemas/Destination",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The destination's id. Starts with `dest_`."
    },
    "platform": {
      "type": "string"
    },
    "handle": {
      "type": "string"
    },
    "display_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "avatar_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "type": "string",
      "description": "`active` can be posted to. `reconnect_required` needs someone to reconnect it in Deploy first. `disconnected` was disconnected in Deploy. New values may be added."
    },
    "status_reason": {
      "description": "Why it isn't `active`, when it isn't.",
      "type": [
        "string",
        "null"
      ]
    },
    "media_limits": {
      "$ref": "#/$defs/MediaLimits"
    }
  },
  "required": [
    "id",
    "platform",
    "handle",
    "display_name",
    "avatar_url",
    "status",
    "status_reason",
    "media_limits"
  ],
  "additionalProperties": false,
  "$defs": {
    "MediaLimits": {
      "type": "object",
      "properties": {
        "max_duration_sec": {
          "type": "number"
        },
        "min_duration_sec": {
          "description": "The shortest video accepted, in seconds. `null` means no minimum.",
          "type": [
            "number",
            "null"
          ]
        },
        "max_file_size_mb": {
          "type": "number"
        },
        "aspect_ratios": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The shapes that look best here."
        },
        "aspect_range": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "min": {
                  "type": "number"
                },
                "max": {
                  "type": "number"
                }
              },
              "required": [
                "min",
                "max"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ],
          "description": "Width divided by height must fall in this range. `null` means any shape is accepted."
        },
        "requires_portrait": {
          "type": "boolean",
          "description": "Only vertical video is accepted."
        },
        "min_resolution": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "width": {
                  "type": "number"
                },
                "height": {
                  "type": "number"
                }
              },
              "required": [
                "width",
                "height"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ],
          "description": "The smallest frame accepted: width and height must both reach these. `null` means no minimum."
        },
        "containers": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "max_duration_sec",
        "min_duration_sec",
        "max_file_size_mb",
        "aspect_ratios",
        "aspect_range",
        "requires_portrait",
        "min_resolution",
        "containers"
      ],
      "additionalProperties": false,
      "description": "What a video has to fit to post here."
    }
  }
}