Maven AGI

Maven AGI is an enterprise AI agent platform for customer experience. Its AI agents answer questions, take actions, and improve with every interaction across chat, email, voice, and SMS. The Maven Platform API lets developers build apps that manage conversations, knowledge, actions, users, events, and triggers, authenticated with an App ID and App Secret scoped to an organization and agent.

9 APIs 0 Features

AIAgentsCustomer SupportCustomer ExperienceConversational AIKnowledge

APIs

Maven AGI Conversation API

Initialize conversations, append messages, ask questions of the agent (streaming or non-streaming), categorize, submit action forms, manage conversation metadata, deliver messag...

Maven AGI Knowledge API

Create and version knowledge bases, add and refresh knowledge documents, and search knowledge bases and documents that ground the agent's answers.

Maven AGI Actions API

Register, search, retrieve, patch, and delete Actions - the parameterized operations against external business systems that agents can call to get work done during a conversation.

Maven AGI Users API

Create or update users, retrieve and delete users, and read and search the resolved agent-user identities associated with an agent.

Maven AGI Agents API

Create, list, retrieve, patch, and delete agents within an organization, the top-level configuration that defines an AI agent's behavior and scope.

Maven AGI Events API

Create, retrieve, search, and export events - the timeline of activity and signals emitted by agents and users that feed analytics and triggers.

Maven AGI Triggers API

Create or update, retrieve, patch, search, and delete event triggers that automate downstream behavior in response to conversation and event activity.

Maven AGI App Settings API

Read and patch the per-app settings that a Maven app uses to store its installation configuration and search across app-scoped settings.

Maven AGI Analytics API

Query conversation, event, feedback, and agent-user tables and charts to build reporting on agent performance, deflection, and customer outcomes.

Collections

Maven AGI Platform API

OPEN

Pricing Plans

Maven Agi Plans Pricing

2 plans

PLANS

Rate Limits

Maven Agi Rate Limits

3 limits

RATE LIMITS

FinOps

Maven Agi Finops

FINOPS

Resources

GitHubOrganization

Sources

opencollection: 1.0.0
info:
  name: Maven AGI Platform API
  version: '1.0'
request:
  auth:
    type: basic
    username: '{{appId}}'
    password: '{{appSecret}}'
  headers:
  - key: X-Organization-Id
    value: '{{organizationId}}'
  - key: X-Agent-Id
    value: '{{agentId}}'
items:
- info:
    name: Conversations
    type: folder
  items:
  - info:
      name: Initialize conversation
      type: http
    http:
      method: POST
      url: https://www.mavenagi-apis.com/v1/conversations
      body:
        type: json
        data: "{\n  \"conversationId\": { \"referenceId\": \"\" },\n  \"messages\": []\n}"
    docs: Create and initialize a new conversation.
  - info:
      name: Get conversation
      type: http
    http:
      method: GET
      url: https://www.mavenagi-apis.com/v1/conversations/{conversationId}
    docs: Retrieve a conversation by id.
  - info:
      name: Append new messages
      type: http
    http:
      method: POST
      url: https://www.mavenagi-apis.com/v1/conversations/{conversationId}/messages
      body:
        type: json
        data: "{\n  \"messages\": []\n}"
    docs: Append new messages to an existing conversation.
  - info:
      name: Ask
      type: http
    http:
      method: POST
      url: https://www.mavenagi-apis.com/v1/conversations/{conversationId}/ask
      body:
        type: json
        data: "{\n  \"conversationMessageId\": { \"referenceId\": \"\" },\n  \"userId\": { \"referenceId\": \"\" },\n  \"\
          text\": \"How do I reset my password?\"\n}"
    docs: Ask the agent a question and receive its answer.
  - info:
      name: Ask (stream)
      type: http
    http:
      method: POST
      url: https://www.mavenagi-apis.com/v1/conversations/{conversationId}/ask_stream
      body:
        type: json
        data: "{\n  \"conversationMessageId\": { \"referenceId\": \"\" },\n  \"userId\": { \"referenceId\": \"\" },\n  \"\
          text\": \"How do I reset my password?\"\n}"
    docs: Ask the agent a question and stream the answer as Server-Sent Events.
  - info:
      name: Update conversation metadata
      type: http
    http:
      method: PUT
      url: https://www.mavenagi-apis.com/v1/conversations/{conversationId}/metadata
      body:
        type: json
        data: '{}'
    docs: Replace conversation metadata.
  - info:
      name: Search conversations
      type: http
    http:
      method: POST
      url: https://www.mavenagi-apis.com/v1/conversations/search
      body:
        type: json
        data: '{}'
    docs: Search conversations.
