> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Detailed end-user Teams bot (MAU) breakdown for a month

> Per-company and per-user active-end-user breakdown (>=2 messages that month) for the white-label end-user Teams bot, each with the bot-raised PSA tickets behind it (deep-links when the PSA is configured), plus a monthly active-user trend ending at the selected month. Companion to /billing/end-user-teams-usage (headline MAU + dollar charge); this is the drill-down. Exposes the customer's own usage, never provider/LLM cost.



## OpenAPI

````yaml https://api.neoagent.io/public-api/openapi.json get /public-api/billing/end-user-teams/detail
openapi: 3.1.0
info:
  description: >-
    Neo's public contract for the dashboard ChatAgent, partner integrations, and
    MSP automation. Every response is wrapped in a `{data, meta}` envelope;
    errors use `{error: {code, message, details?}, meta: {request_id}}`.
    Authenticate with a `Bearer neo_sk_<env>_<secret>` API key (service account)
    or a Microsoft Entra ID JWT (dashboard user). Signed-URL endpoints (end-user
    feedback links) take a `signature` query parameter instead.
  title: Neo Public API
  version: 1.0.0
servers:
  - url: https://api.neoagent.io
security: []
tags:
  - description: Service metadata — health, OpenAPI.
    name: Meta
  - description: Agents and workflows — read, version history, delete, stats.
    name: Agents
  - description: Agent/workflow execution history, sub-resources, retry/cancel.
    name: Executions
  - description: PSA webhook events and their workflow-match results.
    name: Callbacks
  - description: Technician-in-the-loop approval requests.
    name: TIL requests
  - description: RMM script executions triggered by agents.
    name: RMM scripts
  - description: Dispatch-agent field-update decisions.
    name: Dispatch
  - description: The authenticated tenant.
    name: Tenant
  - description: Agent-builder schema catalogs (raw JSON payloads).
    name: Schemas
  - description: Escalate to the Neo team (HubSpot ticket).
    name: Escalation
  - description: Tenant settings.
    name: Settings
  - description: Tenant API-key management (dashboard JWT only).
    name: API keys
  - description: End-user feedback links (signed-URL auth).
    name: Feedback
  - description: End-client companies (CRUD + bulk-update).
    name: End companies
  - description: Channels — bind a CONVERSATIONAL agent to a transport (Teams).
    name: Channels
  - description: PSA/RMM/M365 integration status and connection management.
    name: Integrations
  - description: Technician roster (controls TIL routing and paging).
    name: Technicians
  - description: Future runs queued for TRIGGERED agents.
    name: Scheduled work
  - description: Subscription state and customer-facing credit usage (no provider $).
    name: Billing
  - description: Inbox messages and announcements.
    name: Inbox & Comms
  - description: Tenant-authored agent skills (CRUD) and the built-in skill catalog.
    name: Skills
paths:
  /public-api/billing/end-user-teams/detail:
    get:
      tags:
        - Billing
      summary: Detailed end-user Teams bot (MAU) breakdown for a month
      description: >-
        Per-company and per-user active-end-user breakdown (>=2 messages that
        month) for the white-label end-user Teams bot, each with the bot-raised
        PSA tickets behind it (deep-links when the PSA is configured), plus a
        monthly active-user trend ending at the selected month. Companion to
        /billing/end-user-teams-usage (headline MAU + dollar charge); this is
        the drill-down. Exposes the customer's own usage, never provider/LLM
        cost.
      operationId: public_api.billing_end_user_teams_detail_get
      parameters:
        - description: Month in `YYYY-MM` format. Defaults to current month.
          in: query
          name: month
          required: false
          schema:
            type: string
        - description: >-
            Trend length in months (1-24, default 6), ending at the selected
            month.
          in: query
          name: months
          required: false
          schema:
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/EndUserTeamsDetail'
                  meta:
                    $ref: '#/components/schemas/SuccessMeta'
                required:
                  - data
                  - meta
                type: object
          description: Success.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Bad request — malformed input.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Unauthenticated — missing or invalid credentials.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Forbidden — authenticated but not allowed.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Not found.
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Conflict — the resource is in a state that blocks this operation.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Request validation failed.
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Rate limited — see Retry-After.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Internal server error.
      security:
        - bearerAuth: []
