Enneo

AI Tools

Execute a tool

POST /tools/{identifier}/run

POST /tools/{identifier}/run

Execute a specific custom tool by its ID or slug. The request body should contain the parameters the tool expects. Required parameters are validated before execution.

Path parameters

identifieranypathrequired

The identifier of the tool to execute, either the numeric ID or the slug

Request body

Request Example

{
  "contractId": 7115214
}

Responses

200 — Tool executed successfully

400 — Validation error (missing required parameters or type mismatch) or tool execution failed

403 — Unauthorized - missing runExecutors permission or tool is private

404 — Tool not found

500 — Internal error