Saves an MCP Box and the API Box it fronts as a new MCP Box Snapshot and a new API Box Snapshot, both ready when the response returns, or neither. The API Box must be running; a paused one is woken, and it keeps running. The MCP Box Snapshot serves the MCP Box’s tools and is built against the API Box Snapshot, which holds the API Box’s service and current state. Create an API Box from apibox_snapshot_id, then an MCP Box from the MCP Box Snapshot in front of it. Both Snapshots outlive the Boxes. An MCP Box whose API Box was deleted returns 409 mcpbox_apibox_gone; a starting API Box returns 409 apibox_starting; a stopping or stopped one returns 409 apibox_stopped; one whose runtime cannot save its state returns 409 mcpbox_rebuild_required.
Alias: sms
Examples
Replace <id> with the resource ID from your response before you run the command.
Flags
Request body as JSON (alternative to individual flags). Can also be provided via stdin.
Optional key for retrying this save safely. A retry with the same key and request returns the Snapshot the first save created. The same key with a different request returns 409 idempotency_conflict.
Customer JSON metadata, up to 16 KiB and 64 nesting levels.
Name for the Snapshot. Omission generates a name.
