Workflows

Restore an earlier version of a skill

SPENDS NOTHING. Publishes the old snapshot as a NEW version, live for the next run - agents and workflows using the skill pick it up. Append-only, so the restore can itself be rolled back. Routine-managed skills refuse (403). A restored graph with record steps or a record trigger needs the same object scopes as a create or an update (403 missing_scopes), a restored graph whose snake_case and camelCase node keys disagree is refused (422 conflicting_node_keys), and a restore that changes such a workflow's graph is refused (403 owner_or_admin_required) unless the key's member owns the workflow or administers the org. The version's graph is read first to run those checks: 404 when it cannot be found (unknown skill or version).

post/skills/{action_id}/versions/{version_id}/restore

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/skills/{action_id}/versions/{version_id}/restore
  • Auth: HTTP bearer

Path parameters

action_idstring required

Skill (action) id.

version_idstring required

The version to bring back.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Response

Successful Response

dataVoicePayload required

One voice object - a collection, an agent, a route, a chat.

Open-shaped: voice adds fields to these bodies on its own release cadence and a dropped-or-added key must not be a 500 in this service.

Changes

No recorded changes to this operation across all 2 revisions of this API.