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

# Fleet Vitals

> Return aggregated fleet metrics for the authenticated organization.

Computes instance counts, error rate, average token usage, and task
status distribution from current database state.

Returns:
    Fleet vitals with instance and task metrics.



## OpenAPI

````yaml https://api.pragmatiks.io/openapi.json get /agents/vitals
openapi: 3.1.0
info:
  title: Pragma API
  version: 0.1.0
servers: []
security: []
paths:
  /agents/vitals:
    get:
      tags:
        - fleet
      summary: Fleet Vitals
      description: |-
        Return aggregated fleet metrics for the authenticated organization.

        Computes instance counts, error rate, average token usage, and task
        status distribution from current database state.

        Returns:
            Fleet vitals with instance and task metrics.
      operationId: fleet-fleet_vitals
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FleetVitals'
components:
  schemas:
    FleetVitals:
      properties:
        active_instances:
          type: integer
          title: Active Instances
          default: 0
        error_rate:
          type: number
          title: Error Rate
          default: 0
        avg_turn_count:
          type: number
          title: Avg Turn Count
          default: 0
        avg_tokens_total:
          type: number
          title: Avg Tokens Total
          default: 0
        tasks_by_status:
          additionalProperties:
            type: integer
          type: object
          title: Tasks By Status
        instances_by_type:
          additionalProperties:
            type: integer
          type: object
          title: Instances By Type
      type: object
      title: FleetVitals
      description: |-
        Aggregated fleet metrics computed on read from current database state.

        Attributes:
            active_instances: Count of instances in starting, running, or waiting status.
            error_rate: Fraction of instances in error status over the last 24 hours.
            avg_turn_count: Average LLM turns across active instances.
            avg_tokens_total: Average total tokens across active instances.
            tasks_by_status: Task counts grouped by status.
            instances_by_type: Instance counts grouped by agent type ID.

````