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

# Count runs that need attention

> Across all sessions: runs RUNNING and QUEUED now, and runs with status FAILURE that started in the last `hours` (default 24). The history of each session is bounded by yukta.execution-log.retained-runs.



## OpenAPI

````yaml /api/openapi.json get /api/executions/counts
openapi: 3.1.0
info:
  description: >-
    Create sessions and workflows, start and steer executions, and read their
    status, logs and results. Alpha: paths and schemas may change before v0.1.0.
  title: Yukta REST API
  version: 0.1.0-alpha.3
servers: []
security:
  - bearerAuth: []
  - apiKeyAuth: []
tags:
  - description: Supervisors and control planes on the control bus
    name: Supervisors API
  - description: List the saved versions and roll back
    name: Workflow Versions API
  - description: Endpoints for starting workflows and listing their executions
    name: Workflow API
  - description: Edition, licence and features of this build
    name: Edition API
  - description: Stop, restart and observe workflow executions
    name: Execution API
  - description: Find runs across sessions
    name: Execution Search API
  - description: >-
      Endpoints for control bus operations, node management, and execution
      observability
    name: Control Bus & Observability API
  - description: Who is calling and what the key may do
    name: Session API
  - description: Read part of the output of a node
    name: Node Output API
  - description: Pause, resume, step and stop nodes
    name: Execution Control API
  - description: Endpoints for session and workflow discovery, configuration management
    name: Session API
  - description: Validate a draft workflow without saving it
    name: Session API
  - description: Workers connected to the control plane
    name: Workers API
  - description: Live feed of execution events
    name: Events API
  - description: Workflow DAG graph with plugin metadata and per-workflow execution history
    name: Workflow Details API
  - description: Follow the result of an execution
    name: Execution Results API
  - description: Stream execution logs
    name: Execution Logs API
  - description: Control commands and who sent them
    name: Control audit API
  - description: Example sessions to start from
    name: Templates API
  - description: Signed inbound calls that start a workflow
    name: Webhook API
  - description: Check a working directory before creating a session
    name: Session API
  - description: Endpoints for discovering workflow plugins
    name: Plugin API
paths:
  /api/executions/counts:
    get:
      tags:
        - Execution Search API
      summary: Count runs that need attention
      description: >-
        Across all sessions: runs RUNNING and QUEUED now, and runs with status
        FAILURE that started in the last `hours` (default 24). The history of
        each session is bounded by yukta.execution-log.retained-runs.
      operationId: counts
      parameters:
        - in: query
          name: hours
          required: false
          schema:
            default: 24
            format: int32
            type: integer
      responses:
        '200':
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ApiResponseCounts'
          description: OK
components:
  schemas:
    ApiResponseCounts:
      description: >-
        Unified API response wrapper for both success and error responses.
        Success responses include data field; error responses include error,
        path, and errors fields.
      properties:
        data:
          $ref: '#/components/schemas/Counts'
          description: The response data
        error:
          description: The HTTP status error name
          example: Bad Request
          type: string
        errors:
          description: The list of field validation errors
          items:
            $ref: '#/components/schemas/FieldError'
          type: array
        message:
          description: A human-readable message
          example: Operation successful
          type: string
        path:
          description: The request path
          example: /api/files
          type: string
        status:
          description: The HTTP status code
          example: 200
          format: int32
          type: integer
        timestamp:
          description: The time the response was generated
          format: date-time
          type: string
      type: object
    Counts:
      properties:
        failed:
          format: int32
          type: integer
        queued:
          format: int32
          type: integer
        running:
          format: int32
          type: integer
      type: object
    FieldError:
      description: Field-specific validation error detail
      properties:
        field:
          description: The name of the field that failed validation
          example: sessionId
          type: string
        message:
          description: The validation error message explaining the failure
          example: 'Session not found: ''unknown-session'''
          type: string
      type: object
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    apiKeyAuth:
      in: header
      name: X-API-Key
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.