Update Web Box Snapshot

curl --request PATCH \
  --url https://api.continuouslabs.ai/v1/webbox-snapshots/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "metadata": "<unknown>",
  "name": "<string>"
}
'

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"metadata\": \"<unknown>\",\n  \"name\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", 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/webbox-snapshots/{id}"

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

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

print(response.text)

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

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

{
  "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"
    },
    "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>",
  "research": {
    "bytes": 1,
    "pages": 1,
    "status": "pending"
  },
  "source": "catalog",
  "status": "pending"
}

PATCH

https://api.continuouslabs.ai

webbox-snapshots

{id}

Update Web Box Snapshot

curl --request PATCH \
  --url https://api.continuouslabs.ai/v1/webbox-snapshots/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "metadata": "<unknown>",
  "name": "<string>"
}
'

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"metadata\": \"<unknown>\",\n  \"name\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", 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/webbox-snapshots/{id}"

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

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

print(response.text)

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

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

{
  "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"
    },
    "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>",
  "research": {
    "bytes": 1,
    "pages": 1,
    "status": "pending"
  },
  "source": "catalog",
  "status": "pending"
}

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Web Box Snapshot ID.

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

Body

application/json

metadata

any

Replacement customer JSON metadata, up to 16 KiB and 64 nesting levels, or null to clear it.

name

string

New Snapshot name.

Required string length: 1 - 128

Response

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 with POST /v1/webbox-snapshots/{id}/resume.

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: the Web App login, and any credentials it was allowed to call real systems with.

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

Web Box Snapshot ID.

Pattern: ^wbs_[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, whether it was built or published. 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

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 into the workspace.

Available options:

catalog,

build

status

enum<string>

required

pending while waiting for capacity; building while the build runs; ready when Web 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

Cloud Boxes

Cloud Box Snapshots

Credentials

Deprecated

Update Web Box Snapshot

Authorizations

Path Parameters

Body

Response