Skip to main content
POST
Ejecutar una acción de una tool usando el toolAgentConnectionId

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.

Idempotency-Key
string

Clave única por operación para asegurar idempotencia en requests mutativos. Es opcional —sin ella la petición se ejecuta igual, pero un reintento crea una ejecución nueva—. Si se envía, debe medir entre 16 y 128 caracteres; fuera de ese rango la petición responde 400.

Required string length: 16 - 128
x-api-key
string

API Key opcional para llamadas sin token Bearer o con permisos programáticos.

Path Parameters

toolAgentConnectionId
string<uuid>
required

Identificador interno de la conexión agente-tool.

Body

application/json

Payload utilizado para ejecutar una acción de una tool usando una conexión existente.

action
string
required

Acción solicitada dentro de la tool (create, syncAgent, etc.).

Minimum string length: 1
args
object

Payload validado según el contrato de la tool.

Response

Ejecución completada de forma síncrona

status
enum<string>
required

Resultado alto nivel de la operación.

Available options:
ok,
queued,
error
toolId
string
required
toolExecutionId
string<uuid>
required

Identificador interno de la ejecución (útil para correlación y auditoría).

result
object

Respuesta específica del adapter.

metadata
object
toolAgentConnectionId
string<uuid> | null

Conexión utilizada para la ejecución, cuando aplica.

providerRef
string | null

Identificador del recurso manipulado en el proveedor externo.

message
string | null

Mensaje adicional (warnings, información del adapter).