curl --request POST \
--url https://api.pyai.com/v1/managed-tenants \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"external_workspace_id": "<string>",
"name": "<string>",
"knowledge_enabled": false,
"monthly_budget_cents": 2
}
'import requests
url = "https://api.pyai.com/v1/managed-tenants"
payload = {
"external_workspace_id": "<string>",
"name": "<string>",
"knowledge_enabled": False,
"monthly_budget_cents": 2
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
external_workspace_id: '<string>',
name: '<string>',
knowledge_enabled: false,
monthly_budget_cents: 2
})
};
fetch('https://api.pyai.com/v1/managed-tenants', 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://api.pyai.com/v1/managed-tenants",
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([
'external_workspace_id' => '<string>',
'name' => '<string>',
'knowledge_enabled' => false,
'monthly_budget_cents' => 2
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$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://api.pyai.com/v1/managed-tenants"
payload := strings.NewReader("{\n \"external_workspace_id\": \"<string>\",\n \"name\": \"<string>\",\n \"knowledge_enabled\": false,\n \"monthly_budget_cents\": 2\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
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://api.pyai.com/v1/managed-tenants")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"external_workspace_id\": \"<string>\",\n \"name\": \"<string>\",\n \"knowledge_enabled\": false,\n \"monthly_budget_cents\": 2\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pyai.com/v1/managed-tenants")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"external_workspace_id\": \"<string>\",\n \"name\": \"<string>\",\n \"knowledge_enabled\": false,\n \"monthly_budget_cents\": 2\n}"
response = http.request(request)
puts response.read_body{
"object": "managed_tenant",
"version": "managed-tenant/v1",
"operation_id": "<string>",
"external_workspace_id": "<string>",
"request_hash": "<string>",
"idempotency_key": "<string>",
"parent_org_id": "<string>",
"payer_org_id": "<string>",
"child_org_id": "<string>",
"project_id": "<string>",
"key_id": "<string>",
"status": "provisioned",
"calling_ready": false,
"monthly_budget_cents": 2,
"scopes": [
"<string>"
],
"secret": "<string>"
}Provision an isolated managed workspace
Requires the exact tenants:provision scope and an operator-registered active integration bound to the authenticated live parent organization, project and key. Wildcards do not grant this capability. Atomically creates an isolated child organization, live project, narrowly scoped key and immutable payer link. Countries and limits derive from approved integration defaults; the child calling policy starts suspended. No customer login, number purchase, consent or billing readiness is implied. Optional platform guidance is granted only by explicit approved integration delegation, never request fields or wildcard scopes. Repeating the original Idempotency-Key, external workspace and input recovers the original resources and encrypted credential; any changed key or input conflicts. There is no public integration-registration endpoint. Recovery proof: require idempotency_key to equal your durable original Idempotency-Key and request_hash to equal your saved request fingerprint before accepting resources or credentials. A mismatch is a conflict, never automatic adoption. Compute lowercase hexadecimal SHA-256 of UTF-8 JSON.stringify of an object with keys inserted in this exact order: externalWorkspaceId (the exact external_workspace_id, no trimming or case conversion), name (JavaScript String.trim of the submitted name, preserving interior whitespace and case), knowledgeEnabled (knowledge_enabled === true; omitted means false), followed by monthlyBudgetCents only when monthly_budget_cents was present, preserving its integer or null value. JSON has no extra whitespace. Omission and explicit null are distinct; registered defaults are not substituted into the request hash.
curl --request POST \
--url https://api.pyai.com/v1/managed-tenants \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"external_workspace_id": "<string>",
"name": "<string>",
"knowledge_enabled": false,
"monthly_budget_cents": 2
}
'import requests
url = "https://api.pyai.com/v1/managed-tenants"
payload = {
"external_workspace_id": "<string>",
"name": "<string>",
"knowledge_enabled": False,
"monthly_budget_cents": 2
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
external_workspace_id: '<string>',
name: '<string>',
knowledge_enabled: false,
monthly_budget_cents: 2
})
};
fetch('https://api.pyai.com/v1/managed-tenants', 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://api.pyai.com/v1/managed-tenants",
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([
'external_workspace_id' => '<string>',
'name' => '<string>',
'knowledge_enabled' => false,
'monthly_budget_cents' => 2
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$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://api.pyai.com/v1/managed-tenants"
payload := strings.NewReader("{\n \"external_workspace_id\": \"<string>\",\n \"name\": \"<string>\",\n \"knowledge_enabled\": false,\n \"monthly_budget_cents\": 2\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
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://api.pyai.com/v1/managed-tenants")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"external_workspace_id\": \"<string>\",\n \"name\": \"<string>\",\n \"knowledge_enabled\": false,\n \"monthly_budget_cents\": 2\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pyai.com/v1/managed-tenants")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"external_workspace_id\": \"<string>\",\n \"name\": \"<string>\",\n \"knowledge_enabled\": false,\n \"monthly_budget_cents\": 2\n}"
response = http.request(request)
puts response.read_body{
"object": "managed_tenant",
"version": "managed-tenant/v1",
"operation_id": "<string>",
"external_workspace_id": "<string>",
"request_hash": "<string>",
"idempotency_key": "<string>",
"parent_org_id": "<string>",
"payer_org_id": "<string>",
"child_org_id": "<string>",
"project_id": "<string>",
"key_id": "<string>",
"status": "provisioned",
"calling_ready": false,
"monthly_budget_cents": 2,
"scopes": [
"<string>"
],
"secret": "<string>"
}Authorizations
Body
Response
Original managed workspace and credential, including an exact retry.