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

# List the users in a tenant



## OpenAPI

````yaml /api/openapi.json get /api/users
openapi: 3.1.0
info:
  title: aiAxonIQ API
  description: >-
    Multi-tenant observability and AI-ops platform.


    **Authentication.** Browser clients authenticate with the `oiq_token`
    HttpOnly cookie set by `POST /auth/login`; programmatic clients send
    `Authorization: Bearer <jwt>`.


    **Tenancy.** `tenantId` appears in many query strings and is always
    overwritten from the authenticated session. A request naming a tenant other
    than its own is refused with 403 rather than silently corrected.


    **Errors.** Every non-2xx response uses one shape. Branch on `error`, which
    is stable; `message` is human-readable and may be reworded.
  version: 1.0.0
  x-source-checksum: sha256:d65228bbd1857b90bc77ee8765efe765d058c0671c6844fce830cf7b30dc4254
servers:
  - url: https://app.aiaxoniq.com
    description: aiAxonIQ
security:
  - sessionCookie: []
  - bearerAuth: []
tags:
  - name: Authentication
    description: Sign in, refresh a session, and manage passwords and multi-factor codes.
  - name: Onboarding
    description: The state behind the in-product Get Started checklist.
  - name: License keys
    description: Mint, list and revoke the credentials that authenticate ingest.
  - name: Users and roles
    description: Organizations, membership and the four roles.
  - name: Overview
    description: Cross-signal counters and the platform event feed.
  - name: Logs
    description: Query logs, list queryable fields, and read discovered log patterns.
  - name: Metrics
    description: Query metrics and browse the metric catalogue.
  - name: Traces
    description: Query traces and fetch a single trace by id.
  - name: Services
    description: The service inventory, dependency graph, endpoints and deployment markers.
  - name: Infrastructure
    description: Hosts, processes, compute and disks.
  - name: Kubernetes
    description: Clusters, nodes, namespaces, pods and containers.
  - name: Databases
    description: Per-engine database telemetry and its time series.
  - name: Network
    description: Observed flows and network topology.
  - name: Dashboards
    description: Dashboards, panels, templates, versions and shareable snapshots.
  - name: Saved queries
    description: Saved queries and the query templates shipped with the product.
  - name: Alerts
    description: Alert rules, evaluation history, silences and test firing.
  - name: Notification channels
    description: Reusable channel credentials shared across rules.
  - name: SLOs
    description: Service level objectives, burn rate, forecasts and error-budget policies.
  - name: Synthetic monitoring
    description: Checks, runs, uptime, probe locations, variables and downtimes.
  - name: Security
    description: >-
      Security events, detection rules, runtime threats, secrets and
      vulnerabilities.
  - name: LLM observability
    description: Model requests, cost and latency for AI workloads.
  - name: AgentSight
    description: 'eBPF-observed AI-agent activity: agents, events, timeline and insights.'
  - name: AI
    description: >-
      Anomaly detection, forecasting, natural-language query, RAG and
      suggestions.
  - name: Audit log
    description: Who changed what, and export.
  - name: Usage and billing
    description: Ingest volume against plan limits, entitlements and billing.
  - name: Prometheus-compatible query API
    description: A PromQL-compatible read API for Grafana and other Prometheus clients.
paths:
  /api/users:
    get:
      tags:
        - Users and roles
      summary: List the users in a tenant
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 64
            pattern: ^[A-Za-z0-9][A-Za-z0-9_-]*$
          in: query
          name: tenantId
          required: false
          description: >-
            Tenant identifier. Overwritten from the authenticated session; a
            value naming a different tenant is refused with 403.
      responses:
        '200':
          description: Success
components:
  securitySchemes:
    sessionCookie:
      type: apiKey
      in: cookie
      name: oiq_token
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````