AI agents API — full reference

curl -X POST https://api.plugsky.com/v1/agents/acme-sales/agent/runs \
  -H "Authorization: Bearer $PLUGSKY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Find the Q3 renewal for Acme Corp and draft a follow-up email",
    "tools": ["crm.lookup", "gmail.draft", "calendar.find"],
    "max_steps": 10
  }'

{
  "id": "run_abc123",
  "agent_id": "acme-sales",
  "status": "completed",
  "steps": [
    {
      "step": 1,
      "type": "thought",
      "content": "I need to find Acme Corp in the CRM first."
    },
    {
      "step": 2,
      "type": "tool_call",
      "tool": "crm.lookup",
      "input": {"company": "Acme Corp"},
      "output": {"renewal_date": "2026-09-30", "amount": 50000, "status": "pending"}
    },
    {
      "step": 3,
      "type": "thought",
      "content": "Now I have the renewal date. Let me draft a follow-up email."
    },
    {
      "step": 4,
      "type": "tool_call",
      "tool": "gmail.draft",
      "input": {"to": "ceo@acme.com", "subject": "Q3 Renewal", "body": "..."},
      "output": {"draft_id": "draft_xyz"}
    }
  ],
  "output": "I've found the Q3 renewal for Acme Corp and drafted a follow-up email. The renewal is due 2026-09-30 for $50,000. Draft is ready for your review in Gmail."
}