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

# Api Semantic Metrics

> Metrics for the Semantic Layer page: the agent-authored semantic_models/metrics
YAML for the active environment, parsed into flat records.

Metric definitions live in git (customer logic). Create/edit/delete apply DIRECTLY to BOTH
environments (no PR), so editing is gated on GitHub being configured rather than on the env:
`editable` (+ `edit_reason`) drives the catalog's edit affordances regardless of which env
is being viewed.



## OpenAPI

````yaml /api/openapi.json get /api/semantic/metrics
openapi: 3.1.0
info:
  description: >-
    Environment-aware APIs for Platinur configuration, integrations, operations,
    promotions, scheduling, monitoring, and assistant tasks.
  title: Platinur Control Plane API
  version: 1.0.0-rc3
servers:
  - description: Local Platinur control-plane API
    url: http://localhost:8080
security: []
paths:
  /api/semantic/metrics:
    get:
      tags:
        - Control Plane
      summary: Api Semantic Metrics
      description: >-
        Metrics for the Semantic Layer page: the agent-authored
        semantic_models/metrics

        YAML for the active environment, parsed into flat records.


        Metric definitions live in git (customer logic). Create/edit/delete
        apply DIRECTLY to BOTH

        environments (no PR), so editing is gated on GitHub being configured
        rather than on the env:

        `editable` (+ `edit_reason`) drives the catalog's edit affordances
        regardless of which env

        is being viewed.
      operationId: api_semantic_metrics_api_semantic_metrics_get
      responses:
        '200':
          content:
            application/json:
              schema: {}
          description: Successful Response

````