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

# Get published label transformations

> The currently published label configuration: which source columns are merged into each engineered dimension and how their values are mapped. This is the live configuration, not a draft — the client holds label edits until it calls `POST /dimensions/publish`.



## OpenAPI

````yaml /api-reference/openapi.json get /dimensions/labels
openapi: 3.0.0
info:
  title: Costory
  version: '1.0'
  description: API Documentation
servers:
  - url: ''
    description: Production server
security: []
paths:
  /dimensions/labels:
    get:
      tags:
        - Dimensions
      summary: Get published label transformations
      description: >-
        The currently published label configuration: which source columns are
        merged into each engineered dimension and how their values are mapped.
        This is the live configuration, not a draft — the client holds label
        edits until it calls `POST /dimensions/publish`.
      operationId: getPublishedDimensionLabels
      responses:
        '200':
          description: Published label transformations
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublishedDimensionLabels'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Unauthorized'
      security:
        - bearerAuth: []
components:
  schemas:
    PublishedDimensionLabels:
      type: object
      properties:
        transformations:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                minLength: 1
              name:
                type: string
                pattern: ^[A-Za-z_][A-Za-z0-9_]{0,299}$
              columnsMerged:
                type: array
                items:
                  type: object
                  properties:
                    name:
                      type: string
                    type:
                      type: string
                      enum:
                        - label
                        - focus
                    ingested:
                      type: boolean
                  required:
                    - name
                    - type
              maps:
                type: array
                items:
                  type: object
                  properties:
                    value:
                      type: string
                    to:
                      type: string
                  required:
                    - value
                    - to
              category:
                type: string
                enum:
                  - environment
                  - boolean_flag
                  - team
                  - cost_significant
            required:
              - name
              - columnsMerged
              - maps
      required:
        - transformations
    Unauthorized:
      type: object
      properties:
        error:
          type: string
          description: Unauthorized error message
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT or Clerk ak_* API key
      description: >-
        Send `Authorization: Bearer <credential>` using either a Clerk session
        JWT or a Clerk API key (`ak_*`). API keys may identify a user (`user_*`)
        or organization (`org_*`) principal and are generated in the Clerk
        Dashboard under API keys.

````