Build Simulator

curl --request POST \
  --url https://api.continuouslabs.ai/v1/simulators \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'request={
  "filter": [],
  "instructions": "Return stable example data for every operation.",
  "model": "claude-fable-5-1",
  "name": "billing-api",
  "spec_kind": "openapi"
};type=application/json' \
  --form 'spec=@example-file;type=application/octet-stream'

package main

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

func main() {

	url := "https://api.continuouslabs.ai/v1/simulators"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"request\"\r\nContent-Type: application/json\r\n\r\n{\r\n  \"filter\": [],\r\n  \"instructions\": \"Return stable example data for every operation.\",\r\n  \"model\": \"claude-fable-5-1\",\r\n  \"name\": \"billing-api\",\r\n  \"spec_kind\": \"openapi\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"spec\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "multipart/form-data")

	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/simulators"

files = { "spec": ("example-file", open("example-file", "rb"), "application/octet-stream") }
files["request"] = (None, "{\n  \"filter\": [],\n  \"instructions\": \"Return stable example data for every operation.\",\n  \"model\": \"claude-fable-5-1\",\n  \"name\": \"billing-api\",\n  \"spec_kind\": \"openapi\"\n}", "application/json")
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('request', '{
  "filter": [],
  "instructions": "Return stable example data for every operation.",
  "model": "claude-fable-5-1",
  "name": "billing-api",
  "spec_kind": "openapi"
}');
form.append('spec', '{
  "fileName": "example-file"
}');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://api.continuouslabs.ai/v1/simulators', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "build": {
    "hidden_limitations": 0,
    "last_submission": "rejected",
    "last_tool": "test",
    "limitations": [],
    "model": "claude-fable-5-1",
    "phase": "build",
    "review_round": 0,
    "review_rounds": 1,
    "stage": "build",
    "submissions": 1,
    "tool_calls": 7,
    "warnings": []
  },
  "created_at": "2026-01-15T12:00:00Z",
  "credential_ids": [],
  "error": null,
  "id": "smr_01J8Z5X4K7M2N9P0Q1R2S3T4V5",
  "instructions": "Return stable example data for every operation.",
  "mode": "api",
  "name": "billing-api",
  "parent_id": "smr_01J8Z5X4K7M2N9P0Q1R2S3T4V9",
  "publication": null,
  "research": null,
  "source": "workspace",
  "spec_kind": "openapi",
  "status": "building"
}

Simulators

Build Simulator

Starts an asynchronous Simulator build and returns the Simulator with status pending. Builds start in queue order when workspace capacity is available. Send multipart/form-data with a JSON part named request. To build from a document, add a file part named spec with the OpenAPI, WSDL or GraphQL document. For an incremental build, omit spec and set parent_id and instructions. Add file parts named document to give the builder and reviewer vendor documentation.

POST

https://api.continuouslabs.ai

simulators

Build Simulator

curl --request POST \
  --url https://api.continuouslabs.ai/v1/simulators \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'request={
  "filter": [],
  "instructions": "Return stable example data for every operation.",
  "model": "claude-fable-5-1",
  "name": "billing-api",
  "spec_kind": "openapi"
};type=application/json' \
  --form 'spec=@example-file;type=application/octet-stream'

package main

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

func main() {

	url := "https://api.continuouslabs.ai/v1/simulators"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"request\"\r\nContent-Type: application/json\r\n\r\n{\r\n  \"filter\": [],\r\n  \"instructions\": \"Return stable example data for every operation.\",\r\n  \"model\": \"claude-fable-5-1\",\r\n  \"name\": \"billing-api\",\r\n  \"spec_kind\": \"openapi\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"spec\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "multipart/form-data")

	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/simulators"

