curl --request PATCH \
--url https://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/versions/{versionId}/blueprint \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-workspace-id: <x-workspace-id>' \
--data '
{
"languageId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"personalityName": "<string>",
"personalityRole": "<string>",
"targetAudience": "<string>",
"mainGoal": "<string>",
"personalityInitialGreeting": "<string>",
"personalityMessageStyleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"personalityToneStyleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"voiceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiredData": [
"<string>"
],
"criticalRules": [
"<string>"
],
"topicsAllowed": [
"<string>"
],
"topicsForbidden": [
"<string>"
],
"outputVariables": [
{
"name": "<string>",
"description": "<string>",
"required": true,
"choices": [
"<string>"
]
}
]
}
'import requests
url = "https://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/versions/{versionId}/blueprint"
payload = {
"languageId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"personalityName": "<string>",
"personalityRole": "<string>",
"targetAudience": "<string>",
"mainGoal": "<string>",
"personalityInitialGreeting": "<string>",
"personalityMessageStyleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"personalityToneStyleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"voiceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiredData": ["<string>"],
"criticalRules": ["<string>"],
"topicsAllowed": ["<string>"],
"topicsForbidden": ["<string>"],
"outputVariables": [
{
"name": "<string>",
"description": "<string>",
"required": True,
"choices": ["<string>"]
}
]
}
headers = {
"x-workspace-id": "<x-workspace-id>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
'x-workspace-id': '<x-workspace-id>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
languageId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
personalityName: '<string>',
personalityRole: '<string>',
targetAudience: '<string>',
mainGoal: '<string>',
personalityInitialGreeting: '<string>',
personalityMessageStyleId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
personalityToneStyleId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
voiceId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
requiredData: ['<string>'],
criticalRules: ['<string>'],
topicsAllowed: ['<string>'],
topicsForbidden: ['<string>'],
outputVariables: [
{
name: '<string>',
description: '<string>',
required: true,
choices: ['<string>']
}
]
})
};
fetch('https://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/versions/{versionId}/blueprint', 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-prod.studio.getsupervisor.ai/v1/agents/{agentId}/versions/{versionId}/blueprint",
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([
'languageId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'personalityName' => '<string>',
'personalityRole' => '<string>',
'targetAudience' => '<string>',
'mainGoal' => '<string>',
'personalityInitialGreeting' => '<string>',
'personalityMessageStyleId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'personalityToneStyleId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'voiceId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'requiredData' => [
'<string>'
],
'criticalRules' => [
'<string>'
],
'topicsAllowed' => [
'<string>'
],
'topicsForbidden' => [
'<string>'
],
'outputVariables' => [
[
'name' => '<string>',
'description' => '<string>',
'required' => true,
'choices' => [
'<string>'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"x-workspace-id: <x-workspace-id>"
],
]);
$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-prod.studio.getsupervisor.ai/v1/agents/{agentId}/versions/{versionId}/blueprint"
payload := strings.NewReader("{\n \"languageId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"personalityName\": \"<string>\",\n \"personalityRole\": \"<string>\",\n \"targetAudience\": \"<string>\",\n \"mainGoal\": \"<string>\",\n \"personalityInitialGreeting\": \"<string>\",\n \"personalityMessageStyleId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"personalityToneStyleId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"voiceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"requiredData\": [\n \"<string>\"\n ],\n \"criticalRules\": [\n \"<string>\"\n ],\n \"topicsAllowed\": [\n \"<string>\"\n ],\n \"topicsForbidden\": [\n \"<string>\"\n ],\n \"outputVariables\": [\n {\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"required\": true,\n \"choices\": [\n \"<string>\"\n ]\n }\n ]\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-workspace-id", "<x-workspace-id>")
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://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/versions/{versionId}/blueprint")
.header("x-workspace-id", "<x-workspace-id>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"languageId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"personalityName\": \"<string>\",\n \"personalityRole\": \"<string>\",\n \"targetAudience\": \"<string>\",\n \"mainGoal\": \"<string>\",\n \"personalityInitialGreeting\": \"<string>\",\n \"personalityMessageStyleId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"personalityToneStyleId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"voiceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"requiredData\": [\n \"<string>\"\n ],\n \"criticalRules\": [\n \"<string>\"\n ],\n \"topicsAllowed\": [\n \"<string>\"\n ],\n \"topicsForbidden\": [\n \"<string>\"\n ],\n \"outputVariables\": [\n {\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"required\": true,\n \"choices\": [\n \"<string>\"\n ]\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/versions/{versionId}/blueprint")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["x-workspace-id"] = '<x-workspace-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"languageId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"personalityName\": \"<string>\",\n \"personalityRole\": \"<string>\",\n \"targetAudience\": \"<string>\",\n \"mainGoal\": \"<string>\",\n \"personalityInitialGreeting\": \"<string>\",\n \"personalityMessageStyleId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"personalityToneStyleId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"voiceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"requiredData\": [\n \"<string>\"\n ],\n \"criticalRules\": [\n \"<string>\"\n ],\n \"topicsAllowed\": [\n \"<string>\"\n ],\n \"topicsForbidden\": [\n \"<string>\"\n ],\n \"outputVariables\": [\n {\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"required\": true,\n \"choices\": [\n \"<string>\"\n ]\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"version": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": 2,
"hash": "<string>",
"createdAt": "2023-11-07T05:31:56Z"
},
"blueprintId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"languageId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"personalityName": "<string>",
"personalityRole": "<string>",
"targetAudience": "<string>",
"mainGoal": "<string>",
"personalityInitialGreeting": "<string>",
"personalityMessageStyleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"personalityToneStyleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiredData": [],
"contentHash": "<string>",
"contentVariables": [],
"variablesCache": [],
"outputVariables": [],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"voiceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"criticalRules": [],
"topicsAllowed": [],
"topicsForbidden": []
}{
"code": "<string>",
"message": "<string>",
"details": {
"subcode": "<string>",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"code": "<string>",
"message": "<string>",
"details": {
"subcode": "<string>",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"code": "<string>",
"message": "<string>",
"details": {
"subcode": "<string>",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}Actualizar blueprint de una versión del agente
curl --request PATCH \
--url https://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/versions/{versionId}/blueprint \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-workspace-id: <x-workspace-id>' \
--data '
{
"languageId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"personalityName": "<string>",
"personalityRole": "<string>",
"targetAudience": "<string>",
"mainGoal": "<string>",
"personalityInitialGreeting": "<string>",
"personalityMessageStyleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"personalityToneStyleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"voiceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiredData": [
"<string>"
],
"criticalRules": [
"<string>"
],
"topicsAllowed": [
"<string>"
],
"topicsForbidden": [
"<string>"
],
"outputVariables": [
{
"name": "<string>",
"description": "<string>",
"required": true,
"choices": [
"<string>"
]
}
]
}
'import requests
url = "https://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/versions/{versionId}/blueprint"
payload = {
"languageId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"personalityName": "<string>",
"personalityRole": "<string>",
"targetAudience": "<string>",
"mainGoal": "<string>",
"personalityInitialGreeting": "<string>",
"personalityMessageStyleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"personalityToneStyleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"voiceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiredData": ["<string>"],
"criticalRules": ["<string>"],
"topicsAllowed": ["<string>"],
"topicsForbidden": ["<string>"],
"outputVariables": [
{
"name": "<string>",
"description": "<string>",
"required": True,
"choices": ["<string>"]
}
]
}
headers = {
"x-workspace-id": "<x-workspace-id>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
'x-workspace-id': '<x-workspace-id>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
languageId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
personalityName: '<string>',
personalityRole: '<string>',
targetAudience: '<string>',
mainGoal: '<string>',
personalityInitialGreeting: '<string>',
personalityMessageStyleId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
personalityToneStyleId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
voiceId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
requiredData: ['<string>'],
criticalRules: ['<string>'],
topicsAllowed: ['<string>'],
topicsForbidden: ['<string>'],
outputVariables: [
{
name: '<string>',
description: '<string>',
required: true,
choices: ['<string>']
}
]
})
};
fetch('https://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/versions/{versionId}/blueprint', 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-prod.studio.getsupervisor.ai/v1/agents/{agentId}/versions/{versionId}/blueprint",
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([
'languageId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'personalityName' => '<string>',
'personalityRole' => '<string>',
'targetAudience' => '<string>',
'mainGoal' => '<string>',
'personalityInitialGreeting' => '<string>',
'personalityMessageStyleId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'personalityToneStyleId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'voiceId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'requiredData' => [
'<string>'
],
'criticalRules' => [
'<string>'
],
'topicsAllowed' => [
'<string>'
],
'topicsForbidden' => [
'<string>'
],
'outputVariables' => [
[
'name' => '<string>',
'description' => '<string>',
'required' => true,
'choices' => [
'<string>'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"x-workspace-id: <x-workspace-id>"
],
]);
$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-prod.studio.getsupervisor.ai/v1/agents/{agentId}/versions/{versionId}/blueprint"
payload := strings.NewReader("{\n \"languageId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"personalityName\": \"<string>\",\n \"personalityRole\": \"<string>\",\n \"targetAudience\": \"<string>\",\n \"mainGoal\": \"<string>\",\n \"personalityInitialGreeting\": \"<string>\",\n \"personalityMessageStyleId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"personalityToneStyleId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"voiceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"requiredData\": [\n \"<string>\"\n ],\n \"criticalRules\": [\n \"<string>\"\n ],\n \"topicsAllowed\": [\n \"<string>\"\n ],\n \"topicsForbidden\": [\n \"<string>\"\n ],\n \"outputVariables\": [\n {\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"required\": true,\n \"choices\": [\n \"<string>\"\n ]\n }\n ]\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-workspace-id", "<x-workspace-id>")
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://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/versions/{versionId}/blueprint")
.header("x-workspace-id", "<x-workspace-id>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"languageId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"personalityName\": \"<string>\",\n \"personalityRole\": \"<string>\",\n \"targetAudience\": \"<string>\",\n \"mainGoal\": \"<string>\",\n \"personalityInitialGreeting\": \"<string>\",\n \"personalityMessageStyleId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"personalityToneStyleId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"voiceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"requiredData\": [\n \"<string>\"\n ],\n \"criticalRules\": [\n \"<string>\"\n ],\n \"topicsAllowed\": [\n \"<string>\"\n ],\n \"topicsForbidden\": [\n \"<string>\"\n ],\n \"outputVariables\": [\n {\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"required\": true,\n \"choices\": [\n \"<string>\"\n ]\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/versions/{versionId}/blueprint")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["x-workspace-id"] = '<x-workspace-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"languageId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"personalityName\": \"<string>\",\n \"personalityRole\": \"<string>\",\n \"targetAudience\": \"<string>\",\n \"mainGoal\": \"<string>\",\n \"personalityInitialGreeting\": \"<string>\",\n \"personalityMessageStyleId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"personalityToneStyleId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"voiceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"requiredData\": [\n \"<string>\"\n ],\n \"criticalRules\": [\n \"<string>\"\n ],\n \"topicsAllowed\": [\n \"<string>\"\n ],\n \"topicsForbidden\": [\n \"<string>\"\n ],\n \"outputVariables\": [\n {\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"required\": true,\n \"choices\": [\n \"<string>\"\n ]\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"version": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": 2,
"hash": "<string>",
"createdAt": "2023-11-07T05:31:56Z"
},
"blueprintId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"languageId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"personalityName": "<string>",
"personalityRole": "<string>",
"targetAudience": "<string>",
"mainGoal": "<string>",
"personalityInitialGreeting": "<string>",
"personalityMessageStyleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"personalityToneStyleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requiredData": [],
"contentHash": "<string>",
"contentVariables": [],
"variablesCache": [],
"outputVariables": [],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"voiceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"criticalRules": [],
"topicsAllowed": [],
"topicsForbidden": []
}{
"code": "<string>",
"message": "<string>",
"details": {
"subcode": "<string>",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"code": "<string>",
"message": "<string>",
"details": {
"subcode": "<string>",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"code": "<string>",
"message": "<string>",
"details": {
"subcode": "<string>",
"workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Identificador del workspace multi-tenant.
Path Parameters
Identificador del agente
Identificador de la versión del agente
Body
Campos editables del blueprint (todos opcionales). Campos de solo lectura: id, agentId, versionId, createdAt, updatedAt.
11111Identificador de catálogo (catalog_items) para la voz seleccionada.
user, agent Show child attributes
Show child attributes
Response
Blueprint actualizado
Blueprint (personalidad) asociado a una versión específica del agente.
Show child attributes
Show child attributes
11111user, agent Hash (SHA-256) del snapshot de contenido usado para detectar cambios.
Variables detectadas en los prompts del blueprint al último cálculo.
Unión deduplicada de variables del blueprint y sus stages activos.
Variables de salida para análisis post-llamada.
Show child attributes
Show child attributes
Identificador de catálogo (catalog_items) para la voz seleccionada.
