Requires the site to be on a plan that includes automations (Pro or Advanced) and to have sufficient AI credits.
UI vs. API
The Automations page (app.trysight.ai/automations) is the primary way to create, schedule, and monitor automations — including custom tool-based workflows. See the Automations documentation for setup guides.
The v1 API endpoints below operate on the agent configuration store (template agent keys). Custom automations created in the UI (custom_actions) are not yet exposed on the v1 REST or MCP API.
REST endpoints
| Method | Path | Scope |
|---|
| GET | /api/v1/sites/{siteId}/agents | agents:read |
| GET | /api/v1/sites/{siteId}/agents/runs | agents:read |
| PUT | /api/v1/sites/{siteId}/agents/{agentKey} | agents:write |
| POST | /api/v1/sites/{siteId}/agents/{agentKey}/run | agents:write |
Agent keys
| Key | Template |
|---|
article_creation | Search Opportunity Agent |
ai_prompt | AI Opportunity Agent |
article_boost | Article Boost Agent |
interlinking | Interlinking Agent |
site_performance | Site Performance Agent |
outreach | Outreach Agent (Advanced only) |
agents:read / agents:write scopes:
list_agents / list_agent_runsupdate_agent — toggle or tune an agentrun_agent — on-demand run (rate-limited; agent must be active)
See MCP Setup for OAuth and end-to-end workflow examples.
Typical workflow
list_agents → update_agent (enable + schedule) → run_agent → list_agent_runs
list_opportunities → run_agent (article_creation) → list_agent_runs → sync_article
Rate limits: agent runs are capped at 5/hour per site. AI credit affordability is enforced when credits enforcement is active.
