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>
required

Identificador del workspace multi-tenant.

Idempotency-Key
string
required

Clave única por operación para asegurar idempotencia en requests mutativos.

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).