WorkspaceMigration

A move's consequence, and the token that proves it was shown.

The same contract as [WorkspaceConfirmation], for a different question. The token is bound to this workspace and this destination: a person shown "these four terminals will close, and Notes goes to Home" has not accepted anything about a move to some other profile, and a dialog that could round-trip one token into a different destination would make the acceptance meaningless.

from is here because the dialog names both ends of the move, and reading it off the catalog separately would be a second chance to be out of date in a different way than the operation is.

Type object

Shape

Field	Type	Description
confirmationrequired	string
workspacerequired	string
fromrequired	string	The profile that owns it now.
torequired	string	The profile it would move to.
sessionsrequired	array of WorkspaceSessionConsequence	The terminals the move would close, in the order it would close them. Empty when the workspace is already owned by `to` - a move that has nothing to do closes nothing.
expires_atrequired	integer (int64)

Example

{
  "confirmation": "string",
  "workspace": "string",
  "from": "string",
  "to": "string",
  "sessions": [
    {
      "id": "string",
      "display_name": "string",
      "working_directory": "string"
    }
  ],
  "expires_at": 0
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Used by

POST/v1/workspaces/{id}/migration/confirmation
Compute what moving a workspace to a profile would close, and issue the token that proves it was shown

Generated from contract version 1. Last updated November 12, 2026.