Reintentar el build de un agente

curl --request POST \
  --url https://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/rebuild \
  --header 'Authorization: Bearer <token>' \
  --header 'x-workspace-id: <x-workspace-id>'

import requests

url = "https://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/rebuild"

headers = {
    "x-workspace-id": "<x-workspace-id>",
    "Authorization": "Bearer <token>"
}

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

print(response.text)

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

fetch('https://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/rebuild', 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}/rebuild",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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"
	"net/http"
	"io"
)

func main() {

	url := "https://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/rebuild"

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

	req.Header.Add("x-workspace-id", "<x-workspace-id>")
	req.Header.Add("Authorization", "Bearer <token>")

	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-prod.studio.getsupervisor.ai/v1/agents/{agentId}/rebuild")
  .header("x-workspace-id", "<x-workspace-id>")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/rebuild")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-workspace-id"] = '<x-workspace-id>'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "agentType": "chat",
  "workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "inactive",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "totalCalls": 1,
  "totalOperationalDays": 1,
  "goalAchievedPercentage": 50,
  "versionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "description": "<string>",
  "avatarUrl": "<string>",
  "debounceDelayMs": 1,
  "toneId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "messageStyleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ownerUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "knowledgeBaseIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "tags": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "tools": [
    {
      "identifier": "<string>",
      "displayName": "<string>",
      "enabled": true
    }
  ],
  "voiceConfig": {
    "voiceId": "<string>",
    "webhookUrl": "<string>",
    "llmId": "<string>"
  },
  "metadata": {}
}

{
  "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"
  }
}

Agents

Reintentar el build de un agente

Reintenta la construcción (build) de un agente que quedó en estado failed, reutilizando los inputs originales con los que se creó (brief, URL de research, documentos y modo) — el cliente no necesita recapturar nada.

Solo aplica a agentes en estado failed.
Re-ejecuta el runtime sobre el MISMO agente (failed → building → active/failed).
La respuesta puede ser un stream SSE de progreso del build (igual que en la creación).

POST

agents

{agentId}

rebuild

Reintentar el build de un agente

curl --request POST \
  --url https://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/rebuild \
  --header 'Authorization: Bearer <token>' \
  --header 'x-workspace-id: <x-workspace-id>'

import requests

url = "https://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/rebuild"

headers = {
    "x-workspace-id": "<x-workspace-id>",
    "Authorization": "Bearer <token>"
}

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

print(response.text)

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

fetch('https://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/rebuild', 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}/rebuild",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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"
	"net/http"
	"io"
)

func main() {

	url := "https://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/rebuild"

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

	req.Header.Add("x-workspace-id", "<x-workspace-id>")
	req.Header.Add("Authorization", "Bearer <token>")

	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-prod.studio.getsupervisor.ai/v1/agents/{agentId}/rebuild")
  .header("x-workspace-id", "<x-workspace-id>")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-prod.studio.getsupervisor.ai/v1/agents/{agentId}/rebuild")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-workspace-id"] = '<x-workspace-id>'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "agentType": "chat",
  "workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "inactive",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "totalCalls": 1,
  "totalOperationalDays": 1,
  "goalAchievedPercentage": 50,
  "versionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "description": "<string>",
  "avatarUrl": "<string>",
  "debounceDelayMs": 1,
  "toneId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "messageStyleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ownerUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "knowledgeBaseIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "tags": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "tools": [
    {
      "identifier": "<string>",
      "displayName": "<string>",
      "enabled": true
    }
  ],
  "voiceConfig": {
    "voiceId": "<string>",
    "webhookUrl": "<string>",
    "llmId": "<string>"
  },
  "metadata": {}
}

{
  "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

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-workspace-id

string<uuid>

required

Identificador del workspace multi-tenant.

Path Parameters

agentId

string<uuid>

required

Identificador del agente

Response

Build reiniciado (detalle del agente; opcionalmente stream SSE de progreso)

agentId

string<uuid>

required

name

string

required

agentType

enum<string>

required

Available options:

chat,

voice

workspaceId

string<uuid>

required

status

enum<string>

required

Available options:

inactive,

training,

active,

archived,

building,

failed

createdAt

string<date-time>

required

updatedAt

string<date-time>

required

totalCalls

integer

required

Total de llamadas realizadas por el agente.

Required range: x >= 0

totalOperationalDays

integer

required

Total de días operativos desde la creación del agente.

Required range: x >= 0

goalAchievedPercentage

number

required

Porcentaje de llamadas donde el objetivo fue alcanzado.

Required range: 0 <= x <= 100

versionId

string<uuid>

description

string | null

avatarUrl

string<uri> | null

URL pública opcional utilizada para representar al agente.

debounceDelayMs

integer | null

Delay opcional antes de enviar respuestas (milisegundos).

Required range: x >= 0

toneId

string<uuid> | null

messageStyleId

string<uuid> | null

ownerUserId

string<uuid> | null

knowledgeBaseIds

string<uuid>[]

Identificadores de knowledge bases asociadas.

Empezar

Referencia de endpoints

Agentes

Herramientas del agente

Telefonía

Webhooks

MCP

Reintentar el build de un agente

Authorizations

Headers

Path Parameters

Response