Skip to main content
PATCH
Actualizar un stage existente

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>

Identificador del workspace multi-tenant. Obligatorio al autenticar con Authorization: Bearer, donde su ausencia devuelve 400 Workspace context is required. Con x-api-key es opcional: la llave ya identifica a su workspace y lo que mandes aquí se ignora.

Path Parameters

agentId
string<uuid>
required

Identificador del agente

blueprintId
string<uuid>
required

Identificador del blueprint del agente (se obtiene de GET /v1/agents/{agentId}/blueprints)

stageId
string<uuid>
required

Identificador del stage dentro del blueprint del agente

Body

application/json
name
string
Minimum string length: 1
title
string | null
goalPrompt
string
Minimum string length: 1
promptInstructions
string[]
order
integer | null
Required range: x >= 0
metadata
object | null
triggers
object[]

Reemplaza el conjunto completo de triggers del stage: lo que mandes es lo que queda, y los que no aparezcan se eliminan. Omitir el campo es «no los toques»; mandar [] los borra todos. Es la única forma de editar los triggers en bloque. Al aplicarse se revalida que no haya dos decisiones equivalentes en el stage.

Response

Stage actualizado

id
string<uuid>
required
blueprintId
string<uuid>
required
name
string
required

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

Minimum string length: 1
title
string | null
required

Título legible que se muestra en el editor.

goalPrompt
string
required

Objetivo del stage expresado como prompt de alto nivel.

Minimum string length: 1
promptInstructions
string[]
required

Lista ordenada de instrucciones que contextualizan el goal prompt.

order
integer
required

Posición del stage dentro del blueprint.

triggers
object[]
required

Triggers asociados al stage.

metadata
object | null
required

Campos adicionales definidos por el workspace.

variables
string[]
required

Variables detectadas en el goal prompt e instrucciones del stage.

createdAt
string<date-time>
required
updatedAt
string<date-time>
required