Skip to main content
POST
/
tools
/
run
Run tool
curl --request POST \
  --url https://www.dench.com/api/v1/tools/run \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tool_slug": "GMAIL_FETCH_EMAILS",
  "arguments": {
    "max_results": 10
  }
}
'
{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "details": "<unknown>"
  }
}

Authorizations

​
Authorization
string
header
required

Workspace-scoped Dench API key from workspace settings. This is the same key used by DENCH_API_KEY in sandboxes.

Body

application/json
​
execution_ref
string

Execution ref from a prior search, OR pass session_id+tool_slug.

​
session_id
string
​
tool_slug
string

Composio tool slug, e.g. GMAIL_FETCH_EMAILS.

​
arguments
object

Tool arguments object.

​
account
string

Response

Successful response