{"success":true,"data":{"platform":{"name":"SaaSlete","version":"1.0.0","description":"Value stream mapping and AI agent execution platform. Map business processes, manage prompts, execute workflows with human oversight, and collect feedback for continuous improvement.","documentation_url":"https://saaslete.com/docs/agents","openapi_url":"https://saaslete.com/openapi.json","llms_txt_url":"https://saaslete.com/llms.txt"},"agent_types":[{"id":"autonomous","name":"Autonomous","description":"Full execution without human approval. For trusted internal agents.","requires_approval":false,"can_execute":true,"can_write":true},{"id":"supervised","name":"Supervised","description":"Actions require human approval before execution. Recommended for new or external agents.","requires_approval":true,"can_execute":true,"can_write":true},{"id":"read-only","name":"Read Only","description":"Can only read resources. Cannot execute workflows or modify data.","requires_approval":false,"can_execute":false,"can_write":false},{"id":"feedback-only","name":"Feedback Only","description":"Can only submit feedback on execution outputs. For evaluation/oversight agents.","requires_approval":false,"can_execute":false,"can_write":false}],"capabilities":[{"id":"value-stream-read","name":"Value Stream Reading","description":"Read value stream definitions including nodes, edges, and metrics.","required_scopes":["read","value-streams:read"],"endpoints":["GET /api/v1/value-streams","GET /api/v1/value-streams/{id}"]},{"id":"value-stream-write","name":"Value Stream Management","description":"Create and modify value stream definitions.","required_scopes":["write","value-streams:write"],"endpoints":["POST /api/v1/value-streams","PUT /api/v1/value-streams/{id}","DELETE /api/v1/value-streams/{id}"]},{"id":"prompt-read","name":"Prompt Reading","description":"Read prompts, versions, and render prompts with variable substitution.","required_scopes":["read","prompts:read"],"endpoints":["GET /api/v1/prompts","GET /api/v1/prompts/{id}","GET /api/v1/prompts/{id}/versions","POST /api/v1/prompts/{id}/render"]},{"id":"prompt-write","name":"Prompt Management","description":"Create and modify prompts and prompt versions.","required_scopes":["write","prompts:write"],"endpoints":["POST /api/v1/prompts","PUT /api/v1/prompts/{id}","POST /api/v1/prompts/{id}/versions","DELETE /api/v1/prompts/{id}"]},{"id":"execution-read","name":"Execution Reading","description":"Read execution history, steps, and logs.","required_scopes":["read","executions:read"],"endpoints":["GET /api/v1/executions","GET /api/v1/executions/{id}","GET /api/v1/executions/{id}/steps","GET /api/v1/executions/{id}/logs"]},{"id":"execution-run","name":"Workflow Execution","description":"Start new executions and complete execution steps. May require human approval for supervised agents.","required_scopes":["execute","executions:create","executions:complete"],"endpoints":["POST /api/v1/executions","POST /api/v1/executions/{id}/action","POST /api/v1/executions/{id}/steps/{stepId}/complete"],"input_schema":{"type":"object","properties":{"valueStreamId":{"type":"string","description":"ID of the value stream to execute"},"name":{"type":"string","description":"Optional name for this execution"},"mode":{"type":"string","description":"Execution mode: full-auto, step-by-step, or manual-only","enum":["full-auto","step-by-step","manual-only"]},"initialContext":{"type":"object","description":"Initial context data for the execution"}},"required":["valueStreamId"]}},{"id":"feedback-submit","name":"Feedback Submission","description":"Submit feedback on execution outputs including ratings, approvals, and corrections.","required_scopes":["feedback","feedback:write"],"endpoints":["POST /api/v1/feedback"],"input_schema":{"type":"object","properties":{"executionStepId":{"type":"string","description":"ID of the execution step to provide feedback on"},"feedbackType":{"type":"string","description":"Type of feedback","enum":["approval","rejection","rating","comment","edit"]},"rating":{"type":"number","description":"Rating from 1-5 (required for rating feedback type)"},"categories":{"type":"array","items":{"type":"string"},"description":"Feedback categories: accuracy, relevance, completeness, tone, format"},"comment":{"type":"string","description":"Optional comment explaining the feedback"},"correctedOutput":{"type":"object","description":"Corrected output data (for edit feedback type)"}},"required":["executionStepId","feedbackType"]}},{"id":"tool-discovery","name":"Tool Discovery","description":"Query the tool catalog with 10,000+ indexed SaaS tools.","required_scopes":["read","tools:read"],"endpoints":["GET /api/v1/tools.json","GET /api/v1/tools/{id}"]},{"id":"agent-self-document","name":"Agent Self-Documentation","description":"Announce agent capabilities and report activity for audit trail.","required_scopes":["feedback","agents:manage"],"endpoints":["POST /api/v1/agents/{id}/capabilities","POST /api/v1/agents/{id}/activity","GET /api/v1/agents/{id}/schema"]}],"authentication":{"type":"api_key","key_prefix":"sk_agent_","registration_endpoint":"/api/v1/agents/register","scopes":[{"id":"read","description":"Read all accessible resources","children":["prompts:read","value-streams:read","executions:read","tools:read","feedback:read"]},{"id":"prompts:read","description":"Read prompts and prompt versions","children":[]},{"id":"value-streams:read","description":"Read value stream definitions","children":[]},{"id":"executions:read","description":"Read execution history and logs","children":[]},{"id":"tools:read","description":"Read tool catalog","children":[]},{"id":"feedback:read","description":"Read aggregated feedback","children":[]},{"id":"write","description":"Create and modify resources","children":["prompts:write","value-streams:write"]},{"id":"prompts:write","description":"Create and edit prompts","children":[]},{"id":"value-streams:write","description":"Create and edit value streams","children":[]},{"id":"execute","description":"Execute workflows and complete steps","children":["executions:create","executions:complete"]},{"id":"executions:create","description":"Start new executions","children":[]},{"id":"executions:complete","description":"Complete execution steps","children":[]},{"id":"feedback","description":"Submit feedback on outputs","children":["feedback:write","feedback:read"]},{"id":"feedback:write","description":"Submit feedback on outputs","children":[]},{"id":"admin","description":"Full administrative access","children":["read","write","execute","feedback","agents:manage"]},{"id":"agents:manage","description":"Manage agent settings","children":[]}]},"rate_limits":{"requests_per_minute":100,"executions_per_minute":20,"daily_limit":10000},"endpoints":[{"method":"GET","path":"/api/v1/agents/discovery","description":"Get platform capabilities and authentication info (this endpoint)","required_scopes":[]},{"method":"POST","path":"/api/v1/agents/register","description":"Register a new AI agent (requires organization context)","required_scopes":[]},{"method":"GET","path":"/api/v1/agents/{id}","description":"Get agent details","required_scopes":["read"]},{"method":"POST","path":"/api/v1/agents/{id}/capabilities","description":"Announce agent capabilities","required_scopes":["agents:manage"]},{"method":"POST","path":"/api/v1/agents/{id}/activity","description":"Report agent activity","required_scopes":["feedback"]},{"method":"GET","path":"/api/v1/value-streams","description":"List value streams","required_scopes":["read"]},{"method":"GET","path":"/api/v1/value-streams/{id}","description":"Get value stream details with nodes and edges","required_scopes":["read"]},{"method":"POST","path":"/api/v1/value-streams","description":"Create a new value stream","required_scopes":["write"]},{"method":"GET","path":"/api/v1/prompts","description":"List prompts (filter by targetAudience=ai-agent)","required_scopes":["read"]},{"method":"GET","path":"/api/v1/prompts/{id}","description":"Get prompt details with variables","required_scopes":["read"]},{"method":"POST","path":"/api/v1/prompts/{id}/render","description":"Render prompt with variable substitution","required_scopes":["read"]},{"method":"GET","path":"/api/v1/executions","description":"List executions","required_scopes":["read"]},{"method":"POST","path":"/api/v1/executions","description":"Start a new execution","required_scopes":["execute"]},{"method":"GET","path":"/api/v1/executions/{id}","description":"Get execution details with steps and logs","required_scopes":["read"]},{"method":"POST","path":"/api/v1/executions/{id}/action","description":"Execute the next step","required_scopes":["execute"]},{"method":"POST","path":"/api/v1/executions/{id}/steps/{stepId}/complete","description":"Complete a specific execution step","required_scopes":["execute"]},{"method":"POST","path":"/api/v1/feedback","description":"Submit feedback on an execution step","required_scopes":["feedback"]},{"method":"GET","path":"/api/v1/feedback","description":"Get feedback history","required_scopes":["read"]},{"method":"GET","path":"/api/v1/tools.json","description":"Get full tool catalog (10,000+ tools)","required_scopes":["read"]}]}}