API Reference

curl -X POST https://stryda.ai/api/mcp \
  -H "Authorization: Bearer whsec_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "comms.send_slack_message",
      "arguments": { "channel": "#general", "text": "hello" }
    }
  }'

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "comms.send_slack_message",
    "arguments": { "channel": "#general", "text": "hello" }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      { "type": "text", "text": "{\"ok\":true,\"ts\":\"1718212...\",\"_cost_usd\":0}" }
    ]
  }
}

{
  "name": "Zain's laptop — Claude Desktop",
  "kind": "claude_desktop"
}

{
  "client_id": "cli_abc123",
  "kind": "claude_desktop",
  "bearer": "whsec_xxxxxxxxxxxxxxxx",
  "url": "https://mcp.stryda.ai/api/mcp",
  "created_at": "2026-04-19T12:00:00Z"
}

{
  "client_id": "cli_abc123",
  "bearer": "whsec_yyyyyyyyyyyyyyyy",
  "rotated_at": "2026-04-19T12:30:00Z"
}

{
  "client_id": "cli_abc123",
  "status": "disconnected",
  "revoked_at": "2026-04-19T12:45:00Z"
}

{
  "name": "Lead Scoring Pipeline",
  "description": "Score and route inbound leads"
}

{
  "id": "wf_def456",
  "name": "Lead Scoring Pipeline",
  "status": "draft",
  "created_at": "2026-01-15T12:00:00Z"
}

curl -X POST https://stryda.ai/api/v1/workflows/wf_abc123/run \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input_data": {"prompt": "Analyze this email"}}'

{
  "input_data": {
    "prompt": "Analyze this customer email and suggest a response"
  }
}

{
  "run_id": "run_789",
  "workflow_id": "wf_abc123",
  "status": "running",
  "started_at": "2026-01-15T12:00:00Z"
}

{
  "name": "Data Analyst",
  "model": "claude-sonnet-4-6",
  "system_prompt": "You are a data analyst with access to company databases.",
  "tools": ["sql_query", "chart_create", "slack_post"],
  "max_iterations": 10,
  "budget_per_run": 0.50
}

{
  "id": "agent_def456",
  "name": "Data Analyst",
  "status": "active",
  "created_at": "2026-01-15T12:00:00Z"
}

curl -X POST https://stryda.ai/api/v1/agents/agent_abc123/run \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input_data": {"task": "Analyze Q4 revenue trends"}}'

{
  "input_data": {
    "task": "Analyze Q4 revenue trends and post a summary to #analytics"
  }
}

{
  "run_id": "run_012",
  "agent_id": "agent_abc123",
  "status": "running",
  "started_at": "2026-01-15T12:00:00Z"
}

{
  "name": "Sales Assistant",
  "model": "gpt-4.1",
  "system_prompt": "You are a helpful sales assistant.",
  "knowledge_base": ["kb_doc1", "kb_doc2"]
}

{
  "id": "cb_def456",
  "name": "Sales Assistant",
  "embed_id": "emb_abc",
  "status": "draft",
  "created_at": "2026-01-15T12:00:00Z"
}

curl -X POST https://stryda.ai/api/embed/emb_xyz/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "How do I reset my password?", "session_id": "sess_user123"}'

{
  "message": "How do I reset my password?",
  "session_id": "sess_user123"
}

{
  "response": "To reset your password, go to Settings > Security...",
  "session_id": "sess_user123",
  "tokens": 245,
  "cost": 0.0008
}

curl -X POST https://stryda.ai/api/v1/approvals/appr_abc123/approve \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"comment": "Approved"}'

{
  "comment": "Looks good, approved for release.",
  "edited_output": null
}

{
  "id": "appr_abc123",
  "action": "approved",
  "reviewer": "user_abc123",
  "comment": "Looks good, approved for release.",
  "approved_at": "2026-01-15T14:32:00Z"
}

{
  "comment": "Output contains inaccurate pricing. Please revise.",
  "reason": "factual_error"
}

