Reordenar los stages del blueprint

curl --request POST \
  --url https://agents.studio.getsupervisor.ai/v1/agents/{agentId}/stages:reorder \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-workspace-id: <x-workspace-id>' \
  --data '
{
  "stageIds": [
    "0f44f6d1-f466-4367-bf25-37ce49b0d9c8",
    "1272c8b5-8426-41c8-a42b-607d0131800a",
    "b0d32725-47cc-43b3-b415-1304ca4f9e24"
  ],
  "startingStageName": "welcome"
}
'

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "blueprintId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "goalPrompt": "<string>",
      "promptInstructions": [],
      "order": 123,
      "triggers": [],
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "title": "<string>",
      "metadata": {}
    }
  ],
  "meta": {
    "total": 123,
    "page": 123,
    "limit": 123,
    "hasNext": true,
    "hasPrevious": true
  }
}

POST

agents

{agentId}

stages:reorder

Reordenar los stages del blueprint

curl --request POST \
  --url https://agents.studio.getsupervisor.ai/v1/agents/{agentId}/stages:reorder \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-workspace-id: <x-workspace-id>' \
  --data '
{
  "stageIds": [
    "0f44f6d1-f466-4367-bf25-37ce49b0d9c8",
    "1272c8b5-8426-41c8-a42b-607d0131800a",
    "b0d32725-47cc-43b3-b415-1304ca4f9e24"
  ],
  "startingStageName": "welcome"
}
'

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "blueprintId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "goalPrompt": "<string>",
      "promptInstructions": [],
      "order": 123,
      "triggers": [],
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "title": "<string>",
      "metadata": {}
    }
  ],
  "meta": {
    "total": 123,
    "page": 123,
    "limit": 123,
    "hasNext": true,
    "hasPrevious": true
  }
}

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

Body

application/json

stageIds

string<uuid>[]

required

Orden resultante de los stages identificado por sus UUIDs.

Minimum array length: 1

startingStageName

string | null

Nombre del stage que actuará como punto de entrada tras el reordenamiento.

Response

Orden actualizado

data

object[]

required

Show child attributes

data.id

string<uuid>

required

data.agentId

string<uuid>

required

data.blueprintId

string<uuid>

required

data.name

string

required

Nombre estable del stage (slug amigable para referencias entre triggers).

Minimum string length: 1

data.goalPrompt

string

required

Objetivo del stage expresado como prompt de alto nivel.

Minimum string length: 1

data.promptInstructions

string[]

required

Lista ordenada de instrucciones que contextualizan el goal prompt.

data.order

integer

required

Posición del stage dentro del blueprint.

data.triggers

object[]

required

Triggers asociados al stage.

Show child attributes

data.triggers.id

string<uuid>

required

data.triggers.stageId

string<uuid>

required

data.triggers.blueprintId

string<uuid>

required

data.triggers.condition

object

required

Condición evaluada para activar la transición al siguiente stage.

Show child attributes

data.triggers.condition.type

enum<string>

required

Available options:

intent,

rule,

expression

data.triggers.condition.value

string

required

Valor que representa la condición (intent esperado, expresión DSL, etc.).

data.triggers.condition.metadata

object

Campos adicionales dependientes del proveedor.

data.triggers.nextStageName

string

required

Nombre del siguiente stage al que se transicionará.

data.triggers.createdAt

string<date-time>

required

data.triggers.updatedAt

string<date-time>

required

data.createdAt

string<date-time>

required

data.updatedAt

string<date-time>

required

data.title

string | null

Título legible que se muestra en el editor.

data.metadata

object

Campos adicionales definidos por el workspace.

Documentación

API Reference

MCP

Conocimiento

Blueprint

Plantillas

Misceláneos

Notificaciones

Reordenar los stages del blueprint

Authorizations

Headers

Path Parameters

Body

Response