curl --request PATCH \
--url https://data.wazoo.dev/worlds/{id} \
--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/{id}"
payload = {
"displayName": "<string>",
"embeddingModel": "<string>",
"chunkSize": 1,
"topK": 1,
"minScore": 0.5
}
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({
displayName: '<string>',
embeddingModel: '<string>',
chunkSize: 1,
topK: 1,
minScore: 0.5
})
};
fetch('https://data.wazoo.dev/worlds/{id}', 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/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
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/{id}"
payload := strings.NewReader("{\n \"displayName\": \"<string>\",\n \"embeddingModel\": \"<string>\",\n \"chunkSize\": 1,\n \"topK\": 1,\n \"minScore\": 0.5\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))
}HttpResponse<String> response = Unirest.patch("https://data.wazoo.dev/worlds/{id}")
.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/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.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>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}Update world
Update a world’s display name, embedding model, or search configuration. Changing the embedding model triggers a reindex.
curl --request PATCH \
--url https://data.wazoo.dev/worlds/{id} \
--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/{id}"
payload = {
"displayName": "<string>",
"embeddingModel": "<string>",
"chunkSize": 1,
"topK": 1,
"minScore": 0.5
}
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({
displayName: '<string>',
embeddingModel: '<string>',
chunkSize: 1,
topK: 1,
minScore: 0.5
})
};
fetch('https://data.wazoo.dev/worlds/{id}', 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/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
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/{id}"
payload := strings.NewReader("{\n \"displayName\": \"<string>\",\n \"embeddingModel\": \"<string>\",\n \"chunkSize\": 1,\n \"topK\": 1,\n \"minScore\": 0.5\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))
}HttpResponse<String> response = Unirest.patch("https://data.wazoo.dev/worlds/{id}")
.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/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.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>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}Authorizations
Worlds API data-plane token.
Path Parameters
The canonical world_uid, e.g. w_.
Body
New display name for the world.
1New embedding model. Changing this triggers a reindex of existing data.
New chunk size for vector search indexing.
x > 0New default top-K for search queries.
x > 0New default minimum score threshold for search results.
0 <= x <= 1Response
Updated 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.