curl --request POST \
--url https://data.wazoo.dev/worlds \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"displayName": "<string>",
"embeddingModel": "<string>",
"chunkSize": 1,
"topK": 1,
"minScore": 0.5
}
'import requests
url = "https://data.wazoo.dev/worlds"
payload = {
"displayName": "<string>",
"embeddingModel": "<string>",
"chunkSize": 1,
"topK": 1,
"minScore": 0.5
}
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({
displayName: '<string>',
embeddingModel: '<string>',
chunkSize: 1,
topK: 1,
minScore: 0.5
})
};
fetch('https://data.wazoo.dev/worlds', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://data.wazoo.dev/worlds",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'displayName' => '<string>',
'embeddingModel' => '<string>',
'chunkSize' => 1,
'topK' => 1,
'minScore' => 0.5
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://data.wazoo.dev/worlds"
payload := strings.NewReader("{\n \"displayName\": \"<string>\",\n \"embeddingModel\": \"<string>\",\n \"chunkSize\": 1,\n \"topK\": 1,\n \"minScore\": 0.5\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))
}HttpResponse<String> response = Unirest.post("https://data.wazoo.dev/worlds")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"displayName\": \"<string>\",\n \"embeddingModel\": \"<string>\",\n \"chunkSize\": 1,\n \"topK\": 1,\n \"minScore\": 0.5\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://data.wazoo.dev/worlds")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"displayName\": \"<string>\",\n \"embeddingModel\": \"<string>\",\n \"chunkSize\": 1,\n \"topK\": 1,\n \"minScore\": 0.5\n}"
response = http.request(request)
puts response.read_body{
"name": "<string>",
"uid": "<string>",
"displayName": "<string>",
"state": "<string>",
"storage": "d1",
"embeddingModel": "<string>",
"chunkSize": 123,
"topK": 123,
"minScore": 123,
"createTime": "<string>",
"updateTime": "<string>",
"deleteTime": "<string>",
"expireTime": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}Create world
Create a new world. Allocates a new world_uid in the shared D1 database and initializes the search and vector indexes.
curl --request POST \
--url https://data.wazoo.dev/worlds \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"displayName": "<string>",
"embeddingModel": "<string>",
"chunkSize": 1,
"topK": 1,
"minScore": 0.5
}
'import requests
url = "https://data.wazoo.dev/worlds"
payload = {
"displayName": "<string>",
"embeddingModel": "<string>",
"chunkSize": 1,
"topK": 1,
"minScore": 0.5
}
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({
displayName: '<string>',
embeddingModel: '<string>',
chunkSize: 1,
topK: 1,
minScore: 0.5
})
};
fetch('https://data.wazoo.dev/worlds', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://data.wazoo.dev/worlds",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'displayName' => '<string>',
'embeddingModel' => '<string>',
'chunkSize' => 1,
'topK' => 1,
'minScore' => 0.5
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://data.wazoo.dev/worlds"
payload := strings.NewReader("{\n \"displayName\": \"<string>\",\n \"embeddingModel\": \"<string>\",\n \"chunkSize\": 1,\n \"topK\": 1,\n \"minScore\": 0.5\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))
}HttpResponse<String> response = Unirest.post("https://data.wazoo.dev/worlds")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"displayName\": \"<string>\",\n \"embeddingModel\": \"<string>\",\n \"chunkSize\": 1,\n \"topK\": 1,\n \"minScore\": 0.5\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://data.wazoo.dev/worlds")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"displayName\": \"<string>\",\n \"embeddingModel\": \"<string>\",\n \"chunkSize\": 1,\n \"topK\": 1,\n \"minScore\": 0.5\n}"
response = http.request(request)
puts response.read_body{
"name": "<string>",
"uid": "<string>",
"displayName": "<string>",
"state": "<string>",
"storage": "d1",
"embeddingModel": "<string>",
"chunkSize": 123,
"topK": 123,
"minScore": 123,
"createTime": "<string>",
"updateTime": "<string>",
"deleteTime": "<string>",
"expireTime": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}Authorizations
Worlds API data-plane token.
Body
User-facing display name for the new world.
Embedding model to use for vector search. Defaults to the platform default.
Maximum quads per chunk for vector search indexing. Defaults to the platform default.
x > 0Default number of top results for search queries against this world.
x > 0Default minimum relevance score (0–1) for search results in this world.
0 <= x <= 1Response
Created World
Resource name in the form worlds/, e.g. worlds/w_a1b2c3d4.
Unique world identifier, e.g. w_.
User-facing display name for the world. Set on creation or update.
Lifecycle state: active, deleted, or suspended. Deleted worlds enter a 30-day grace period before permanent purge.
Storage backend for the world. All worlds share a single Cloudflare D1 database, separated by world_uid.
d1 Embedding model identifier used for vector search indexing, e.g. openai/text-embedding-3-small.
Maximum number of RDF quads per chunk when indexing for vector search.
Default number of top search results to return when the caller does not override.
Default minimum relevance score (0–1) for search results. Results below this threshold are omitted.
ISO 8601 timestamp when the world was created.
ISO 8601 timestamp when the world was last updated.
ISO 8601 timestamp when the world was soft-deleted. Null if not deleted.
ISO 8601 timestamp when the world will be permanently purged after the grace period. Null if not scheduled for purge.