API Reference

Base Endpoint

/services/apexrest/ai/agent

Common Endpoints

• POST /process for chat turn processing
• POST /approve for HITL action approvals
• POST /reject for HITL action rejection

Authentication

Use Salesforce authentication (session token or OAuth) and include:

Headers

Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

cURL Example

curl -X POST "https://YOUR-INSTANCE.salesforce.com/services/apexrest/ai/agent/process" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"sessionId":"...","agentDefinitionId":"...","turnIdentifier":"...","userMessage":"hello"}'

OpenAPI Assets

openapi.yml

openapi.json