files = { "spec": ("example-file", open("example-file", "rb"), "application/octet-stream") }
files["request"] = (None, "{\n  \"filter\": [],\n  \"instructions\": \"Return stable example data for every operation.\",\n  \"model\": \"claude-fable-5-1\",\n  \"name\": \"billing-api\",\n  \"spec_kind\": \"openapi\"\n}", "application/json")
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('request', '{
  "filter": [],
  "instructions": "Return stable example data for every operation.",
  "model": "claude-fable-5-1",
  "name": "billing-api",
  "spec_kind": "openapi"
}');
form.append('spec', '{
  "fileName": "example-file"
}');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://api.continuouslabs.ai/v1/simulators', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "build": {
    "hidden_limitations": 0,
    "last_submission": "rejected",
    "last_tool": "test",
    "limitations": [],
    "model": "claude-fable-5-1",
    "phase": "build",
    "review_round": 0,
    "review_rounds": 1,
    "stage": "build",
    "submissions": 1,
    "tool_calls": 7,
    "warnings": []
  },
  "created_at": "2026-01-15T12:00:00Z",
  "credential_ids": [],
  "error": null,
  "id": "smr_01J8Z5X4K7M2N9P0Q1R2S3T4V5",
  "instructions": "Return stable example data for every operation.",
  "mode": "api",
  "name": "billing-api",
  "parent_id": "smr_01J8Z5X4K7M2N9P0Q1R2S3T4V9",
  "publication": null,
  "research": null,
  "source": "workspace",
  "spec_kind": "openapi",
  "status": "building"
}

Authorizations

Authorization

string

header

required

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

Body

multipart/form-data

request

object

required

Build options as JSON.

Show child attributes

Example:

{
  "filter": [],
  "instructions": "Return stable example data for every operation.",
  "model": "claude-fable-5-1",
  "name": "billing-api",
  "spec_kind": "openapi"
}

document

file[]

Vendor documentation the builder and reviewer read before they start, as repeated file parts: UTF-8 text (.md, .txt, .html, .json, .yaml, .xml, .csv) or PDF (.pdf). The documents share the request body limit with the spec. An incremental build inherits its parent's documents and index; a document sent with the same name replaces the parent's. A document named INDEX.md indexes the others and skips research; the build fails if it names a document the build does not have, leaves a document unnamed, or leaves out a selected operation; an incremental build's documents include the inherited ones.

spec

file

OpenAPI, WSDL or GraphQL document, UTF-8 encoded, at most 64 MiB. Required unless the request is an incremental build (parent_id and instructions, no spec).

Response

Accepted

build

object | null

required

The build's latest progress report, or null before the first report. A terminal Simulator keeps its last report.

Show child attributes

created_at

string<date-time>

required

Simulator creation time.

credential_ids

string[]

required

Workspace credentials the build 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

string

required

Simulator ID.

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

instructions

string

required

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

mode

enum<string>

required

api for a Simulator of the vendor's API; web_app for one of its logged-in web app.

Available options:

api,

web_app

name

string

required

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

Maximum string length: 128

parent_id

string | null

required

Parent Simulator ID, or null.

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

publication

object | null

required

The latest attempt to publish the Simulator's image into the workspace's default customer runtime environment, or null when the workspace has none, no attempt is recorded, or the response does not report it. Get and list report it.

Show child attributes

research

object | null

required

The build's research stage, or null for a Simulator built before research ran on every build.

Show child attributes

source

enum<string>

required

workspace for a Simulator your workspace built; catalog for a read-only Simulator that Continuous publishes.

Available options:

workspace,

catalog

spec_kind

enum<string> | null

required

The specification the Simulator was built from, or null until a build has read it. recorded is a Web App Simulator's: the calls its discovery journeys captured.

Available options:

openapi,

wsdl,

graphql,

recorded,

null

status

enum<string>

required

pending while waiting for capacity; building while the build runs; ready when Simulations, Worlds, and incremental builds can use it; failed when the build failed; canceled when a cancel request took effect.

Available options:

pending,

building,

ready,

failed,

canceled

Using the API

Simulators

Simulations

Worlds

Credentials

Build Simulator

Authorizations

Body

Response