Skip to main content
Every write that changes a worker’s number, original start date, entity or workspace attributes, or a record’s attributes, records one revision. Its entries hold each changed field’s old and new value. A write that changes nothing records no revision. The changed resource’s revision names its latest. A revision is visible to you when you can read at least one of its entries.

​
Attributes

​
string
Unique identifier for the revision, e.g. rv_8Hd2K.
​
string
Always revision.
​
string
The workspace the revision belongs to.
​
string
applied once its values are written. pending and cancelled are reserved for changes that wait for approval.
​
string | null
Why a cancelled revision ended: withdrawn, denied or invalid. Null unless it was cancelled.
​
string | null
Why the change was made, as sent in the write’s revision.reason.
​
string | null
The member who made the change. Null when Plane made it.
​
string | null
The surface the change came through: app, api, cli, mcp or agent. Null when Plane made it.
​
string
When the revision was made.
​
string | null
When its values were written.
​
string | null
When it was cancelled.
Example revision