> ## 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.0 info: title: EvalGate API version: 3.7.6 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 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' security: - bearerAuth: - traces:read components: schemas: GetApiProductionInsightsTopicsTopicIdResponse200ApplicationJson: type: object properties: 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 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 active: type: boolean createdAt: type: string format: date-time removedAt: oneOf: - type: 'null' - type: string format: date-time removedByDecisionId: oneOf: - type: 'null' - type: string additionalProperties: false required: - id - organizationId - topicId - topicVersionId - failureReportId - traceId - alertId - confidence - assignmentSource - modelCallId - membershipKey - evidence - active - createdAt - removedAt - removedByDecisionId 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 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 trend: type: object properties: currentCount: type: number previousCount: type: number changePercent: oneOf: - type: 'null' - type: number direction: oneOf: - type: string enum: - flat - type: string enum: - unknown - type: string enum: - up - type: string enum: - down continuity: oneOf: - type: string enum: - continuous - type: string enum: - insufficient - type: string enum: - discontinuous additionalProperties: false required: - currentCount - previousCount - changePercent - direction - continuity 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 additionalProperties: false required: - currentVersion - versions - memberships - snapshots - decisions - links - trend - id - organizationId - fingerprint - name - description - status - severity - cohortKinds - confidence - currentVersionNumber - firstSeenAt - lastSeenAt - continuityStartedAt - ownerId - createdBy - suppressedAt - suppressionReason - resolvedAt - createdAt - updatedAt 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 - VALIDATION_ERROR - RATE_LIMITED - CONFLICT - INTERNAL_ERROR - SERVICE_UNAVAILABLE - QUOTA_EXCEEDED - NO_ORG_MEMBERSHIP - CROSS_ORG_REFERENCE - INCOMPLETE - MALFORMED message: type: string details: {} requestId: type: string format: uuid required: - code - message required: - error responses: ValidationError: description: Validation error content: application/json: schema: $ref: '#/components/schemas/ApiError' Unauthorized: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ApiError' Forbidden: description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ApiError' NotFound: description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ApiError' Conflict: description: Conflict content: application/json: schema: $ref: '#/components/schemas/ApiError' RateLimited: description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ApiError' InternalError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ApiError' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key or Session Token ````