Lemma Issues API

The Issues API from Lemma — 8 operation(s) for issues.

OpenAPI Specification

uselemma-issues-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Lemma Platform Artifacts Issues API
  description: Lemma Platform HTTP API for AI observability and workspace operations.
  version: 0.1.0
servers:
- url: https://api.uselemma.ai
  description: Lemma production API
security:
- bearerAuth: []
tags:
- name: Issues
paths:
  /issues:
    get:
      operationId: list_issues
      tags:
      - Issues
      summary: List issues
      description: List issues for a project.
      parameters:
      - name: project_id
        in: query
        required: true
        description: Project ID.
        schema:
          type: string
      - name: status
        in: query
        required: false
        description: Issue status filter.
        schema:
          type: string
      - name: limit
        in: query
        required: false
        description: Maximum number of records to return.
        schema:
          type: integer
          minimum: 1
      - name: offset
        in: query
        required: false
        description: Number of records to skip.
        schema:
          type: integer
          minimum: 0
      responses:
        '200':
          description: Issues list
          content:
            application/json:
              schema:
                type: object
                properties:
                  issues:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        project_id:
                          type: string
                        agent_name:
                          type:
                          - string
                          - 'null'
                        name:
                          type: string
                        subsystem:
                          type:
                          - string
                          - 'null'
                        failure_class:
                          type:
                          - string
                          - 'null'
                        canonical_mechanism:
                          type:
                          - string
                          - 'null'
                        status:
                          type: string
                          enum:
                          - open
                          - closed
                        created_at:
                          type:
                          - string
                          - 'null'
                          format: date-time
                        updated_at:
                          type:
                          - string
                          - 'null'
                          format: date-time
                        first_seen_at:
                          type:
                          - string
                          - 'null'
                          format: date-time
                        last_seen_at:
                          type:
                          - string
                          - 'null'
                          format: date-time
                        occurrence_count:
                          type: number
                        trace_count:
                          type: number
                        latest_close_feedback:
                          type:
                          - object
                          - 'null'
                          properties:
                            id:
                              type: string
                            issue_id:
                              type: string
                            project_id:
                              type: string
                            user_id:
                              type:
                              - string
                              - 'null'
                            api_key_id:
                              type:
                              - string
                              - 'null'
                            action:
                              type: string
                              enum:
                              - resolved
                              - dismissed
                            reason:
                              type:
                              - string
                              - 'null'
                            detail:
                              type:
                              - string
                              - 'null'
                            created_at:
                              type:
                              - string
                              - 'null'
                              format: date-time
                          required:
                          - id
                          - issue_id
                          - project_id
                          - user_id
                          - api_key_id
                          - action
                          - reason
                          - detail
                          - created_at
                          additionalProperties: false
                        linked_metric:
                          type:
                          - object
                          - 'null'
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                          required:
                          - id
                          - name
                          additionalProperties: false
                        validation:
                          type:
                          - object
                          - 'null'
                          properties:
                            status:
                              type: string
                              enum:
                              - valid
                              - invalid
                              - inconclusive
                              - failed
                              - not_run
                          required:
                          - status
                          additionalProperties: false
                        lane_scores:
                          type:
                          - object
                          - 'null'
                          properties:
                            A:
                              type: number
                            B:
                              type: number
                            C:
                              type: number
                          required:
                          - A
                          - B
                          - C
                          additionalProperties: false
                        raw_lane_scores:
                          type:
                          - object
                          - 'null'
                          properties:
                            impact_occurrences:
                              type: number
                            impact_project_occurrences:
                              type: number
                            impact_project_traces:
                              type: number
                            impact_occurrence_share:
                              type: number
                            impact_affected_traces:
                              type: number
                            impact_trace_share:
                              type: number
                            impact_trace_share_lower:
                              type: number
                            impact_judged_traces:
                              type: number
                            spike_current:
                              type: number
                            spike_baseline:
                              type: number
                            spike_ratio:
                              type: number
                            spike_baseline_count:
                              type: number
                            spike_baseline_exposure:
                              type: number
                            spike_current_exposure:
                              type: number
                            persistence_span_days:
                              type: number
                            persistence_active_days:
                              type: number
                            resolution_floor:
                              type:
                              - number
                              - 'null'
                          required:
                          - impact_occurrences
                          - impact_project_occurrences
                          - impact_project_traces
                          - impact_occurrence_share
                          - impact_affected_traces
                          - impact_trace_share
                          - impact_trace_share_lower
                          - impact_judged_traces
                          - spike_current
                          - spike_baseline
                          - spike_ratio
                          - spike_baseline_count
                          - spike_baseline_exposure
                          - spike_current_exposure
                          - persistence_span_days
                          - persistence_active_days
                          - resolution_floor
                          additionalProperties: false
                        lanes_fired:
                          type:
                          - array
                          - 'null'
                          items:
                            type: string
                            enum:
                            - A
                            - B
                            - C
                        metric_flags:
                          type: object
                          properties:
                            impact:
                              type:
                              - boolean
                              - 'null'
                            spike:
                              type:
                              - boolean
                              - 'null'
                            persistence:
                              type:
                              - boolean
                              - 'null'
                          required:
                          - impact
                          - spike
                          - persistence
                          additionalProperties: false
                        fired_count:
                          type:
                          - number
                          - 'null'
                        surface:
                          type:
                          - boolean
                          - 'null'
                        notify:
                          type:
                          - boolean
                          - 'null'
                        priority_computed_at:
                          type:
                          - string
                          - 'null'
                          format: date-time
                      required:
                      - id
                      - project_id
                      - agent_name
                      - name
                      - subsystem
                      - failure_class
                      - canonical_mechanism
                      - status
                      - created_at
                      - updated_at
                      - first_seen_at
                      - last_seen_at
                      - occurrence_count
                      - trace_count
                      - latest_close_feedback
                      - linked_metric
                      - validation
                      - lane_scores
                      - raw_lane_scores
                      - lanes_fired
                      - metric_flags
                      - fired_count
                      - surface
                      - notify
                      - priority_computed_at
                      additionalProperties: false
                  total:
                    type: number
                  limit:
                    type: number
                  offset:
                    type: number
                  has_more:
                    type: boolean
                required:
                - issues
                - total
                - limit
                - offset
                - has_more
                additionalProperties: false
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                required:
                - detail
                additionalProperties: false
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                required:
                - detail
                additionalProperties: false
  /issues/dashboard:
    get:
      operationId: list_dashboard_issues
      tags:
      - Issues
      summary: List dashboard issues
      description: List dashboard-ready issues for a project.
      parameters:
      - name: project_id
        in: query
        required: true
        description: Project ID.
        schema:
          type: string
      responses:
        '200':
          description: Dashboard issues
          content:
            application/json:
              schema:
                type: object
                properties:
                  issues:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                        status:
                          type: string
                          enum:
                          - open
                          - closed
                        agent_name:
                          type:
                          - string
                          - 'null'
                        subsystem:
                          type:
                          - string
                          - 'null'
                        failure_class:
                          type:
                          - string
                          - 'null'
                        canonical_mechanism:
                          type:
                          - string
                          - 'null'
                        first_seen_at:
                          type:
                          - string
                          - 'null'
                          format: date-time
                        last_seen_at:
                          type:
                          - string
                          - 'null'
                          format: date-time
                        occurrence_count:
                          type: number
                        trace_count:
                          type: number
                        latest_close_feedback:
                          type:
                          - object
                          - 'null'
                          properties:
                            id:
                              type: string
                            issue_id:
                              type: string
                            project_id:
                              type: string
                            user_id:
                              type:
                              - string
                              - 'null'
                            api_key_id:
                              type:
                              - string
                              - 'null'
                            action:
                              type: string
                              enum:
                              - resolved
                              - dismissed
                            reason:
                              type:
                              - string
                              - 'null'
                            detail:
                              type:
                              - string
                              - 'null'
                            created_at:
                              type:
                              - string
                              - 'null'
                              format: date-time
                          required:
                          - id
                          - issue_id
                          - project_id
                          - user_id
                          - api_key_id
                          - action
                          - reason
                          - detail
                          - created_at
                          additionalProperties: false
                        linked_metric:
                          type:
                          - object
                          - 'null'
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                          required:
                          - id
                          - name
                          additionalProperties: false
                        validation:
                          type:
                          - object
                          - 'null'
                          properties:
                            status:
                              type: string
                              enum:
                              - valid
                              - invalid
                              - inconclusive
                              - failed
                              - not_run
                          required:
                          - status
                          additionalProperties: false
                        lane_scores:
                          type:
                          - object
                          - 'null'
                          properties:
                            A:
                              type: number
                            B:
                              type: number
                            C:
                              type: number
                          required:
                          - A
                          - B
                          - C
                          additionalProperties: false
                        raw_lane_scores:
                          type:
                          - object
                          - 'null'
                          properties:
                            impact_occurrences:
                              type: number
                            impact_project_occurrences:
                              type: number
                            impact_project_traces:
                              type: number
                            impact_occurrence_share:
                              type: number
                            impact_affected_traces:
                              type: number
                            impact_trace_share:
                              type: number
                            impact_trace_share_lower:
                              type: number
                            impact_judged_traces:
                              type: number
                            spike_current:
                              type: number
                            spike_baseline:
                              type: number
                            spike_ratio:
                              type: number
                            spike_baseline_count:
                              type: number
                            spike_baseline_exposure:
                              type: number
                            spike_current_exposure:
                              type: number
                            persistence_span_days:
                              type: number
                            persistence_active_days:
                              type: number
                            resolution_floor:
                              type:
                              - number
                              - 'null'
                          required:
                          - impact_occurrences
                          - impact_project_occurrences
                          - impact_project_traces
                          - impact_occurrence_share
                          - impact_affected_traces
                          - impact_trace_share
                          - impact_trace_share_lower
                          - impact_judged_traces
                          - spike_current
                          - spike_baseline
                          - spike_ratio
                          - spike_baseline_count
                          - spike_baseline_exposure
                          - spike_current_exposure
                          - persistence_span_days
                          - persistence_active_days
                          - resolution_floor
                          additionalProperties: false
                        lanes_fired:
                          type:
                          - array
                          - 'null'
                          items:
                            type: string
                            enum:
                            - A
                            - B
                            - C
                        metric_flags:
                          type: object
                          properties:
                            impact:
                              type:
                              - boolean
                              - 'null'
                            spike:
                              type:
                              - boolean
                              - 'null'
                            persistence:
                              type:
                              - boolean
                              - 'null'
                          required:
                          - impact
                          - spike
                          - persistence
                          additionalProperties: false
                        fired_count:
                          type:
                          - number
                          - 'null'
                        surface:
                          type:
                          - boolean
                          - 'null'
                        notify:
                          type:
                          - boolean
                          - 'null'
                        priority_computed_at:
                          type:
                          - string
                          - 'null'
                          format: date-time
                      required:
                      - id
                      - name
                      - status
                      - agent_name
                      - subsystem
                      - failure_class
                      - canonical_mechanism
                      - first_seen_at
                      - last_seen_at
                      - occurrence_count
                      - trace_count
                      - latest_close_feedback
                      - linked_metric
                      - validation
                      - lane_scores
                      - raw_lane_scores
                      - lanes_fired
                      - metric_flags
                      - fired_count
                      - surface
                      - notify
                      - priority_computed_at
                      additionalProperties: false
                required:
                - issues
                additionalProperties: false
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                required:
                - detail
                additionalProperties: false
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                required:
                - detail
                additionalProperties: false
  /issues/{issue_id}:
    get:
      operationId: get_issue
      tags:
      - Issues
      summary: Get issue
      description: Get a single issue. The validation field is null when no validation row exists; when present it contains status, confidence, evidenceSummary, checkedTools, caveats, and validatedAt.
      parameters:
      - name: issue_id
        in: path
        required: true
        description: Issue ID.
        schema:
          type: string
      responses:
        '200':
          description: Issue
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  project_id:
                    type: string
                  agent_name:
                    type:
                    - string
                    - 'null'
                  name:
                    type: string
                  subsystem:
                    type:
                    - string
                    - 'null'
                  failure_class:
                    type:
                    - string
                    - 'null'
                  canonical_mechanism:
                    type:
                    - string
                    - 'null'
                  status:
                    type: string
                    enum:
                    - open
                    - closed
                  created_at:
                    type:
                    - string
                    - 'null'
                    format: date-time
                  updated_at:
                    type:
                    - string
                    - 'null'
                    format: date-time
                  latest_close_feedback:
                    type:
                    - object
                    - 'null'
                    properties:
                      id:
                        type: string
                      issue_id:
                        type: string
                      project_id:
                        type: string
                      user_id:
                        type:
                        - string
                        - 'null'
                      api_key_id:
                        type:
                        - string
                        - 'null'
                      action:
                        type: string
                        enum:
                        - resolved
                        - dismissed
                      reason:
                        type:
                        - string
                        - 'null'
                      detail:
                        type:
                        - string
                        - 'null'
                      created_at:
                        type:
                        - string
                        - 'null'
                        format: date-time
                    required:
                    - id
                    - issue_id
                    - project_id
                    - user_id
                    - api_key_id
                    - action
                    - reason
                    - detail
                    - created_at
                    additionalProperties: false
                  linked_metric:
                    type:
                    - object
                    - 'null'
                    properties:
                      id:
                        type: string
                      name:
                        type: string
                    required:
                    - id
                    - name
                    additionalProperties: false
                  validation:
                    type:
                    - object
                    - 'null'
                    properties:
                      status:
                        type: string
                        enum:
                        - valid
                        - invalid
                        - inconclusive
                        - failed
                        - not_run
                      confidence:
                        type:
                        - number
                        - 'null'
                      evidenceSummary:
                        type:
                        - string
                        - 'null'
                      checkedTools:
                        type: array
                        items:
                          type: string
                      caveats:
                        type:
                        - string
                        - 'null'
                      validatedAt:
                        type:
                        - string
                        - 'null'
                        format: date-time
                    required:
                    - status
                    - confidence
                    - evidenceSummary
                    - checkedTools
                    - caveats
                    - validatedAt
                    additionalProperties: false
                  lane_scores:
                    type:
                    - object
                    - 'null'
                    properties:
                      A:
                        type: number
                      B:
                        type: number
                      C:
                        type: number
                    required:
                    - A
                    - B
                    - C
                    additionalProperties: false
                  raw_lane_scores:
                    type:
                    - object
                    - 'null'
                    properties:
                      impact_occurrences:
                        type: number
                      impact_project_occurrences:
                        type: number
                      impact_project_traces:
                        type: number
                      impact_occurrence_share:
                        type: number
                      impact_affected_traces:
                        type: number
                      impact_trace_share:
                        type: number
                      impact_trace_share_lower:
                        type: number
                      impact_judged_traces:
                        type: number
                      spike_current:
                        type: number
                      spike_baseline:
                        type: number
                      spike_ratio:
                        type: number
                      spike_baseline_count:
                        type: number
                      spike_baseline_exposure:
                        type: number
                      spike_current_exposure:
                        type: number
                      persistence_span_days:
                        type: number
                      persistence_active_days:
                        type: number
                      resolution_floor:
                        type:
                        - number
                        - 'null'
                    required:
                    - impact_occurrences
                    - impact_project_occurrences
                    - impact_project_traces
                    - impact_occurrence_share
                    - impact_affected_traces
                    - impact_trace_share
                    - impact_trace_share_lower
                    - impact_judged_traces
                    - spike_current
                    - spike_baseline
                    - spike_ratio
          

# --- truncated at 32 KB (60 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/uselemma/refs/heads/main/openapi/uselemma-issues-api-openapi.yml