action mastodon_post_api_v1_media {
  label: "post_api_v1_media"
  description: "Creates an attachment to be used with a new status."
  provider: mastodon
  method: POST
  path: "/api/v1/media"
  encoding: json
  output: {
    description: "Represents a file or media attachment that can be added to a status."
    required: ["id", "preview_url", "type", "url"]
    properties: {
      blurhash: {
        type: "string"
        description: "A hash computed by the [BlurHash algorithm](https://github.com/woltapp/blurhash), for generating colorful preview thumbnails when media has not been downloaded yet."
      }
      description: {
        type: "string"
        description: "Alternate text that describes what is in the media attachment, to be used for the visually impaired or when media attachments do not load."
      }
      id: {
        type: "string"
        description: "The ID of the attachment in the database. Cast from an integer but not guaranteed to be a number"
      }
      meta: {
        type: "object"
        description: "Metadata returned by Paperclip."
      }
      preview_url: {
        type: "string"
        description: "The location of a scaled-down preview of the attachment."
      }
      remote_url: {
        type: "string"
        description: "The location of the full-size original attachment on the remote website. String or null if the attachment is local."
      }
      text_url: {
        type: "string"
        description: "A shorter URL for the attachment."
      }
      type: {
        type: "string"
        description: "The type of the attachment."
        enum: ["unknown", "image", "gifv", "video", "audio"]
      }
      url: {
        type: "string"
        description: "The location of the original full-size attachment."
      }
    }
  }
}