Skip to content

by Startups.Studio

Product Build and ship Change

Change.revert

POST /{namespace}/changes/{change}/revert

Revert undoes a merged Change with a new Change and a superseding Decision, deleting nothing.

Noun: Change
Mode: do
Event: Change.reverted

You, to your agent

Revert the latest change.

curl -X POST https://api.sb/quietcopy.com/changes/change_1/revert \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason":"Example reason"}'

import { $ } from 'startup-builder'

const revert = await $.Change.revert({ change: 'change_1', reason: 'Example reason' })

npx startup-builder do Change.revert --json '{"change":"change_1","reason":"Example reason"}'

{
  "name": "do",
  "arguments": {
    "code": "return await $.Change.revert({ change: 'change_1', reason: 'Example reason' })"
  }
}

Inputs

Input	Type	Required	Description
`change`	Change	required	The merged Change to undo.
`reason`	`text`	required	Why it is undone.

Outputs

Output	Type	Required	Description
`revert`	Change	required	The Change that undoes it.

Effects

Emits Change.reverted.
Performed by the Engineering Lead.
Supersedes the Decision that caused the original Change.

Refuses when

Check	Error	Fix	Then call
The key is valid, but its scopes do not allow this operation.	`forbidden`	Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them.	Change.revert
The record is not in a state that allows this Verb, so the call is refused.	`refused`	Read the record, run the Verb that moves it to an allowed state, then retry.	Change.revert

When it waits

Gate	Default
Decision class	Low: two-way, nothing at stake
Delay window	None: it runs once review passes.
Limit	The call Limit of the Permission it runs under.
Over the Limit	It waits `pending` for an Approval from the Founder. Approved, it runs; refused, it ends `refused` with `limit-exceeded`; unanswered by its deadline, it ends `canceled`.

Change.merge

Previous Page

Change.review

Next Page