Clone MCP Box Snapshot

curl --request POST \
  --url https://api.continuouslabs.ai/v1/mcpbox-snapshots/{id}/clone \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "target_workspace_id": "<string>"
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.continuouslabs.ai/v1/mcpbox-snapshots/{id}/clone"

	payload := strings.NewReader("{\n  \"target_workspace_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

import requests

url = "https://api.continuouslabs.ai/v1/mcpbox-snapshots/{id}/clone"

payload = { "target_workspace_id": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({target_workspace_id: '<string>'})
};

fetch('https://api.continuouslabs.ai/v1/mcpbox-snapshots/{id}/clone', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "actors": [
    {
      "default": true,
      "entity": "<string>",
      "id": "<string>",
      "name": "<string>",
      "role": "<string>"
    }
  ],
  "apibox_snapshot_id": "<string>",
  "build": {
    "hidden_limitations": 1,
    "last_submission": "accepted",
    "last_tool": "<string>",
    "limitations": [
      {
        "location": "<string>",
        "message": "<string>",
        "operations": [
          "<string>"
        ],
        "reviewed": true
      }
    ],
    "model": "gpt-6-astra",
    "phase": "research",
    "review_round": 5,
    "review_rounds": 5,
    "stage": "derive",
    "submissions": 1,
    "tool_calls": 1,
    "waited_seconds": 1,
    "waiting": {
      "credential_ids": [
        "<string>"
      ],
      "deadline": "2023-11-07T05:31:56Z",
      "reason": "<string>",
      "since": "2023-11-07T05:31:56Z",
      "type": "live_credentials"
    },
    "warnings": [
      {
        "code": "spec.enum_duplicate",
        "location": "<string>",
        "message": "<string>",
        "operations": [
          "<string>"
        ]
      }
    ]
  },
  "composition": {
    "entities": 123,
    "operations": 123,
    "sample": true
  },
  "created_at": "2023-11-07T05:31:56Z",
  "credential_ids": [
    "<string>"
  ],
  "error": {
    "agent_message": "<string>",
    "code": "build_failed",
    "detail": "<string>",
    "reason": "canceled",
    "validation": {
      "issues": [
        {
          "code": "<string>",
          "kind": "invalid",
          "location": "<string>",
          "message": "<string>",
          "operation": "<string>",
          "suggestion": "<string>"
        }
      ]
    }
  },
  "hidden_limitations": 1,
  "id": "<string>",
  "instructions": "<string>",
  "limitations": [
    {
      "location": "<string>",
      "message": "<string>",
      "operations": [
        "<string>"
      ],
      "reviewed": true
    }
  ],
  "metadata": "<unknown>",
  "name": "<string>",
  "parent_id": "<string>",
  "research": {
    "bytes": 1,
    "pages": 1,
    "status": "pending"
  },
  "source": "catalog",
  "source_box_id": "<string>",
  "source_snapshot_id": "<string>",
  "source_url": "<string>",
  "status": "pending"
}

MCP Box Snapshots

Clone MCP Box Snapshot

Creates a ready copy of a ready MCP Box Snapshot in another workspace, without a build. The clone has a new ID and the source’s artifact, documents and saved state; the source is unchanged. The clone records no credentials, since they belong to the source workspace, and no parent or source Snapshot. An API Box Snapshot of the source workspace that the MCP Box Snapshot was built against is cloned with it, and the clone is built against the copy; a catalog one is kept. The source is the caller’s workspace: an API key’s own workspace, or X-Workspace-Id for a session. An API key may clone into any other workspace of its organization.

POST

https://api.continuouslabs.ai

mcpbox-snapshots

{id}

clone

Clone MCP Box Snapshot

curl --request POST \
  --url https://api.continuouslabs.ai/v1/mcpbox-snapshots/{id}/clone \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "target_workspace_id": "<string>"
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.continuouslabs.ai/v1/mcpbox-snapshots/{id}/clone"

	payload := strings.NewReader("{\n  \"target_workspace_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

import requests

url = "https://api.continuouslabs.ai/v1/mcpbox-snapshots/{id}/clone"

payload = { "target_workspace_id": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({target_workspace_id: '<string>'})
};

fetch('https://api.continuouslabs.ai/v1/mcpbox-snapshots/{id}/clone', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "actors": [
    {
      "default": true,
      "entity": "<string>",
      "id": "<string>",
      "name": "<string>",
      "role": "<string>"
    }
  ],
  "apibox_snapshot_id": "<string>",
  "build": {
    "hidden_limitations": 1,
    "last_submission": "accepted",
    "last_tool": "<string>",
    "limitations": [
      {
        "location": "<string>",
        "message": "<string>",
        "operations": [
          "<string>"
        ],
        "reviewed": true
      }
    ],
    "model": "gpt-6-astra",
    "phase": "research",
    "review_round": 5,
    "review_rounds": 5,
    "stage": "derive",
    "submissions": 1,
    "tool_calls": 1,
    "waited_seconds": 1,
    "waiting": {
      "credential_ids": [
        "<string>"
      ],
      "deadline": "2023-11-07T05:31:56Z",
      "reason": "<string>",
      "since": "2023-11-07T05:31:56Z",
      "type": "live_credentials"
    },
    "warnings": [
      {
        "code": "spec.enum_duplicate",
        "location": "<string>",
        "message": "<string>",
        "operations": [
          "<string>"
        ]
      }
    ]
  },
  "composition": {
    "entities": 123,
    "operations": 123,
    "sample": true
  },
  "created_at": "2023-11-07T05:31:56Z",
  "credential_ids": [
    "<string>"
  ],
  "error": {
    "agent_message": "<string>",
    "code": "build_failed",
    "detail": "<string>",
    "reason": "canceled",
    "validation": {
      "issues": [
        {
          "code": "<string>",
          "kind": "invalid",
          "location": "<string>",
          "message": "<string>",
          "operation": "<string>",
          "suggestion": "<string>"
        }
      ]
    }
  },
  "hidden_limitations": 1,
  "id": "<string>",
  "instructions": "<string>",
  "limitations": [
    {
      "location": "<string>",
      "message": "<string>",
      "operations": [
        "<string>"
      ],
      "reviewed": true
    }
  ],
  "metadata": "<unknown>",
  "name": "<string>",
  "parent_id": "<string>",
  "research": {
    "bytes": 1,
    "pages": 1,
    "status": "pending"
  },
  "source": "catalog",
  "source_box_id": "<string>",
  "source_snapshot_id": "<string>",
  "source_url": "<string>",
  "status": "pending"
}

Authorizations

Authorization

string

header

required

Use a Continuous API key. Send it in the Authorization header as a Bearer token.

Headers

Idempotency-Key

string

Optional key for retrying this create safely. A retry with the same key and request returns the original clone; the same key with a different request returns 409 idempotency_conflict. Without a key, each request creates a new clone. Keys are scoped to the target workspace.

Maximum string length: 256

Path Parameters

string

required

Source Snapshot ID.

Pattern: ^mbs_[0-9A-HJKMNP-TV-Z]{26}$

Body

application/json

target_workspace_id

string

required

Workspace that receives the clone. It must differ from the source workspace.

Minimum string length: 1

name

string

Name for the clone. Defaults to the source Snapshot's name.

Maximum string length: 128

Response

Created

actors

object[]

required

The callers a request to a Box started from the Snapshot can act as by sending an actor's id in the X-Continuous-Actor header. Without the header, a request acts as the default actor. An MCP Box Snapshot lists its API Box Snapshot's actors. A Web Box Snapshot lists its one actor, the account every page is served as, which no header selects. Empty before the Snapshot is ready, when its build names none, or in a list until the Snapshot's actors are first read.

Show child attributes

apibox_snapshot_id

string

required

The API Box Snapshot the MCP Box was built against, whose API it calls.

Pattern: ^abs_[0-9A-HJKMNP-TV-Z]{26}$

build

object | null

required

The build's latest progress report, or null before the first report. A settled Snapshot keeps its last report. A build waiting for its live credentials resumes when the Snapshot's resume is requested.

Show child attributes

composition

object | null

required

What a ready Snapshot serves, or null.

Show child attributes

created_at

string<date-time>

required

Snapshot creation time.

credential_ids

string[]

required

Workspace credentials the build used, such as a web app login or credentials it was allowed to call real systems with. Empty when none.

error

object | null

required

Why the build failed or was canceled, or null.

Show child attributes

hidden_limitations

integer<int64>

required

Limitations the Snapshot records beyond those listed in limitations.

Required range: x >= 0

string

required

MCP Box Snapshot ID.

Pattern: ^mbs_[0-9A-HJKMNP-TV-Z]{26}$

instructions

string

required

The instructions the build followed, or empty when none were given.

limitations

object[]

required

Behavior the Snapshot does not serve like the real system, most important first. Empty when none.

Show child attributes

metadata

any

required

Customer JSON metadata, or null.

name

string

required

Snapshot name. The ID is its identity, and names need not be unique.

Maximum string length: 128

parent_id

string | null

required

The Snapshot an incremental build started from, or null for any other Snapshot or once that Snapshot is deleted.

research

object | null

required

The build's research stage, or null when research did not run.

Show child attributes

source

enum<string>

required

catalog for a Snapshot Continuous publishes, build for one built or published into the workspace, box for one saved from an MCP Box.

Available options:

catalog,

build,

box

source_box_id

string | null

required

The box the Snapshot was saved from, or null for a built or published Snapshot.

source_snapshot_id

string | null

required

The Snapshot the box it was saved from started from, or null for a built or published Snapshot, or once that Snapshot is deleted.

source_url

string

required

The source MCP server whose tools the MCP Box serves, or empty when the build called no live source.

status

enum<string>

required

pending while waiting for capacity; building while the build runs; ready when boxes can start from it; failed when the build failed; canceled when a cancel request took effect.

Available options:

pending,

building,

ready,

failed,

canceled

Using the API

API Boxes

API Box Snapshots

Web Boxes

Web Box Snapshots

MCP Boxes

MCP Box Snapshots

Credentials

Deprecated

Clone MCP Box Snapshot

Authorizations

Headers

Path Parameters

Body

Response