title: mediawiki/page/restrictions-change
description: Represents a MW Page Restrictions Change event.
$id: /mediawiki/page/restrictions-change/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
  - reason
  - 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
  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_restrictions:
    description: >
      The new restrictions applied to the page. If one of the properties is
      present, that means the specific action has been restricted to a member of
      a specific user group. An empty string means that a particular action is
      not restricted.
    type: object
    additionalProperties:
      type: string
  page_title:
    description: The normalized title of the page.
    type: string
    minLength: 1
  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.
    type: object
    properties:
      page_restrictions:
        type: object
        additionalProperties:
          type: string
  reason:
    description: Explanation of the reason for protecting the page.
    type: string
  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/restrictions-change/1.0.0
    database: examplewiki
    meta:
      dt: '2020-07-01T00:00:00Z'
      stream: medaiwiki.page-restrictions-change
    page_id: 123
    page_is_redirect: false
    page_namespace: 0
    page_title: example_page_title
    reason: example_reason
    rev_id: 123