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

# List universe presets

> Discover valid candidate-universe preset IDs.



## OpenAPI

````yaml api-reference/index-construction-preview-openapi.yaml GET /api/v1/catalog/universe_presets
openapi: 3.1.0
info:
  title: 'Tilt Index Construction API: Design Preview'
  version: 0.4.0-design-preview
  summary: >-
    A restrained public projection of Tilt's existing index construction
    workflow.
  description: |
    A Tilt is a persistent project for one index methodology. Its construction
    rules are the source, evaluated constituent snapshots are the build
    artifacts, and methodology history is version history. This bounded
    repository analogy does not imply branches, forks, merges, or cloning.

    This contract covers rules-based equity construction only. Applying
    construction saves the rules, evaluates them, and commits the complete
    weighted constituent snapshot atomically.
servers:
  - url: https://x.invalid
    description: Non-routable design preview
security:
  - ApiKey: []
tags:
  - name: Tilts
    description: Organization-owned Tilt projects and versions.
  - name: Construction
    description: Apply methodology and read its saved weighted evaluation.
  - name: Catalog
    description: >-
      Discover fields, functions, universes, and classifications used in
      expressions.
  - name: Tickers
    description: Resolve security identifiers to exact Tilt asset IDs.
  - name: Backtests
    description: Backtest a saved Tilt using its configured rebalance behavior.
paths:
  /api/v1/catalog/universe_presets:
    get:
      tags:
        - Catalog
      summary: List universe presets
      description: |
        Returns the live preset IDs accepted by Tilt creation and construction
        apply. IDs are service-discovered strings rather than a fixed API enum.
        A named index is not a universe preset; use `index("<name>") > 0` in a
        filter expression.
      operationId: listUniversePresets
      responses:
        '200':
          description: Available universe presets.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                required:
                  - success
                  - presets
                properties:
                  success:
                    type: boolean
                    const: true
                  presets:
                    type: array
                    items:
                      $ref: '#/components/schemas/UniversePreset'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    UniversePreset:
      type: object
      required:
        - id
        - name
        - description
      properties:
        id:
          type: string
        name:
          type: string
        description:
          type: string
        allowed_exchange_locations:
          type:
            - array
            - 'null'
          items:
            type: string
        allowed_exchanges:
          type:
            - array
            - 'null'
          items:
            type: string
        allowed_currencies:
          type:
            - array
            - 'null'
          items:
            type: string
        filter_expression:
          type:
            - string
            - 'null'
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          additionalProperties: false
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
  responses:
    Unauthorized:
      description: The API key is missing or invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-Api-Key

````