components:
  schemas:
    EndUserTeamsDetail:
      description: >-
        Detailed end-user Teams bot MAU breakdown for the selected month:
        per-company (named) +

        per-user + bot-raised ticket count, plus a monthly active-user trend
        ending at that month.

        Dollar billing (projected charge / trial state) stays on
        `/billing/end-user-teams-usage`.
      properties:
        monthly_active_users:
          items:
            $ref: '#/components/schemas/EndUserTeamsMonthlyPoint'
          title: Monthly Active Users
          type: array
        per_company:
          items:
            $ref: '#/components/schemas/EndUserTeamsCompanyBreakdown'
          title: Per Company
          type: array
        per_user:
          items:
            $ref: '#/components/schemas/EndUserTeamsActiveUser'
          title: Per User
          type: array
        tickets_raised:
          title: Tickets Raised
          type: integer
      required:
        - per_company
        - per_user
        - monthly_active_users
        - tickets_raised
      title: EndUserTeamsDetail
      type: object
    SuccessMeta:
      properties:
        pagination:
          $ref: '#/components/schemas/Pagination'
        request_id:
          format: uuid
          type: string
        timings_ms:
          additionalProperties:
            type: number
          type: object
        warnings:
          description: >-
            Non-fatal warnings about the created/updated resource (e.g. an
            unhealthy PSA callback).
          items:
            type: string
          type: array
      required:
        - request_id
        - timings_ms
      type: object
    ErrorEnvelope:
      properties:
        error:
          properties:
            code:
              description: Stable machine-readable error code.
              type: string
            details:
              additionalProperties: true
              type: object
            message:
              type: string
          required:
            - code
            - message
          type: object
        meta:
          properties:
            request_id:
              format: uuid
              type:
                - string
                - 'null'
          type: object
      required:
        - error
        - meta
      type: object
    EndUserTeamsMonthlyPoint:
      description: One point on the monthly active-user trend.
      properties:
        active_users:
          title: Active Users
          type: integer
        month:
          title: Month
          type: string
      required:
        - month
        - active_users
      title: EndUserTeamsMonthlyPoint
      type: object
    EndUserTeamsCompanyBreakdown:
      description: >-
        Active users + bot-raised tickets for one end-company in the selected
        month. `company_name` is

        None when the end_company_id has no named row (unmatched); `tickets`
        lists the tickets behind

        `tickets_raised` (most recent first).
      properties:
        active_users:
          title: Active Users
          type: integer
        company_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Company Name
        end_company_id:
          anyOf:
            - type: string
            - type: 'null'
          title: End Company Id
        tickets:
          items:
            $ref: '#/components/schemas/EndUserTeamsTicket'
          title: Tickets
          type: array
        tickets_raised:
          title: Tickets Raised
          type: integer
      required:
        - end_company_id
        - company_name
        - active_users
        - tickets_raised
        - tickets
      title: EndUserTeamsCompanyBreakdown
      type: object
    EndUserTeamsActiveUser:
      description: >-
        One active end-user (>=2 messages that month) — the expand under its
        company.
      properties:
        company_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Company Name
        end_company_id:
          anyOf:
            - type: string
            - type: 'null'
          title: End Company Id
        end_user:
          title: End User
          type: string
        end_user_email:
          anyOf:
            - type: string
            - type: 'null'
          title: End User Email
        tickets:
          items:
            $ref: '#/components/schemas/EndUserTeamsTicket'
          title: Tickets
          type: array
        tickets_raised:
          title: Tickets Raised
          type: integer
        turns:
          title: Turns
          type: integer
      required:
        - end_company_id
        - company_name
        - end_user
        - end_user_email
        - turns
        - tickets_raised
        - tickets
      title: EndUserTeamsActiveUser
      type: object
    Pagination:
      properties:
        has_more:
          type: boolean
        next_cursor:
          type:
            - string
            - 'null'
      required:
        - next_cursor
        - has_more
      type: object
    EndUserTeamsTicket:
      description: >-
        A bot-raised PSA ticket: `ticket_id` is the PSA ticket number; `url` is
        a PSA deep-link (None

        when it can't be built, e.g. the PSA isn't configured).
      properties:
        ticket_id:
          title: Ticket Id
          type: string
        url:
          anyOf:
            - type: string
            - type: 'null'
          title: Url
      required:
        - ticket_id
        - url
      title: EndUserTeamsTicket
      type: object
  securitySchemes:
    bearerAuth:
      description: >-
        `Authorization: Bearer <token>` where `<token>` is either a
        `neo_sk_<env>_<secret>` API key (service account) or a Microsoft Entra
        ID access token (dashboard user).
      scheme: bearer
      type: http

````