Screenbird

{
  "type": "object",
  "required": [
    "scene_id"
  ],
  "properties": {
    "scene_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F-]{36}$"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "device"
  ],
  "properties": {
    "device": {
      "type": "string",
      "maxLength": 80
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "brief"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 100,
      "description": "Name of the design in Screenbird. Optional."
    },
    "brief": {
      "type": "string",
      "maxLength": 4000,
      "description": "What the design must show, in the user's words, with all texts, prices, times and names to put on it."
    },
    "language": {
      "type": "string",
      "description": "Two-letter language code of the texts on the design (en, nl, de, ...)."
    },
    "orientation": {
      "enum": [
        "landscape",
        "portrait"
      ],
      "type": "string",
      "description": "Screen orientation. Default landscape."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "device"
  ],
  "properties": {
    "device": {
      "enum": [
        "signage_stick",
        "fire_tv",
        "android_tv",
        "windows",
        "macos",
        "linux",
        "raspberry_pi",
        "browser"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Scenes per page. Default 25."
    },
    "cursor": {
      "type": "string",
      "description": "next_cursor from the previous page."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Screens per page. Default 25."
    },
    "query": {
      "type": "string",
      "maxLength": 100,
      "description": "Part of a screen or sub-screen name."
    },
    "cursor": {
      "type": "string",
      "description": "next_cursor from the previous page."
    },
    "screen_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F-]{36}$",
      "description": "One screen."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "screen_id",
    "content_id"
  ],
  "properties": {
    "until": {
      "type": "string",
      "description": "When to go back to normal: local time of the account without an offset (for example 2026-10-23T18:00), or a time with an offset (2026-10-23T18:00:00+02:00). At most 90 days ahead. Leave out to show it until it is put back to normal."
    },
    "screen_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F-]{36}$"
    },
    "content_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F-]{36}$"
    },
    "subscreen_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F-]{36}$"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "scene_id"
  ],
  "properties": {
    "scene_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F-]{36}$"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "screen_id"
  ],
  "properties": {
    "screen_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F-]{36}$"
    },
    "subscreen_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F-]{36}$"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "type": {
      "enum": [
        "file",
        "design",
        "app",
        "split_screen",
        "playlist"
      ],
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Default 20."
    },
    "query": {
      "type": "string",
      "maxLength": 100,
      "description": "Part of the name. Leave empty to list recent content."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "full": {
      "type": "boolean",
      "description": "Return the complete article text. Default false."
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "description": "What the user wants to know, in their own words."
    },
    "language": {
      "type": "string",
      "description": "Two-letter language code of the user (en, nl, de, fr, ...). Articles come in that language."
    }
  },
  "additionalProperties": false
}