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

# Get production insights topicId

> Requires scopes: traces:read



## OpenAPI

````yaml /api-reference/openapi.json get /api/production-insights/topics/{topicId}
openapi: 3.1.2
info:
  title: EvalGate API
  version: 18.13.0
  description: EvalGate API. See docs/api-contract.md for stability commitments.
servers:
  - url: https://evalgate.com
    description: Production
  - url: http://localhost:3000
    description: Local
security: []
paths:
  /api/production-insights/topics/{topicId}:
    get:
      tags:
        - production insights
      summary: Get production insights topicId
      description: 'Requires scopes: traces:read'
      operationId: get_production_insights_topics_topicId
      parameters:
        - name: topicId
          in: path
          required: true
          schema:
            type: string
        - name: coverageAfterCaseId
          in: query
          required: false
          schema:
            type: number
        - name: coverageAfterTraceId
          in: query
          required: false
          schema:
            type: number
        - name: coverageMapHash
          in: query
          required: false
          schema:
            type: string
        - name: historyCursor
          in: query
          required: false
          schema:
            type: string
        - name: historyLimit
          in: query
          required: false
          schema:
            type: number
        - name: historySection
          in: query
          required: false
          schema:
            oneOf:
              - type: string
                enum:
                  - decisions
              - type: string
                enum:
                  - links
              - type: string
                enum:
                  - memberships
              - type: string
                enum:
                  - snapshots
              - type: string
                enum:
                  - versions
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/GetApiProductionInsightsTopicsTopicIdResponse200ApplicationJson
        '400':
          $ref: '#/components/responses/ValidationError'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
      security:
        - bearerAuth: []
