api/graph2/schema/types/Change.gql

"""
A change represents a a change in the history.
"""
type Change {
  "A unique ID of the change."
  id: String!

  "The model of the changed object."
  model: ChangeModel!

  "The operation performed."
  op: String!

  "The author that performed the change."
  author: String!

  "Whether the change will be listed without a matching key."
  listed: Boolean!

  "The keys indexing this change."
  keys: [ChangeKey!]!

  "The date when the change happened."
  date: Time

  "The changed objects."
  objects: [ChangeObject!]!
}

union ChangeObject = Character | Channel | Log | Post | Story | Tag | Chapter | Comment | File

"""
A change key is a key associated with a change, used for filtering
and subscription. A log post edit has keys for both the log and post,
making it suitable to use it to patch an active log file.
"""
type ChangeKey {
  "The model the key is for."
  model: ChangeModel!

  "The model's id, or * if it's a key indicating a model list should be updated."
  id: String!
}

"""
See ChangeKey
"""
input ChangeKeyInput {
  "The model the key is for."
  model: ChangeModel!

  "The model's id, or * if it's a key indicating a model list should be updated."
  id: String!
}

"""
A model related to the change.
"""
enum ChangeModel {
  Character
  Channel
  Log
  Post
  Story
  Tag
  Chapter
  Comment
  File
}

"""
Optional filter for the changes query.
"""
input ChangesFilter {
  "The keys to query for."
  keys: [ChangeKeyInput!]

  "Only show changes by this author"
  author: String

  "Only show changes more recent than this date."
  earliestDate: Time

  "Limit the amount of results. This even goes for subscriptions!"
  limit: Int
}