ChangeStage

One approval gate on a change: what it asked for, where it got to, and the decisions recorded at it.

  • object
    Type: string

    Resource type identifier

  • blocked
    Type: boolean

    Whether the gate can still be cleared by the people eligible for it. Only ever true of the gate collecting signatures

  • rule_id
    Type: string

    The rule that demanded this gate. Null on a gate an override created

  • rule_revision_id
    Type: string

    The exact immutable revision of that rule which fired. Null on a gate an override created

  • votes
    Type: array of ChangeVote

    What was decided here, oldest first. Empty until somebody acts

    Properties: 7
  • opened_at
    Type: string

    When the gate started collecting signatures. Null while it waits behind an earlier gate

  • settled_at
    Type: string

    When the gate reached a decision. Null while it is still collecting

  • created_at
    Type: string

    When the gate was created, which is when the change was submitted

  • id
    Type: string

    Approval stage typeid (prefix chs_)

  • stage_no
    Type: integer

    Position in the run, from 1. Gates are cleared in this order

  • label
    Type: string

    What the gate is called, as the rule's author wrote it, frozen when the change was submitted

  • quorum
    Type: integer

    How many people must approve

  • exclude_requester
    Type: boolean

    Whether the person who submitted the change is barred from clearing this gate themselves

  • state
    Type: stringenum

    Where the gate stands. One of waiting, open, cleared, rejected, overridden

    values
    waitingopenclearedrejectedoverridden
  • approvals_cast
    Type: integer

    How many approvals stand at this gate

  • approvers_live
    Type: integer

    How many people are still eligible to clear it. Zero on a gate that has not opened: a gate resolves the people it asks at the moment it opens