api/graph2/schema/types/File.gql

# A File contains information about a file and where to download it.
type File {
  # The file's unique ID
  id: String!

  # The kind of file. Most will be "upload", but some that are ported from the wiki will have other values for this.
  kind: String!

  # The time of uploading
  time: Time!

  # Whether the file is publicly listable. Someone with knowledge of the ID
  # will still be able to view it, however.
  public: Boolean!

  # The file's name
  name: String!

  # The MIME type of the file
  mimeType: String!

  # The file's size in bytes
  size: Int!

  # The uploader
  author: String!

  # The URL where the file is hosted
  url: String
}

# Filter for the files quiery.
input FilesFilter {
  # If set, this will limit the results to either public or private files.
  public: Boolean

  # Limit the MIME types of the files.
  mimeTypes: [String!]
}

# Input for uploadFile mutation
input FileUploadInput {
  "The file name"
  name: String!

  # Whether the file should be public
  public: Boolean!

  # The actual file upload
  file: Upload!
}

# Input for editFile mutation
input FileEditInput {
  # The file's unique ID
  id: String!

  # Whether the file is publicly listable. Someone with knowledge of the ID
  # will still be able to view it, however.
  public: Boolean

  # The file's name
  name: String
}

# Input for removeFile mutation
input FileRemoveInput {
  # The file's unique ID
  id: String!
}