API Reference

Complete reference for the SkillRouter REST API

Base URL:https://api.skillrouter.dev
POST/v1/execute

Execute a skill

Example Request

cURL
curl -X POST https://api.skillrouter.dev/v1/execute \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "skill_id": "sendgrid-email",
    "params": {
      "to": "user@example.com",
      "subject": "Hello from SkillRouter",
      "body": "This email was sent by an AI agent!"
    }
  }'

Example Response

JSON
{
  "id": "exec_abc123",
  "skill_id": "sendgrid-email",
  "status": "completed",
  "success": true,
  "latency_ms": 245,
  "result": {
    "message_id": "msg_xyz789",
    "status": "sent"
  },
  "created_at": "2025-02-05T10:30:00Z"
}

Parameters

NameTypeRequiredDescription
skill_idstringYesThe ID of the skill to execute
paramsobjectYesParameters required by the skill
asyncbooleanNoExecute asynchronously (default: false)
timeout_msnumberNoExecution timeout in milliseconds