---
title: "Get topic"
method: GET
path: "/api/v1/models/{modelId}/topic/{topicName}"
tags: ["Models"]
---

# Get topic

`GET /api/v1/models/{modelId}/topic/{topicName}`

## Path parameters

- `modelId` string, uuid, required — Model UUID
- `topicName` string, required — Topic name

## Query parameters

- `branch_id` string, uuid — Branch ID to use for branch-aware operations

## Response `200`

Topic details with relationships and views

- ModelsGetTopicResponse
  - `success` boolean, required — Whether the operation succeeded
  - `topic` object, required — Topic details with relationships and views
    - `base_view_name` string, required — Base view name for the topic
    - `description` string — Topic description
    - `group_label` string — Group label
    - `hidden` boolean — Whether the topic is hidden
    - `label` string — Topic label
    - `name` string, required — Topic name
    - `relationships` object[], required — Relationships for the topic
      - `bidirectional` boolean
      - `extension_model_id` string
      - `id` string, required
      - `ignored` boolean
      - `join_type` string, required
      - `left_view_alias` string
      - `left_view_label` string
      - `left_view_name` string, required
      - `original_on_sql` string, required
      - `right_view_alias` string
      - `right_view_label` string
      - `right_view_name` string, required
      - `sql` string, required
      - `type` string, required
      - `yaml_path_prefix` string
    - `views` object[], required — Views available in the topic
      - `ai_context` string
      - `aliases` string[], nullable
      - `catalog` string
      - `default_drill_fields` string[], nullable
      - `description` string
      - `dimensions` object[], required
        - `field_name` string, required — Field name
      - `display_order` number
      - `extension_model_id` string
      - `fields_limited` boolean, nullable
      - `filter_only_fields` object[], required
        - `field_name` string, required — Field name
      - `folder` string
      - `hidden` boolean
      - `ide_file_name` string, required
      - `ignored` boolean
      - `is_pseudo_display_view` boolean
      - `label` string
      - `measures` object[], required
        - `field_name` string, required — Field name
      - `name` string, required
      - `schema` string
      - `schema_label` string
      - `table_name` string
      - `tags` string[]
      - `topic_scope` string
      - `topic_scope_label` string
      - `yaml_path` string, nullable, required

## Other responses

- `401` — Authentication required
- `403` — Permission denied
- `404` — Model or topic not found

---

[API](https://skmtc.net/omniapp/apis/omni-api.md) · [All operations](https://skmtc.net/omniapp/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omniapp/omni-api/versions/4701f292c621/schema)