- info:
    name: Knowledge
    type: folder
  items:
  - info:
      name: Create or update knowledge base
      type: http
    http:
      method: PUT
      url: https://www.mavenagi-apis.com/v1/knowledge
      body:
        type: json
        data: "{\n  \"knowledgeBaseId\": { \"referenceId\": \"\" },\n  \"name\": \"Help Center\"\n}"
    docs: Create or update a knowledge base.
  - info:
      name: Search knowledge bases
      type: http
    http:
      method: POST
      url: https://www.mavenagi-apis.com/v1/knowledge/search
      body:
        type: json
        data: '{}'
    docs: Search knowledge bases.
  - info:
      name: Create knowledge document
      type: http
    http:
      method: POST
      url: https://www.mavenagi-apis.com/v1/knowledge/{knowledgeBaseReferenceId}/document
      body:
        type: json
        data: "{\n  \"knowledgeDocumentId\": { \"referenceId\": \"\" },\n  \"contentType\": \"MARKDOWN\",\n  \"content\":\
          \ \"# Title\",\n  \"title\": \"Title\"\n}"
    docs: Create a knowledge document in a knowledge base.
  - info:
      name: Search knowledge documents
      type: http
    http:
      method: POST
      url: https://www.mavenagi-apis.com/v1/knowledge/documents/search
      body:
        type: json
        data: '{}'
    docs: Search knowledge documents.
- info:
    name: Actions
    type: folder
  items:
  - info:
      name: Create or update action
      type: http
    http:
      method: PUT
      url: https://www.mavenagi-apis.com/v1/actions
      body:
        type: json
        data: "{\n  \"actionId\": { \"referenceId\": \"\" },\n  \"name\": \"Look up order\",\n  \"description\": \"Fetch order\
          \ status by id\"\n}"
    docs: Create or update an action.
  - info:
      name: Search actions
      type: http
    http:
      method: POST
      url: https://www.mavenagi-apis.com/v1/actions/search
      body:
        type: json
        data: '{}'
    docs: Search actions.
- info:
    name: Users
    type: folder
  items:
  - info:
      name: Create or update user
      type: http
    http:
      method: PUT
      url: https://www.mavenagi-apis.com/v1/users
      body:
        type: json
        data: "{\n  \"userId\": { \"referenceId\": \"\" }\n}"
    docs: Create or update a user.
  - info:
      name: Search agent users
      type: http
    http:
      method: POST
      url: https://www.mavenagi-apis.com/v1/agentusers/search
      body:
        type: json
        data: '{}'
    docs: Search agent users.
- info:
    name: Events
    type: folder
  items:
  - info:
      name: Create event
      type: http
    http:
      method: POST
      url: https://www.mavenagi-apis.com/v1/events
      body:
        type: json
        data: '{}'
    docs: Create an event.
  - info:
      name: Search events
      type: http
    http:
      method: POST
      url: https://www.mavenagi-apis.com/v1/events/search
      body:
        type: json
        data: '{}'
    docs: Search events.
- info:
    name: Triggers
    type: folder
  items:
  - info:
      name: Create or update trigger
      type: http
    http:
      method: PUT
      url: https://www.mavenagi-apis.com/v1/triggers
      body:
        type: json
        data: '{}'
    docs: Create or update a trigger.
- info:
    name: Analytics
    type: folder
  items:
  - info:
      name: Get conversation table
      type: http
    http:
      method: POST
      url: https://www.mavenagi-apis.com/v1/tables/conversations
      body:
        type: json
        data: '{}'
    docs: Query the conversation analytics table.