Skip to main content
Puts the content of that version back as the route’s current content. It does not mutate the history. A restore writes a new version copying the old one and records which one in restored_from, so the restore itself can be undone.

Endpoint

Required scope

agents:write

Path parameters

Example request

curl

Response

201 Created

400 Bad Request

version is not an integer of 1 or more, or routeId is not an ObjectId.

404 Not Found

AGENT_NOT_FOUND when the agent belongs to another project of the company, UPSTREAM_ERROR (message AGENT_NOT_FOUND) when no agent has that id in the company; route_not_found when the route is not the agent’s; version_not_found when the route has no such version.

401 Unauthorized

Missing, invalid, revoked, or expired token.

403 Forbidden

The token does not have the agents:write scope.

502 Bad Gateway

The agent service is unreachable.

Operational notes

  • The new version number is the next one, not the restored one.
  • The agent picks it up on its next turn.