Aretion AI Documentation

Set up, secure, and scale your digital workforce. Clear guides, code samples, and best practices.

Quickstart API Reference

Quickstart

Connect your stack, define guardrails, and deploy your first agent in minutes.

1) Install & Connect
Go to Settings → Integrations. Connect CRM/ERP/Helpdesk/HRIS. Provide API keys or OAuth.
2) Guardrails & Roles
Configure RBAC, approval flows, redaction, and safe defaults in Settings → Security.
3) Deploy Your Agent
Use department playbooks and test in the sandbox. Promote to production when ready.

Popular Guides

✓

Salesforce Setup

Connect Salesforce, map objects, and enable safe write actions with approvals.

✓

Zendesk Automation

Auto-triage, summarize, and resolve with configurable escalation to humans.

✓

SSO/SAML

Enable SAML, SCIM, and audit logging to align with enterprise policies.

# Example: minimal JS client
aretion.connect('salesforce', { token: 'YOUR_TOKEN' })
aretion.configure({ role:'support-agent', approvals:true })
aretion.deploy('support-playbook')

API & SDK

Use API keys or OAuth. Send the key as Authorization: Bearer <token>. Tokens can be rotated in the dashboard under Settings → Security. 

// cURL example
curl https://api.aretion.ai/v1/agents \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json"

Create, list, and invoke agents programmatically. 

// Create an agent
POST /v1/agents
{
  "name": "Support L1",
  "skills": ["ticketing","kb-search"]
}

Subscribe to agent events such as ticket.resolved or workflow.failed. 

// Sample payload
{
  "type": "ticket.resolved",
  "agent_id": "ag_123",
  "data": { "ticket_id": "T-9021", "resolution_time_ms": 18342 }
}