> ## 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.

# Get Metadata

> Retrieve metadata about a log including the total number of chunks



## OpenAPI

````yaml GET /metadata
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:
  /metadata:
    get:
      summary: Get log metadata
      description: Retrieve metadata about a log including the total number of chunks
      operationId: getLogMetadata
      parameters:
        - name: jobId
          in: query
          required: true
          description: The job ID to retrieve metadata for
          schema:
            type: string
            example: job-123
      responses:
        '200':
          description: Log metadata
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChunkMetadata'
              example:
                jobId: job-123
                totalChunks: 3
                originalMeta:
                  jobType: build
                  gameId: game-456
                  placeId: 789
                  placeName: Main Place
                  startTime: '2025-01-01T00:00:00Z'
                  runtime: 5000
        '400':
          description: Missing jobId parameter
          content:
            text/plain:
              schema:
                type: string
                example: Missing jobId
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          description: Log metadata not found
          content:
            text/plain:
              schema:
                type: string
                example: Log metadata not found
        '405':
          $ref: '#/components/responses/MethodNotAllowed'
        '500':
          description: Error retrieving log metadata
          content:
            text/plain:
              schema:
                type: string
                example: Error retrieving log metadata
      security:
        - bearerAuth: []
components:
  schemas:
    ChunkMetadata:
      type: object
      required:
        - jobId
        - totalChunks
        - originalMeta
      properties:
        jobId:
          type: string
          description: Unique job identifier
          example: job-123
        totalChunks:
          type: integer
          description: Total number of chunks for this job
          minimum: 1
          example: 3
        originalMeta:
          $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

````