{
  "id": "appr_abc123",
  "action": "rejected",
  "reviewer": "user_abc123",
  "comment": "Output contains inaccurate pricing. Please revise.",
  "rejected_at": "2026-01-15T14:32:00Z"
}

{
  "name": "Product Feedback",
  "columns": [
    { "name": "customer", "type": "text" },
    { "name": "rating", "type": "number" },
    { "name": "feedback", "type": "text" },
    { "name": "category", "type": "select", "options": ["bug", "feature", "praise"] }
  ]
}

{
  "id": "tbl_def456",
  "name": "Product Feedback",
  "columns": ["customer", "rating", "feedback", "category"],
  "row_count": 0,
  "created_at": "2026-01-15T12:00:00Z"
}

{
  "data": {
    "customer": "Jane Smith",
    "rating": 5,
    "feedback": "The workflow builder is incredibly intuitive",
    "category": "praise"
  }
}

{
  "id": "row_789",
  "table_id": "tbl_def456",
  "data": {
    "customer": "Jane Smith",
    "rating": 5,
    "feedback": "The workflow builder is incredibly intuitive",
    "category": "praise"
  },
  "created_at": "2026-01-15T12:30:00Z"
}

{
  "name": "Bug Report",
  "slug": "bug-report",
  "fields": [
    { "name": "title", "type": "text", "required": true },
    { "name": "description", "type": "textarea", "required": true },
    { "name": "severity", "type": "select", "options": ["low", "medium", "high", "critical"] }
  ],
  "linked_table": "tbl_def456",
  "trigger_workflow": "wf_abc123"
}

{
  "id": "frm_def456",
  "name": "Bug Report",
  "slug": "bug-report",
  "public_url": "https://stryda.ai/f/bug-report",
  "created_at": "2026-01-15T12:00:00Z"
}

{
  "data": {
    "title": "Dashboard loading slowly",
    "description": "The analytics dashboard takes 15 seconds to load",
    "severity": "medium"
  }
}

{
  "id": "sub_789",
  "form_id": "frm_def456",
  "status": "received",
  "workflow_run_id": "run_012",
  "created_at": "2026-01-15T12:30:00Z"
}

{
  "content": "Customer Acme Corp renewed their enterprise contract for 3 years",
  "type": "business",
  "tags": ["customers", "contracts", "acme"]
}

{
  "id": "mem_def456",
  "content": "Customer Acme Corp renewed their enterprise contract for 3 years",
  "type": "business",
  "tags": ["customers", "contracts", "acme"],
  "created_at": "2026-01-15T12:00:00Z"
}

{
  "query": "What is Acme Corp's contract status?",
  "top_k": 5
}

{
  "results": [
    {
      "id": "mem_def456",
      "content": "Customer Acme Corp renewed their enterprise contract for 3 years",
      "score": 0.94,
      "tags": ["customers", "contracts", "acme"]
    }
  ]
}

curl -X POST https://stryda.ai/api/v1/templates/tpl_support_triage/instantiate \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Custom Triage"}'

{
  "name": "My Custom Triage",
  "overrides": {
    "nodes": {
      "draft_reply": {
        "config": { "model": "claude-sonnet-4-6", "temperature": 0.7 }
      }
    },
    "budget": { "per_run_cap": 0.25, "daily_cap": 15.00 }
  }
}

{
  "workflow_id": "wf_new789",
  "name": "My Custom Triage",
  "template_id": "tpl_support_triage",
  "status": "draft",
  "created_at": "2026-01-15T12:00:00Z"
}

curl -X POST https://stryda.ai/hooks/my-webhook-slug \
  -H "Content-Type: application/json" \
  -H "X-Stryda-Signature: sha256=abc123..." \
  -d '{"event": "new_order", "customer": "[email protected]"}'

{
  "event": "new_order",
  "customer": "[email protected]",
  "total": 99.99
}

{ "status": "accepted", "run_id": "run_789" }