openapi: 3.0.3
info:
  title: Maven AGI Platform Actions Analytics API
  version: '1.0'
  description: The Maven AGI Platform API lets developers build apps on the Maven AGI enterprise AI agent platform. It exposes conversations, knowledge, actions, users, agents, events, triggers, app settings, and analytics. Requests authenticate with an App ID and App Secret supplied as HTTP Basic credentials, together with X-Organization-Id and X-Agent-Id headers that scope the request to a specific organization and agent. Paths in this document are relative to the /v1 base path.
  contact:
    name: Maven AGI
    url: https://docs.mavenagi.com
  license:
    name: Proprietary
servers:
- url: https://www.mavenagi-apis.com/v1
  description: Production
- url: https://www.staging.mavenagi-apis.com/v1
  description: Staging
security:
- appAuth: []
tags:
- name: Analytics
paths:
  /tables/conversations:
    post:
      tags:
      - Analytics
      operationId: getConversationTable
      summary: Get conversation analytics table
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: The conversation table.
          content:
            application/json:
              schema:
                type: object
  /charts/conversations:
    post:
      tags:
      - Analytics
      operationId: getConversationChart
      summary: Get conversation analytics chart
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: The conversation chart.
          content:
            application/json:
              schema:
                type: object
  /tables/events:
    post:
      tags:
      - Analytics
      operationId: getEventTable
      summary: Get event analytics table
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: The event table.
          content:
            application/json:
              schema:
                type: object
  /tables/feedback:
    post:
      tags:
      - Analytics
      operationId: getFeedbackTable
      summary: Get feedback analytics table
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: The feedback table.
          content:
            application/json:
              schema:
                type: object
components:
  securitySchemes:
    appAuth:
      type: http
      scheme: basic
      description: HTTP Basic authentication using the App ID as the username and the App Secret as the password. Requests must also send X-Organization-Id and X-Agent-Id headers to scope the call to an organization and agent.