action thebluealliance_get_team_media_by_tag {
  label: "getTeamMediaByTag"
  description: "Gets a list of Media (videos / pictures) for the given team and tag."
  provider: thebluealliance
  method: GET
  path: "/team/{team_key}/media/tag/{media_tag}"
  encoding: json
  output: {
    type: "array"
    items: {
      type: "object"
      description: "The `Media` object contains a reference for most any media associated with a team or event on TBA."
      required: ["type", "foreign_key"]
      properties: {
        details: {
          type: "object"
          description: "If required, a JSON dict of additional media information."
          properties: {}
        }
        direct_url: {
          type: "string"
          description: "Direct URL to the media."
        }
        foreign_key: {
          type: "string"
          description: "The key used to identify this media on the media site."
        }
        preferred: {
          type: "boolean"
          description: "True if the media is of high quality."
        }
        type: {
          type: "string"
          description: "String type of the media element."
          enum: ["youtube", "cdphotothread", "imgur", "facebook-profile", "youtube-channel", "twitter-profile", "github-profile", "instagram-profile", "periscope-profile", "grabcad", "instagram-image", "external-link", "avatar"]
        }
        view_url: {
          type: "string"
          description: "The URL that leads to the full web page for the media, if one exists."
        }
      }
    }
  }
}