Skip to main content
POST
/
v1
/
tools
/
{slug}
/
execute
# Send email via Gmail
curl -X POST https://api.runtools.ai/v1/tools/gmail/execute \
  -H "X-API-Key: rt_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "send_email",
    "params": {
      "to": "[email protected]",
      "subject": "Hello",
      "body": "This is a test email"
    }
  }'

# Post to Slack
curl -X POST https://api.runtools.ai/v1/tools/slack/execute \
  -H "X-API-Key: rt_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "post_message",
    "params": {
      "channel": "#general",
      "text": "Hello from RunTools!"
    }
  }'
{
  "data": {
    "success": true,
    "result": {
      "messageId": "msg_abc123",
      "timestamp": "2025-01-21T10:00:00Z"
    }
  }
}

Path Parameters

slug
string
required
Tool slug

Request Body

action
string
required
Action to perform (tool-specific)
params
object
Action parameters (varies by tool and action)

Response

success
boolean
Whether execution succeeded
result
object
Action result (varies by tool)
# Send email via Gmail
curl -X POST https://api.runtools.ai/v1/tools/gmail/execute \
  -H "X-API-Key: rt_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "send_email",
    "params": {
      "to": "[email protected]",
      "subject": "Hello",
      "body": "This is a test email"
    }
  }'

# Post to Slack
curl -X POST https://api.runtools.ai/v1/tools/slack/execute \
  -H "X-API-Key: rt_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "post_message",
    "params": {
      "channel": "#general",
      "text": "Hello from RunTools!"
    }
  }'
{
  "data": {
    "success": true,
    "result": {
      "messageId": "msg_abc123",
      "timestamp": "2025-01-21T10:00:00Z"
    }
  }
}

Common Actions

Gmail

ActionDescription
send_emailSend an email
list_emailsList emails
get_emailGet email by ID

Slack

ActionDescription
post_messagePost a message
list_channelsList channels
read_messagesRead channel messages

GitHub

ActionDescription
create_issueCreate an issue
create_prCreate a pull request
list_reposList repositories