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