Skip to main content
POST
Restore an earlier version of a tool
  • Business accounts only, with tools:build. The version’s code, inputs and outputs go live at once, for free. Restoring the live version, or the version it restored, changes nothing.
  • A version can be restored when code.get lists it as restorable: not one published before Pomerado kept a record of each version, or one taken down.
  • A public tool restores only a version Pomerado checked that keeps every input its callers send. Only an Owner or Admin signed in to the Dashboard restores a version Pomerado didn’t check, never an API key or an agent.
  • Callers: an API key, an MCP OAuth token or a Dashboard session.
  • Permission: tools:build.
  • Effect: Creates or changes something.
  • Errors: business_account_required, not_found, version_not_restorable, restore_changes_inputs, restore_unchecked, and the errors any request can get.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

a tool ID: tool_ and 32 lowercase hex digits

Example:

"tool_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"

number
string
required

The version's number, as code.get lists it

Response

The tool's code, with the restored version live

integration
object
required
tool
object
required
versions
object[]
required

The tool's versions, newest first, at most 100

files
object[]
required

The live version's files, by path

draft
object | null
required

Your team's draft of the tool, shared by every member, or null when it has none