title: mediawiki/page/undelete
description: Represents a MW Page Undelete (restore) event.
$id: /mediawiki/page/undelete/1.0.0
$schema: 'https://json-schema.org/draft-07/schema#'
type: object
required:
  - $schema
  - database
  - meta
  - page_id
  - page_is_redirect
  - page_namespace
  - page_title
  - rev_id
properties:
  $schema:
    description: >
      A URI identifying the JSONSchema for this event. This should match an
      schema's $id in a schema repository. E.g. /schema/title/1.0.0
    type: string
  chronology_id:
    description: Deprecated - no longer populated
    type: string
  comment:
    description: The comment left by the user that performed this change.
    type: string
  database:
    description: The name of the wiki database this event entity belongs to.
    type: string
    minLength: 1
  meta:
    type: object
    required:
      - dt
      - stream
    properties:
      domain:
        description: Domain the event or entity pertains to
        type: string
        minLength: 1
      dt:
        description: 'UTC event datetime, in ISO-8601 format'
        type: string
        format: date-time
        maxLength: 128
      id:
        description: Unique ID of this event
        type: string
      request_id:
        description: Unique ID of the request that caused the event
        type: string
      stream:
        description: Name of the stream/queue/dataset that this event belongs in
        type: string
        minLength: 1
      uri:
        description: Unique URI identifying the event or entity
        type: string
        format: uri-reference
        maxLength: 8192
  page_id:
    description: The (database) page ID.
    type: integer
    maximum: 9007199254740991
    minimum: 0
  page_is_redirect:
    description: >
      True if this page is currently a redirect page.  This fact is ultimately
      represented by revision content containing redirect wikitext.  If rev_id's
      content has redirect wikitext, then this page is a redirect.  Note that
      this state is also stored on the Mediawiki page table.
    type: boolean
  page_namespace:
    description: The namespace ID this page belongs to.
    type: integer
    maximum: 9007199254740991
    minimum: -9007199254740991
  page_title:
    description: The normalized title of the page.
    type: string
    minLength: 1
  parsedcomment:
    description: >
      The comment left by the user that performed this change parsed into simple
      HTML. Optional
    type: string
  performer:
    description: Represents the user that performed this change.
    type: object
    required:
      - user_text
      - user_groups
      - user_is_bot
    properties:
      user_edit_count:
        description: >
          The number of edits this user has made at the time of this event. Not
          present for anonymous users.
        type: integer
        maximum: 9007199254740991
        minimum: 0
      user_groups:
        description: 'A list of the groups this user belongs to.  E.g. bot, sysop etc.'
        type: array
        items:
          type: string
          minLength: 1
      user_id:
        description: >
          The user id that performed this change.  This is optional, and will
          not be present for anonymous users.
        type: integer
        maximum: 9007199254740991
        minimum: -9007199254740991
      user_is_bot:
        description: >
          True if this user is considered to be a bot at the time of this event.
          This is checked via the $user->isBot() method, which considers both
          user_groups and user permissions.
        type: boolean
      user_registration_dt:
        description: >
          The datetime of the user account registration. Not present for
          anonymous users or if missing in the MW database.
        type: string
        format: date-time
        maxLength: 128
      user_text:
        description: The text representation of the user that performed this change.
        type: string
        minLength: 1
  prior_state:
    description: >
      The prior state of the entity before this event. If a top level entity
      field is not present in this object, then its value has not changed since
      the prior event.  If prior_state itself is not present, then this event
      had no relevant prior state, indicating that it is probably the first time
      this type has been emitted for this entity. For page undeletes,
      prior_state will be absent unless the page_id is no longer the same as the
      page_id it had before it was deleted.
    type: object
    required:
      - page_id
    properties:
      page_id:
        description: The page ID before this restore as it was in the archive table.
        type: integer
        maximum: 9007199254740991
        minimum: 1
  rev_id:
    description: The head revision of the page at the time of this event.
    type: integer
    maximum: 9007199254740991
    minimum: 0
examples:
  - $schema: /mediawiki/page/undelete/1.0.0
    database: examplewiki
    meta:
      dt: '2020-07-01T00:00:00Z'
      stream: medaiwiki.page-undelete
    page_id: 123
    page_is_redirect: false
    page_namespace: 0
    page_title: example_page_title
    prior_state:
      page_id: 123
    rev_id: 123