components:
  schemas:
    GetApiProductionInsightsTopicsTopicIdResponse200ApplicationJson:
      type: object
      properties:
        id:
          type: string
        organizationId:
          $ref: '#/components/schemas/OrganizationId'
        fingerprint:
          type: string
        name:
          type: string
        description:
          oneOf:
            - type: 'null'
            - type: string
        status:
          type: string
        severity:
          type: string
        cohortKinds:
          type: array
          items:
            type: string
        confidence:
          type: number
        currentVersionNumber:
          type: number
        firstSeenAt:
          type: string
          format: date-time
        lastSeenAt:
          type: string
          format: date-time
        continuityStartedAt:
          type: string
          format: date-time
        ownerId:
          oneOf:
            - type: 'null'
            - type: string
        createdBy:
          type: string
        suppressedAt:
          oneOf:
            - type: 'null'
            - type: string
              format: date-time
        suppressionReason:
          oneOf:
            - type: 'null'
            - type: string
        resolvedAt:
          oneOf:
            - type: 'null'
            - type: string
              format: date-time
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
        currentVersion:
          type: object
          properties:
            id:
              type: string
            organizationId:
              $ref: '#/components/schemas/OrganizationId'
            topicId:
              type: string
            versionNumber:
              type: number
            name:
              type: string
            description:
              oneOf:
                - type: 'null'
                - type: string
            severity:
              type: string
            definition:
              type: object
              properties:
                classifierVersion:
                  type: string
                fingerprint:
                  type: string
                category:
                  type: string
                signalHashes:
                  type: array
                  items:
                    type: string
                minConfidence:
                  type: number
                sourceVersion:
                  type: string
                mergedFrom:
                  type: array
                  items:
                    type: string
                splitFrom:
                  type: string
              additionalProperties: false
              required:
                - classifierVersion
                - fingerprint
                - category
                - signalHashes
                - minConfidence
                - sourceVersion
            state:
              type: string
            proposalSource:
              type: string
            modelCallId:
              oneOf:
                - type: 'null'
                - type: string
            contentHash:
              type: string
            basedOnVersion:
              oneOf:
                - type: 'null'
                - type: number
            proposedBy:
              oneOf:
                - type: 'null'
                - type: string
            decidedBy:
              oneOf:
                - type: 'null'
                - type: string
            decisionReason:
              oneOf:
                - type: 'null'
                - type: string
            createdAt:
              type: string
              format: date-time
            decidedAt:
              oneOf:
                - type: 'null'
                - type: string
                  format: date-time
          additionalProperties: false
          required:
            - id
            - organizationId
            - topicId
            - versionNumber
            - name
            - description
            - severity
            - definition
            - state
            - proposalSource
            - modelCallId
            - contentHash
            - basedOnVersion
            - proposedBy
            - decidedBy
            - decisionReason
            - createdAt
            - decidedAt
        protection:
          oneOf:
            - type: 'null'
            - type: object
              properties:
                items:
                  type: array
                  items:
                    type: object
                    properties:
                      evaluationId:
                        type: number
                      suiteCaseCount:
                        type: number
                      reviewed:
                        type: boolean
                      testCaseId:
                        type: number
                      caseHash:
                        oneOf:
                          - type: 'null'
                          - type: string
                      datasetVersionId:
                        oneOf:
                          - type: 'null'
                          - type: string
                      datasetRowContentHash:
                        oneOf:
                          - type: 'null'
                          - type: string
                      datasetId:
                        oneOf:
                          - type: 'null'
                          - type: string
                      datasetRowId:
                        oneOf:
                          - type: 'null'
                          - type: string
                      datasetSplit:
                        oneOf:
                          - type: 'null'
                          - type: string
                      datasetState:
                        oneOf:
                          - type: string
                            enum:
                              - not_applicable
                          - type: string
                            enum:
                              - unverified
                          - type: string
                            enum:
                              - verified
                      candidateId:
                        oneOf:
                          - type: 'null'
                          - type: number
                      reviewDecisionId:
                        oneOf:
                          - type: 'null'
                          - type: number
                      reviewedBy:
                        oneOf:
                          - type: 'null'
                          - type: string
                      sourceTraceId:
                        oneOf:
                          - type: 'null'
                          - type: number
                      sourceTraceRevisionId:
                        oneOf:
                          - type: 'null'
                          - type: string
                      sourceTraceRevisionHash:
                        oneOf:
                          - type: 'null'
                          - type: string
                      topicVersionId:
                        type: string
                      runId:
                        type: number
                      runManifestHash:
                        oneOf:
                          - type: 'null'
                          - type: string
                      environment:
                        oneOf:
                          - type: 'null'
                          - type: string
                      assertionSetVersions:
                        type: array
                        items:
                          type: string
                      applicableAssertions:
                        type: array
                        items:
                          type: string
                      assertionTrials:
                        type: array
                        items:
                          type: object
                          properties:
                            logicalTrialIndex:
                              type: number
                            assertionKeys:
                              type: array
                              items:
                                type: string
                            missingKeys:
                              type: array
                              items:
                                type: string
                            duplicateKeys:
                              type: array
                              items:
                                type: string
                            state:
                              oneOf:
                                - type: string
                                  enum:
                                    - applicable
                                - type: string
                                  enum:
                                    - duplicate
                                - type: string
                                  enum:
                                    - missing
                          additionalProperties: false
                          required:
                            - logicalTrialIndex
                            - assertionKeys
                            - missingKeys
                            - duplicateKeys
                            - state
                      currentEvaluatorIdentity:
                        oneOf:
                          - type: string
                            enum:
                              - archived
                          - type: string
                            enum:
                              - changed
                          - type: string
                            enum:
                              - matched
                          - type: string
                            enum:
                              - unavailable
                      sourceMaterialState:
                        type: string
                      state:
                        oneOf:
                          - type: string
                            enum:
                              - assertion_coverage_unknown
                          - type: string
                            enum:
                              - dataset_binding_unverified
                          - type: string
                            enum:
                              - execution_required
                          - type: string
                            enum:
                              - gate_binding_unknown
                          - type: string
                            enum:
                              - gate_verified
                          - type: string
                            enum:
                              - review_required
                          - type: string
                            enum:
                              - source_unverified
                          - type: string
                            enum:
                              - stale
                      evaluationOutcome:
                        oneOf:
                          - type: string
                            enum:
                              - failed
                          - type: string
                            enum:
                              - passed
                          - type: string
                            enum:
                              - unknown
                      enforcementScope:
                        type: string
                        enum:
                          - post_run_evaluation
                    additionalProperties: false
                    required:
                      - evaluationId
                      - suiteCaseCount
                      - reviewed
                      - testCaseId
                      - caseHash
                      - datasetVersionId
                      - datasetRowContentHash
                      - datasetId
                      - datasetRowId
                      - datasetSplit
                      - datasetState
                      - candidateId
                      - reviewDecisionId
                      - reviewedBy
                      - sourceTraceId
                      - sourceTraceRevisionId
                      - sourceTraceRevisionHash
                      - topicVersionId
                      - runId
                      - runManifestHash
                      - environment
                      - assertionSetVersions
                      - applicableAssertions
                      - assertionTrials
                      - currentEvaluatorIdentity
                      - sourceMaterialState
                      - state
                      - evaluationOutcome
                      - enforcementScope
                hasMore:
                  type: boolean
                nextCaseId:
                  oneOf:
                    - type: 'null'
                    - type: number
                populationCoverage:
                  type: 'null'
                uncertainty:
                  type: string
              additionalProperties: false
              required:
                - items
                - hasMore
                - nextCaseId
                - populationCoverage
                - uncertainty
        coverage:
          oneOf:
            - type: 'null'
            - type: object
              properties:
                version:
                  type: string
                  enum:
                    - evalgate.production-coverage-map.v1
                topicId:
                  type: string
                topicVersionId:
                  type: string
                frameHash:
                  oneOf:
                    - type: 'null'
                    - type: string
                frameState:
                  oneOf:
                    - type: string
                      enum:
                        - censored
                    - type: string
                      enum:
                        - complete
                    - type: string
                      enum:
                        - unavailable
                frameVersionCurrent:
                  type: boolean
                observedUnits:
                  type: number
                declaredTaskKeys:
                  type: array
                  items:
                    type: string
                verifiedProtectedUnits:
                  type: number
                unverifiedUnits:
                  type: number
                observedCoverage:
                  oneOf:
                    - type: 'null'
                    - type: number
                observedTrafficShare:
                  oneOf:
                    - type: 'null'
                    - type: number
                observedSuccessRate:
                  oneOf:
                    - type: 'null'
                    - type: number
                observedOutcomeCount:
                  type: number
                evaluationSuccessRate:
                  oneOf:
                    - type: 'null'
                    - type: number
                evaluatedCaseCount:
                  type: number
                linkedReviewedSuiteCaseShare:
                  oneOf:
                    - type: 'null'
                    - type: number
                linkedSuiteCaseCount:
                  type: number
                populationFrequency:
                  type: 'null'
                populationCoverage:
                  type: 'null'
                upstreamCaptureProbability:
                  type: 'null'
                freshness:
                  type: object
                  properties:
                    observationAgeDays:
                      oneOf:
                        - type: 'null'
                        - type: number
                    lastSeenAt:
                      type: string
                  additionalProperties: false
                  required:
                    - observationAgeDays
                    - lastSeenAt
                evidenceComplete:
                  type: boolean
                uncertainty:
                  type: array
                  items:
                    type: string
                mapHash:
                  type: string
                units:
                  type: array
                  items:
                    type: object
                    properties:
                      traceId:
                        type: number
                      traceKey:
                        type: string
                      traceRevisionId:
                        oneOf:
                          - type: 'null'
                          - type: string
                      traceRevisionHash:
                        oneOf:
                          - type: 'null'
                          - type: string
                      createdAt:
                        type: string
                      outcome:
                        oneOf:
                          - type: string
                            enum:
                              - failed
                          - type: string
                            enum:
                              - pending
                          - type: string
                            enum:
                              - succeeded
                          - type: string
                            enum:
                              - unknown
                      taskKey:
                        oneOf:
                          - type: 'null'
                          - type: string
                      inclusionProbability:
                        oneOf:
                          - type: 'null'
                          - type: number
                      attribution:
                        oneOf:
                          - type: string
                            enum:
                              - declared_task
                          - type: string
                            enum:
                              - exact_failure_membership
                      state:
                        oneOf:
                          - type: string
                            enum:
                              - gate_verified
                          - type: string
                            enum:
                              - unverified
                      verifiedCaseIds:
                        type: array
                        items:
                          type: number
                      linkedCaseIds:
                        type: array
                        items:
                          type: number
                      caseEvidence:
                        type: array
                        items:
                          type: object
                          properties:
                            evaluationId:
                              type: number
                            suiteCaseCount:
                              type: number
                            reviewed:
                              type: boolean
                            testCaseId:
                              type: number
                            caseHash:
                              oneOf:
                                - type: 'null'
                                - type: string
                            sourceTraceId:
                              oneOf:
                                - type: 'null'
                                - type: number
                            sourceTraceRevisionId:
                              oneOf:
                                - type: 'null'
                                - type: string
                            sourceTraceRevisionHash:
                              oneOf:
                                - type: 'null'
                                - type: string
                            datasetVersionId:
                              oneOf:
                                - type: 'null'
                                - type: string
                            datasetId:
                              oneOf:
                                - type: 'null'
                                - type: string
                            datasetRowId:
                              oneOf:
                                - type: 'null'
                                - type: string
                            datasetSplit:
                              oneOf:
                                - type: 'null'
                                - type: string
                            datasetRowContentHash:
                              oneOf:
                                - type: 'null'
                                - type: string
                            runId:
                              oneOf:
                                - type: 'null'
                                - type: number
                            runManifestHash:
                              oneOf:
                                - type: 'null'
                                - type: string
                            assertionSetVersions:
                              type: array
                              items:
                                type: string
                            state:
                              type: string
                            evaluationOutcome:
                              oneOf:
                                - type: string
                                  enum:
                                    - failed
                                - type: string
                                  enum:
                                    - passed
                                - type: string
                                  enum:
                                    - unknown
                          additionalProperties: false
                          required:
                            - evaluationId
                            - suiteCaseCount
                            - reviewed
                            - testCaseId
                            - caseHash
                            - sourceTraceId
                            - sourceTraceRevisionId
                            - sourceTraceRevisionHash
                            - datasetVersionId
                            - datasetId
                            - datasetRowId
                            - datasetSplit
                            - datasetRowContentHash
                            - runId
                            - runManifestHash
                            - assertionSetVersions
                            - state
                            - evaluationOutcome
                    additionalProperties: false
                    required:
                      - traceId
                      - traceKey
                      - traceRevisionId
                      - traceRevisionHash
                      - createdAt
                      - outcome
                      - taskKey
                      - inclusionProbability
                      - attribution
                      - state
                      - verifiedCaseIds
                      - linkedCaseIds
                      - caseEvidence
                hasMoreUnits:
                  type: boolean
                nextTraceId:
                  oneOf:
                    - type: 'null'
                    - type: number
              additionalProperties: false
              required:
                - version
                - topicId
                - topicVersionId
                - frameHash
                - frameState
                - frameVersionCurrent
                - observedUnits
                - declaredTaskKeys
                - verifiedProtectedUnits
                - unverifiedUnits
                - observedCoverage
                - observedTrafficShare
                - observedSuccessRate
                - observedOutcomeCount
                - evaluationSuccessRate
                - evaluatedCaseCount
                - linkedReviewedSuiteCaseShare
                - linkedSuiteCaseCount
                - populationFrequency
                - populationCoverage
                - upstreamCaptureProbability
                - freshness
                - evidenceComplete
                - uncertainty
                - mapHash
                - units
                - hasMoreUnits
                - nextTraceId
        proposalState:
          type: string
        proposalSource:
          type: string
        metrics:
          oneOf:
            - type: 'null'
            - type: object
              properties:
                traceCount:
                  type: number
                reportCount:
                  type: number
                affectedUsers:
                  type: number
                affectedWorkflows:
                  type: number
                totalCostUsd:
                  oneOf:
                    - type: 'null'
                    - type: string
                knownCostRecords:
                  type: number
                modelCounts:
                  type: object
                  additionalProperties:
                    type: number
                promptVersionCounts:
                  type: object
                  additionalProperties:
                    type: number
                deploymentVersionCounts:
                  type: object
                  additionalProperties:
                    type: number
                candidateCount:
                  type: number
                goldenCoverageCount:
                  type: number
                reviewCount:
                  type: number
                observationFrame:
                  type: object
                  properties:
                    canonicalExecutionId:
                      type: string
                    mode:
                      oneOf:
                        - type: string
                          enum:
                            - exact
                        - type: string
                          enum:
                            - stratified_sample
                    scope:
                      type: string
                      enum:
                        - eligible_failure_reports
                    totalEligibleRows:
                      type: number
                    sampledRows:
                      type: number
                    omittedRows:
                      type: number
                    lookbackBoundary:
                      type: string
                    samplingPolicyVersion:
                      type: string
                    state:
                      oneOf:
                        - type: string
                          enum:
                            - completed
                        - type: string
                          enum:
                            - failed
                        - type: string
                          enum:
                            - partial
                        - type: string
                          enum:
                            - running
                  additionalProperties: false
                  required:
                    - canonicalExecutionId
                    - mode
                    - scope
                    - totalEligibleRows
                    - sampledRows
                    - omittedRows
                    - lookbackBoundary
                    - samplingPolicyVersion
                    - state
              additionalProperties: false
              required:
                - traceCount
                - reportCount
                - affectedUsers
                - affectedWorkflows
                - totalCostUsd
                - knownCostRecords
                - modelCounts
                - promptVersionCounts
                - deploymentVersionCounts
                - candidateCount
                - goldenCoverageCount
                - reviewCount
        lifecycle:
          type: object
          properties:
            candidateCount:
              type: number
            goldenCoverageCount:
              type: number
            reviewCount:
              type: number
          additionalProperties: false
          required:
            - candidateCount
            - goldenCoverageCount
            - reviewCount
        versions:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              organizationId:
                $ref: '#/components/schemas/OrganizationId'
              topicId:
                type: string
              versionNumber:
                type: number
              name:
                type: string
              description:
                oneOf:
                  - type: 'null'
                  - type: string
              severity:
                type: string
              definition:
                type: object
                properties:
                  classifierVersion:
                    type: string
                  fingerprint:
                    type: string
                  category:
                    type: string
                  signalHashes:
                    type: array
                    items:
                      type: string
                  minConfidence:
                    type: number
                  sourceVersion:
                    type: string
                  mergedFrom:
                    type: array
                    items:
                      type: string
                  splitFrom:
                    type: string
                additionalProperties: false
                required:
                  - classifierVersion
                  - fingerprint
                  - category
                  - signalHashes
                  - minConfidence
                  - sourceVersion
              state:
                type: string
              proposalSource:
                type: string
              modelCallId:
                oneOf:
                  - type: 'null'
                  - type: string
              contentHash:
                type: string
              basedOnVersion:
                oneOf:
                  - type: 'null'
                  - type: number
              proposedBy:
                oneOf:
                  - type: 'null'
                  - type: string
              decidedBy:
                oneOf:
                  - type: 'null'
                  - type: string
              decisionReason:
                oneOf:
                  - type: 'null'
                  - type: string
              createdAt:
                type: string
                format: date-time
              decidedAt:
                oneOf:
                  - type: 'null'
                  - type: string
                    format: date-time
            additionalProperties: false
            required:
              - id
              - organizationId
              - topicId
              - versionNumber
              - name
              - description
              - severity
              - definition
              - state
              - proposalSource
              - modelCallId
              - contentHash
              - basedOnVersion
              - proposedBy
              - decidedBy
              - decisionReason
              - createdAt
              - decidedAt
        memberships:
          type: array
          items:
            type: object
            properties:
              membership:
                type: object
                properties:
                  id:
                    type: string
                  organizationId:
                    $ref: '#/components/schemas/OrganizationId'
                  topicId:
                    type: string
                  topicVersionId:
                    type: string
                  failureReportId:
                    type: number
                  traceId:
                    oneOf:
                      - type: 'null'
                      - type: number
                  alertId:
                    oneOf:
                      - type: 'null'
                      - type: number
                  confidence:
                    type: number
                  assignmentSource:
                    type: string
                  modelCallId:
                    oneOf:
                      - type: 'null'
                      - type: string
                  membershipKey:
                    type: string
                  evidence:
                    type: object
                    properties:
                      failureReportId:
                        type: number
                      traceId:
                        oneOf:
                          - type: 'null'
                          - type: number
                      groupHash:
                        type: string
                      category:
                        type: string
                      severity:
                        type: string
                      detectedBy:
                        type: array
                        items:
                          type: string
                      reportConfidence:
                        type: number
                      occurrenceCount:
                        type: number
                      evidenceHash:
                        type: string
                      redactionState:
                        oneOf:
                          - type: string
                            enum:
                              - redacted
                          - type: string
                            enum:
                              - source-redacted
                      modelCallId:
                        type: string
                      sourceMembershipIds:
                        type: array
                        items:
                          type: string
                    additionalProperties: false
                    required:
                      - failureReportId
                      - traceId
                      - groupHash
                      - category
                      - severity
                      - detectedBy
                      - reportConfidence
                      - evidenceHash
                      - redactionState
                  createdAt:
                    type: string
                    format: date-time
                  removedAt:
                    oneOf:
                      - type: 'null'
                      - type: string
                        format: date-time
                  removedByDecisionId:
                    oneOf:
                      - type: 'null'
                      - type: string
                  active:
                    type: boolean
                additionalProperties: false
                required:
                  - id
                  - organizationId
                  - topicId
                  - topicVersionId
                  - failureReportId
                  - traceId
                  - alertId
                  - confidence
                  - assignmentSource
                  - modelCallId
                  - membershipKey
                  - evidence
                  - createdAt
                  - removedAt
                  - removedByDecisionId
                  - active
              traceName:
                oneOf:
                  - type: 'null'
                  - type: string
              traceKey:
                oneOf:
                  - type: 'null'
                  - type: string
              traceCreatedAt:
                oneOf:
                  - type: 'null'
                  - type: string
                    format: date-time
            additionalProperties: false
            required:
              - membership
              - traceName
              - traceKey
              - traceCreatedAt
        snapshots:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              organizationId:
                $ref: '#/components/schemas/OrganizationId'
              topicId:
                type: string
              topicVersionId:
                type: string
              bucketStart:
                type: string
                format: date-time
              bucketGranularity:
                type: string
              metrics:
                type: object
                properties:
                  traceCount:
                    type: number
                  reportCount:
                    type: number
                  affectedUsers:
                    type: number
                  affectedWorkflows:
                    type: number
                  totalCostUsd:
                    oneOf:
                      - type: 'null'
                      - type: string
                  knownCostRecords:
                    type: number
                  modelCounts:
                    type: object
                    additionalProperties:
                      type: number
                  promptVersionCounts:
                    type: object
                    additionalProperties:
                      type: number
                  deploymentVersionCounts:
                    type: object
                    additionalProperties:
                      type: number
                  candidateCount:
                    type: number
                  goldenCoverageCount:
                    type: number
                  reviewCount:
                    type: number
                  observationFrame:
                    type: object
                    properties:
                      canonicalExecutionId:
                        type: string
                      mode:
                        oneOf:
                          - type: string
                            enum:
                              - exact
                          - type: string
                            enum:
                              - stratified_sample
                      scope:
                        type: string
                        enum:
                          - eligible_failure_reports
                      totalEligibleRows:
                        type: number
                      sampledRows:
                        type: number
                      omittedRows:
                        type: number
                      lookbackBoundary:
                        type: string
                      samplingPolicyVersion:
                        type: string
                      state:
                        oneOf:
                          - type: string
                            enum:
                              - completed
                          - type: string
                            enum:
                              - failed
                          - type: string
                            enum:
                              - partial
                          - type: string
                            enum:
                              - running
                    additionalProperties: false
                    required:
                      - canonicalExecutionId
                      - mode
                      - scope
                      - totalEligibleRows
                      - sampledRows
                      - omittedRows
                      - lookbackBoundary
                      - samplingPolicyVersion
                      - state
                additionalProperties: false
                required:
                  - traceCount
                  - reportCount
                  - affectedUsers
                  - affectedWorkflows
                  - totalCostUsd
                  - knownCostRecords
                  - modelCounts
                  - promptVersionCounts
                  - deploymentVersionCounts
                  - candidateCount
                  - goldenCoverageCount
                  - reviewCount
              continuityState:
                type: string
              evidenceCutoffAt:
                type: string
                format: date-time
              computedAt:
                type: string
                format: date-time
            additionalProperties: false
            required:
              - id
              - organizationId
              - topicId
              - topicVersionId
              - bucketStart
              - bucketGranularity
              - metrics
              - continuityState
              - evidenceCutoffAt
              - computedAt
        decisions:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              organizationId:
                $ref: '#/components/schemas/OrganizationId'
              topicId:
                type: string
              topicVersionId:
                oneOf:
                  - type: 'null'
                  - type: string
              action:
                type: string
              actorId:
                type: string
              expectedVersion:
                type: number
              beforeState:
                type: object
                additionalProperties:
                  $ref: '#/components/schemas/JsonValue'
              afterState:
                type: object
                additionalProperties:
                  $ref: '#/components/schemas/JsonValue'
              rationale:
                oneOf:
                  - type: 'null'
                  - type: string
              createdAt:
                type: string
                format: date-time
            additionalProperties: false
            required:
              - id
              - organizationId
              - topicId
              - topicVersionId
              - action
              - actorId
              - expectedVersion
              - beforeState
              - afterState
              - rationale
              - createdAt
        links:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              organizationId:
                $ref: '#/components/schemas/OrganizationId'
              topicId:
                type: string
              actionId:
                oneOf:
                  - type: 'null'
                  - type: string
              resourceType:
                type: string
              resourceId:
                type: string
              membershipId:
                oneOf:
                  - type: 'null'
                  - type: string
              createdAt:
                type: string
                format: date-time
            additionalProperties: false
            required:
              - id
              - organizationId
              - topicId
              - actionId
              - resourceType
              - resourceId
              - membershipId
              - createdAt
        history:
          type: object
          properties:
            versions:
              type: object
              properties:
                nextCursor:
                  oneOf:
                    - type: 'null'
                    - type: string
              additionalProperties: false
              required:
                - nextCursor
            memberships:
              type: object
              properties:
                nextCursor:
                  oneOf:
                    - type: 'null'
                    - type: string
              additionalProperties: false
              required:
                - nextCursor
            snapshots:
              type: object
              properties:
                nextCursor:
                  oneOf:
                    - type: 'null'
                    - type: string
              additionalProperties: false
              required:
                - nextCursor
            decisions:
              type: object
              properties:
                nextCursor:
                  oneOf:
                    - type: 'null'
                    - type: string
              additionalProperties: false
              required:
                - nextCursor
            links:
              type: object
              properties:
                nextCursor:
                  oneOf:
                    - type: 'null'
                    - type: string
              additionalProperties: false
              required:
                - nextCursor
          additionalProperties: false
          required:
            - versions
            - memberships
            - snapshots
            - decisions
            - links
        trend:
          type: object
          properties:
            currentCount:
              type: number
            previousCount:
              type: number
            changePercent:
              oneOf:
                - type: 'null'
                - type: number
            direction:
              oneOf:
                - type: string
                  enum:
                    - down
                - type: string
                  enum:
                    - flat
                - type: string
                  enum:
                    - unknown
                - type: string
                  enum:
                    - up
            continuity:
              oneOf:
                - type: string
                  enum:
                    - continuous
                - type: string
                  enum:
                    - discontinuous
                - type: string
                  enum:
                    - insufficient
          additionalProperties: false
          required:
            - currentCount
            - previousCount
            - changePercent
            - direction
            - continuity
      additionalProperties: false
      required:
        - id
        - organizationId
        - fingerprint
        - name
        - description
        - status
        - severity
        - cohortKinds
        - confidence
        - currentVersionNumber
        - firstSeenAt
        - lastSeenAt
        - continuityStartedAt
        - ownerId
        - createdBy
        - suppressedAt
        - suppressionReason
        - resolvedAt
        - createdAt
        - updatedAt
        - currentVersion
        - protection
        - coverage
        - proposalState
        - proposalSource
        - metrics
        - lifecycle
        - versions
        - memberships
        - snapshots
        - decisions
        - links
        - history
        - trend
    OrganizationId:
      type: string
      format: uuid
    JsonValue:
      oneOf:
        - type: 'null'
        - type: boolean
        - type: number
        - type: string
        - type: array
          items:
            $ref: '#/components/schemas/JsonValue'
        - type: object
          additionalProperties:
            $ref: '#/components/schemas/JsonValue'
    ApiError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - UNAUTHORIZED
                - FORBIDDEN
                - NOT_FOUND
                - INVALID_REFERENCE
                - VALIDATION_ERROR
                - RATE_LIMITED
                - CONFLICT
                - INTERNAL_ERROR
                - SERVICE_UNAVAILABLE
                - QUOTA_EXCEEDED
                - FEATURE_LIMIT_REACHED
                - NO_ORG_MEMBERSHIP
                - SHARE_REVOKED
                - SHARE_EXPIRED
                - SHARE_UNAVAILABLE
                - PROVIDER_KEY_MISSING
                - PROVIDER_KEY_EXPIRED
                - PROVIDER_RATE_LIMITED
                - PROVIDER_UNAUTHORIZED
                - PROVIDER_UNAVAILABLE
                - AGENT_HANDOFF_INVALID
                - AGENT_HANDOFF_EXPIRED
                - AGENT_HANDOFF_DENIED
                - AGENT_HANDOFF_CONSUMED
                - PAYLOAD_TOO_LARGE
                - METHOD_NOT_ALLOWED
            message:
              type: string
            details: {}
            requestId:
              type: string
              format: uuid
            redaction:
              type: object
              properties:
                applied:
                  type: boolean
                  enum:
                    - true
                fieldCount:
                  type: integer
                  minimum: 0
                secretCount:
                  type: integer
                  minimum: 0
              required:
                - applied
                - fieldCount
                - secretCount
          required:
            - code
            - message
      required:
        - error
  responses:
    ValidationError:
      description: Validation error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
      headers:
        RateLimit-Limit:
          description: Quota in requests for the active window.
          schema:
            type: integer
            minimum: 0
        RateLimit-Remaining:
          description: Remaining requests in the active window.
          schema:
            type: integer
            minimum: 0
        RateLimit-Reset:
          description: Reset delay in seconds (not a Unix timestamp).
          schema:
            type: integer
            minimum: 1
        X-RateLimit-Limit:
          schema:
            type: integer
            minimum: 0
        X-RateLimit-Remaining:
          schema:
            type: integer
            minimum: 0
        X-RateLimit-Reset:
          description: Legacy reset timestamp in Unix milliseconds.
          schema:
            type: integer
            minimum: 0
        RateLimit-Policy:
          description: IETF HTTPAPI structured quota policy (work in progress).
          schema:
            type: string
        RateLimit:
          description: >-
            IETF HTTPAPI structured remaining quota and reset delay (work in
            progress).
          schema:
            type: string
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
      headers:
        RateLimit-Limit:
          description: Quota in requests for the active window.
          schema:
            type: integer
            minimum: 0
        RateLimit-Remaining:
          description: Remaining requests in the active window.
          schema:
            type: integer
            minimum: 0
        RateLimit-Reset:
          description: Reset delay in seconds (not a Unix timestamp).
          schema:
            type: integer
            minimum: 1
        X-RateLimit-Limit:
          schema:
            type: integer
            minimum: 0
        X-RateLimit-Remaining:
          schema:
            type: integer
            minimum: 0
        X-RateLimit-Reset:
          description: Legacy reset timestamp in Unix milliseconds.
          schema:
            type: integer
            minimum: 0
        RateLimit-Policy:
          description: IETF HTTPAPI structured quota policy (work in progress).
          schema:
            type: string
        RateLimit:
          description: >-
            IETF HTTPAPI structured remaining quota and reset delay (work in
            progress).
          schema:
            type: string
        WWW-Authenticate:
          description: >-
            Bearer challenge. Agent-facing routes include the RFC 9728
            resource_metadata URL.
          schema:
            type: string
    Forbidden:
      description: Forbidden
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
      headers:
        RateLimit-Limit:
          description: Quota in requests for the active window.
          schema:
            type: integer
            minimum: 0
        RateLimit-Remaining:
          description: Remaining requests in the active window.
          schema:
            type: integer
            minimum: 0
        RateLimit-Reset:
          description: Reset delay in seconds (not a Unix timestamp).
          schema:
            type: integer
            minimum: 1
        X-RateLimit-Limit:
          schema:
            type: integer
            minimum: 0
        X-RateLimit-Remaining:
          schema:
            type: integer
            minimum: 0
        X-RateLimit-Reset:
          description: Legacy reset timestamp in Unix milliseconds.
          schema:
            type: integer
            minimum: 0
        RateLimit-Policy:
          description: IETF HTTPAPI structured quota policy (work in progress).
          schema:
            type: string
        RateLimit:
          description: >-
            IETF HTTPAPI structured remaining quota and reset delay (work in
            progress).
          schema:
            type: string
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
      headers:
        RateLimit-Limit:
          description: Quota in requests for the active window.
          schema:
            type: integer
            minimum: 0
        RateLimit-Remaining:
          description: Remaining requests in the active window.
          schema:
            type: integer
            minimum: 0
        RateLimit-Reset:
          description: Reset delay in seconds (not a Unix timestamp).
          schema:
            type: integer
            minimum: 1
        X-RateLimit-Limit:
          schema:
            type: integer
            minimum: 0
        X-RateLimit-Remaining:
          schema:
            type: integer
            minimum: 0
        X-RateLimit-Reset:
          description: Legacy reset timestamp in Unix milliseconds.
          schema:
            type: integer
            minimum: 0
        RateLimit-Policy:
          description: IETF HTTPAPI structured quota policy (work in progress).
          schema:
            type: string
        RateLimit:
          description: >-
            IETF HTTPAPI structured remaining quota and reset delay (work in
            progress).
          schema:
            type: string
    Conflict:
      description: Conflict
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
      headers:
        RateLimit-Limit:
          description: Quota in requests for the active window.
          schema:
            type: integer
            minimum: 0
        RateLimit-Remaining:
          description: Remaining requests in the active window.
          schema:
            type: integer
            minimum: 0
        RateLimit-Reset:
          description: Reset delay in seconds (not a Unix timestamp).
          schema:
            type: integer
            minimum: 1
        X-RateLimit-Limit:
          schema:
            type: integer
            minimum: 0
        X-RateLimit-Remaining:
          schema:
            type: integer
            minimum: 0
        X-RateLimit-Reset:
          description: Legacy reset timestamp in Unix milliseconds.
          schema:
            type: integer
            minimum: 0
        RateLimit-Policy:
          description: IETF HTTPAPI structured quota policy (work in progress).
          schema:
            type: string
        RateLimit:
          description: >-
            IETF HTTPAPI structured remaining quota and reset delay (work in
            progress).
          schema:
            type: string
    RateLimited:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
      headers:
        RateLimit-Limit:
          description: Quota in requests for the active window.
          schema:
            type: integer
            minimum: 0
        RateLimit-Remaining:
          description: Remaining requests in the active window.
          schema:
            type: integer
            minimum: 0
        RateLimit-Reset:
          description: Reset delay in seconds (not a Unix timestamp).
          schema:
            type: integer
            minimum: 1
        X-RateLimit-Limit:
          schema:
            type: integer
            minimum: 0
        X-RateLimit-Remaining:
          schema:
            type: integer
            minimum: 0
        X-RateLimit-Reset:
          description: Legacy reset timestamp in Unix milliseconds.
          schema:
            type: integer
            minimum: 0
        RateLimit-Policy:
          description: IETF HTTPAPI structured quota policy (work in progress).
          schema:
            type: string
        RateLimit:
          description: >-
            IETF HTTPAPI structured remaining quota and reset delay (work in
            progress).
          schema:
            type: string
        Retry-After:
          description: Delay in seconds before retrying when present.
          schema:
            type: integer
            minimum: 1
    InternalError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
      headers:
        RateLimit-Limit:
          description: Quota in requests for the active window.
          schema:
            type: integer
            minimum: 0
        RateLimit-Remaining:
          description: Remaining requests in the active window.
          schema:
            type: integer
            minimum: 0
        RateLimit-Reset:
          description: Reset delay in seconds (not a Unix timestamp).
          schema:
            type: integer
            minimum: 1
        X-RateLimit-Limit:
          schema:
            type: integer
            minimum: 0
        X-RateLimit-Remaining:
          schema:
            type: integer
            minimum: 0
        X-RateLimit-Reset:
          description: Legacy reset timestamp in Unix milliseconds.
          schema:
            type: integer
            minimum: 0
        RateLimit-Policy:
          description: IETF HTTPAPI structured quota policy (work in progress).
          schema:
            type: string
        RateLimit:
          description: >-
            IETF HTTPAPI structured remaining quota and reset delay (work in
            progress).
          schema:
            type: string
    ServiceUnavailable:
      description: Service unavailable
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
      headers:
        RateLimit-Limit:
          description: Quota in requests for the active window.
          schema:
            type: integer
            minimum: 0
        RateLimit-Remaining:
          description: Remaining requests in the active window.
          schema:
            type: integer
            minimum: 0
        RateLimit-Reset:
          description: Reset delay in seconds (not a Unix timestamp).
          schema:
            type: integer
            minimum: 1
        X-RateLimit-Limit:
          schema:
            type: integer
            minimum: 0
        X-RateLimit-Remaining:
          schema:
            type: integer
            minimum: 0
        X-RateLimit-Reset:
          description: Legacy reset timestamp in Unix milliseconds.
          schema:
            type: integer
            minimum: 0
        RateLimit-Policy:
          description: IETF HTTPAPI structured quota policy (work in progress).
          schema:
            type: string
        RateLimit:
          description: >-
            IETF HTTPAPI structured remaining quota and reset delay (work in
            progress).
          schema:
            type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: EvalGate API key
      description: >-
        Organization-scoped EvalGate API key. Discover the supported agent
        scopes at /.well-known/oauth-protected-resource. Per-operation grants
        are listed in x-evalgate-required-scopes; OpenAPI bearer security
        requirement arrays remain empty as required for non-OAuth schemes.
      x-evalgate-scopes-supported:
        - eval:read
        - eval:write
        - objectives:read
        - objectives:write
        - runs:read
        - runs:write
        - traces:read
        - traces:write
        - exports:download
        - reports:write
        - prompt:publish
        - scorer:publish
        - red_team:read
        - red_team:run
        - red_team:approve
        - docs:read
        - agent:read
        - agent:execute
        - resources:read
        - resources:write
        - contexts:read
        - contexts:write
        - observations:write
        - checks:read
        - checks:run
        - standards:read
        - standards:write
        - standards:approve
        - grants:read
        - grants:write
        - admin:keys
        - admin:workspace
        - admin:org
      x-evalgate-protected-resource-metadata: https://www.evalgate.com/.well-known/oauth-protected-resource

````

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