Gradient Labs builds "Otto", an AI customer support agent that autonomously handles complex, end-to-end support conversations for regulated and financial services businesses. The API lets you start and drive conversations, stream customer messages, hand off to human agents, execute business actions/tools, and manage the knowledge base the agent reasons over, with signed webhooks delivering the agent's outbound messages and events.
APIs.json: https://raw.githubusercontent.com/api-evangelist/gradient-labs/refs/heads/main/apis.yml
Accuracy note: Gradient Labs' public API reference at https://api-docs.gradient-labs.ai/ is behind an access code. The endpoints, base URL (
https://api.gradient-labs.ai), Bearer auth, and webhook event types cataloged here were reconstructed from the vendor's official open-source SDKs (primarily gradientlabs-go). Request/response schemas are modeled and should be verified against the gated reference. Seereview.ymlfor what is confirmed vs. modeled.
- AI
- Customer Support
- AI Agent
- Conversations
- Financial Services
- Regulated
- Created: 2026-07-01
- Modified: 2026-07-01
Start a conversation, assign it to the Gradient Labs AI agent, read its current state, and manage its lifecycle (finish, cancel, resume). The AI agent autonomously works the conversation and emits outbound messages and events via webhooks.
- Human URL: https://api-docs.gradient-labs.ai/
- Base URL:
https://api.gradient-labs.ai
- Conversations
- AI Agent
- Support
- Documentation
- OpenAPI — OpenAPI Specification
- Postman Collection — Postman Collection 2.1
- Open Collection — Open Collection 1.0
Add inbound customer and human-agent messages (with optional email subject and attachments) to an existing conversation for the AI agent to process.
- Human URL: https://api-docs.gradient-labs.ai/
- Base URL:
https://api.gradient-labs.ai
- Messages
- Conversations
- Attachments
- Documentation
- OpenAPI — OpenAPI Specification
- Postman Collection — Postman Collection 2.1
- Open Collection — Open Collection 1.0
Assign or reassign a conversation between the AI agent and human participants, and capture the conversation.hand_off webhook the agent emits when it decides to escalate to a human, including reason code and routing target.
- Human URL: https://api-docs.gradient-labs.ai/
- Base URL:
https://api.gradient-labs.ai
- Hand-off
- Assignment
- Human Agent
- Documentation
- OpenAPI — OpenAPI Specification
- Postman Collection — Postman Collection 2.1
- Open Collection — Open Collection 1.0
Define the business tools the AI agent can call and execute them. Tools can be run via the API or delivered to your endpoint through the action.execute webhook so the agent can take real actions in your systems.
- Human URL: https://api-docs.gradient-labs.ai/
- Base URL:
https://api.gradient-labs.ai
- Actions
- Tools
- Function Calling
- Documentation
- OpenAPI — OpenAPI Specification
- Postman Collection — Postman Collection 2.1
- Open Collection — Open Collection 1.0
Upsert and delete knowledge-base articles (title, description, body, visibility, topic, status) that ground the AI agent's answers, organized by topic.
- Human URL: https://api-docs.gradient-labs.ai/
- Base URL:
https://api.gradient-labs.ai
- Knowledge
- Articles
- Content
- Documentation
- OpenAPI — OpenAPI Specification
- Postman Collection — Postman Collection 2.1
- Open Collection — Open Collection 1.0
Signed, ordered webhook events the AI agent delivers to your endpoint — agent.message, conversation.hand_off, conversation.finished, action.execute, and resource.pull — each carrying an incrementing sequence_number so you can establish a total order of events per conversation.
- Human URL: https://api-docs.gradient-labs.ai/
- Base URL:
https://api.gradient-labs.ai
- Webhooks
- Events
- Signing
FN: Kin Lane Email: kin@apievangelist.com