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

# List Logs

> Retrieve a list of all available log jobs with their metadata



## OpenAPI

````yaml GET /list
openapi: 3.0.3
info:
  title: Logging API
  description: >-
    API for uploading, retrieving, and managing log chunks in a distributed
    logging system
  version: 1.0.0
  contact:
    name: API Support
servers:
  - url: https://logging.monolisk.co
    description: Production server
  - url: http://localhost:8787
    description: Development server
security:
  - bearerAuth: []
tags:
  - name: logs
    description: Log management operations
  - name: chunks
    description: Chunk-specific operations
paths:
  /list:
    get:
      summary: List all logs
      description: Retrieve a list of all available log jobs with their metadata
      operationId: listLogs
      responses:
        '200':
          description: List of log jobs
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/LogKeyData'
              example:
                - jobId: job-123
                  meta:
                    jobType: build
                    gameId: game-456
                    placeId: 789
                    placeName: Main Place
                    startTime: '2025-01-01T00:00:00Z'
                    runtime: 5000
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '405':
          $ref: '#/components/responses/MethodNotAllowed'
        '500':
          description: Error listing logs
          content:
            text/plain:
              schema:
                type: string
                example: Error listing logs
      security:
        - bearerAuth: []
components:
  schemas:
    LogKeyData:
      type: object
      required:
        - jobId
        - meta
      properties:
        jobId:
          type: string
          description: Unique job identifier
          example: job-123
        meta:
          $ref: '#/components/schemas/JobMetadata'
    JobMetadata:
      type: object
      required:
        - jobType
        - gameId
        - startTime
        - runtime
      properties:
        jobType:
          type: string
          description: Type of job
          example: build
        jobId:
          type: string
          description: Unique job identifier
          example: job-123
        gameId:
          type: string
          description: Game identifier
          example: game-456
        placeId:
          type: integer
          description: Place identifier
          example: 789
        placeName:
          type: string
          description: Name of the place
          example: Main Place
        startTime:
          type: string
          format: date-time
          description: Job start time in ISO format
          example: '2025-01-01T00:00:00Z'
        runtime:
          type: integer
          description: Job runtime in milliseconds
          example: 5000
  responses:
    Unauthorized:
      description: Authentication required
      content:
        text/plain:
          schema:
            type: string
            example: Unauthorized
    Forbidden:
      description: Insufficient permissions
      content:
        text/plain:
          schema:
            type: string
            example: Forbidden
    MethodNotAllowed:
      description: HTTP method not allowed for this endpoint
      content:
        text/plain:
          schema:
            type: string
            example: Method Not Allowed
      headers:
        Allow:
          description: Allowed HTTP methods
          schema:
            type: string
            example: GET, POST
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Authorization header with Bearer token

````