Select Star

Select Star tags API

The tags API from Select Star — 5 operation(s) for tags.

GitHub OpenAPI

Operations 9

GET /v1/tags/ #
POST /v1/tags/ #
PATCH /v1/tags/ #
GET /v1/tags/{guid}/ #
PATCH /v1/tags/{guid}/ #
DELETE /v1/tags/{guid}/ #
GET /v1/tags/hierarchy/ #
PATCH /v1/tags/items/ #
GET /v1/tags/items/{guid}/ #

Documentation

📖
Authentication
https://raw.githubusercontent.com/api-evangelist/select-star/refs/heads/main/authentication/select-star-authentication.yml
📖
Documentation
https://docs.selectstar.com/select-star-api/overview
📖
APIReference
https://api.production.selectstar.com/docs/
📖
GettingStarted
https://docs.selectstar.com/select-star-api/quick-start

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/select-star/refs/heads/main/openapi/select-star-tags-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/select-star-tags-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

select-star-tags-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Select Star Metadata bi Tags API
  version: 1.0.0
  x-role-system:
    description: This API uses role-based access control
    roles:
      admin: Full access to all operations
      data_manager: Can modify data and configurations
      user: Read-only access to most resources
  description: API for interacting with the Select Star system
  termsOfService: https://www.selectstar.com/terms-of-service
  contact:
    email: support@selectstar.com
  license:
    name: All Rights Reserved
servers:
- url: https://api.production.selectstar.com
  description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: tags
paths:
  /v1/tags/:
    get:
      operationId: tags_list
      description: 'List of the tags available in authenticated user''s organization


        **Required Role:** Viewer or higher'
      parameters:
      - name: datasources
        required: false
        in: query
        description: A comma separated list of data source guids to filter for items within those data sources. Works for dbt tags
        schema:
          type: string
          pattern: ^(ti)_(?P<guid>[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22})$
      - name: items
        required: false
        in: query
        description: A comma separated list of item guids to filter for their tags.
        schema:
          type: string
      - name: only_visible
        required: false
        in: query
        description: An optional boolean filter to show visible items. If only_visible is set to `false`, then all tags (including hidden tags) are returned, otherwise only visible tags are returned.
        schema:
          type: string
      - name: owners
        required: false
        in: query
        description: A comma separated list of user guids to filter for tag owners
        schema:
          type: string
      - name: page
        required: false
        in: query
        description: A page number within the paginated result set.
        schema:
          type: integer
      - name: page_size
        required: false
        in: query
        description: Number of results to return per page.
        schema:
          type: integer
      - name: parents
        required: false
        in: query
        description: A comma separated list of tag parent guids to filter for
        schema:
          type: string
      - name: top_level
        required: false
        in: query
        description: Filter tags to only return top level tags (tags without a parent). For example, 'top_level=true'. If top_level is set to `false`, then all tags are returned. Defaults to `false`.
        schema:
          type: string
      - name: types
        required: false
        in: query
        description: 'A comma separated list of tag types to filter. Supported types: [''status'']'
        schema:
          type: string
          enum:
          - status
      - name: updated_on
        required: false
        in: query
        description: "Filter objects by updated_on. May specify __gt, __gte, __lt or __lte.\n\n API call to: \n\n ENDPOINT/updated_on__gt=2021-08-04T15:12:40&updated_on__lt=2021-08-23 \n\n will result with objects updated_on after  August 4th 2021 at 15:12:40, but before August 23rd 2021. \n\n. If you want to include lower or upper bound of the range use __gte or __lte respectively."
        schema:
          type: string
      tags:
      - tags
      security:
      - JWTAuthentication: []
      - tokenAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedTagList'
          description: ''
      x-role-requirements: Viewer or higher
    post:
      operationId: tags_create
      description: 'Create a tag within authenticated user''s organization


        **Required Role:** Admin'
      tags:
      - tags
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TagRequest'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/TagRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/TagRequest'
        required: true
      security:
      - JWTAuthentication: []
      - tokenAuth: []
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Tag'
          description: ''
      x-role-requirements: Admin
    patch:
      operationId: tags_bulk_update
      description: 'Update tags in bulk


        **Required Role:** Admin'
      tags:
      - tags
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchedTagLiteBulkEditRequest'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/PatchedTagLiteBulkEditRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/PatchedTagLiteBulkEditRequest'
      security:
      - JWTAuthentication: []
      - tokenAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TagLiteBulkEdit'
          description: ''
      x-role-requirements: Admin
  /v1/tags/{guid}/:
    get:
      operationId: tags_retrieve
      description: 'Retrieve a single tag


        **Required Role:** Viewer or higher'
      parameters:
      - in: path
        name: guid
        schema:
          type: string
          pattern: ^([a-zA-z]{2}_[a-zA-Z0-9]{22})|me|default|([a-zA-z]{2}_[a-zA-Z0-9]{22}).personal$
        required: true
      tags:
      - tags
      security:
      - JWTAuthentication: []
      - tokenAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Tag'
          description: ''
      x-role-requirements: Viewer or higher
    patch:
      operationId: tags_partial_update
      description: 'Update a single tag


        **Required Role:** Admin'
      parameters:
      - in: path
        name: guid
        schema:
          type: string
          pattern: ^([a-zA-z]{2}_[a-zA-Z0-9]{22})|me|default|([a-zA-z]{2}_[a-zA-Z0-9]{22}).personal$
        required: true
      tags:
      - tags
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchedTagRequest'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/PatchedTagRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/PatchedTagRequest'
      security:
      - JWTAuthentication: []
      - tokenAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Tag'
          description: ''
      x-role-requirements: Admin
    delete:
      operationId: tags_destroy
      description: 'Archive a single tag


        **Required Role:** Admin'
      parameters:
      - name: datasources
        required: false
        in: query
        description: A comma separated list of data source guids to filter for items within those data sources. Works for dbt tags
        schema:
          type: string
          pattern: ^(ti)_(?P<guid>[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22})$
      - in: path
        name: guid
        schema:
          type: string
          pattern: ^([a-zA-z]{2}_[a-zA-Z0-9]{22})|me|default|([a-zA-z]{2}_[a-zA-Z0-9]{22}).personal$
        required: true
      - name: items
        required: false
        in: query
        description: A comma separated list of item guids to filter for their tags.
        schema:
          type: string
      - name: only_visible
        required: false
        in: query
        description: An optional boolean filter to show visible items. If only_visible is set to `false`, then all tags (including hidden tags) are returned, otherwise only visible tags are returned.
        schema:
          type: string
      - name: owners
        required: false
        in: query
        description: A comma separated list of user guids to filter for tag owners
        schema:
          type: string
      - name: parents
        required: false
        in: query
        description: A comma separated list of tag parent guids to filter for
        schema:
          type: string
      - name: top_level
        required: false
        in: query
        description: Filter tags to only return top level tags (tags without a parent). For example, 'top_level=true'. If top_level is set to `false`, then all tags are returned. Defaults to `false`.
        schema:
          type: string
      - name: types
        required: false
        in: query
        description: 'A comma separated list of tag types to filter. Supported types: [''status'']'
        schema:
          type: string
          enum:
          - status
      - name: updated_on
        required: false
        in: query
        description: "Filter objects by updated_on. May specify __gt, __gte, __lt or __lte.\n\n API call to: \n\n ENDPOINT/updated_on__gt=2021-08-04T15:12:40&updated_on__lt=2021-08-23 \n\n will result with objects updated_on after  August 4th 2021 at 15:12:40, but before August 23rd 2021. \n\n. If you want to include lower or upper bound of the range use __gte or __lte respectively."
        schema:
          type: string
      tags:
      - tags
      security:
      - JWTAuthentication: []
      - tokenAuth: []
      responses:
        '204':
          description: No response body
      x-role-requirements: Admin
  /v1/tags/hierarchy/:
    get:
      operationId: tags_hierarchy_list
      description: 'This viewset has been created for the main sidebar in the frontend.

        This will respond back in a similar way to DataSources Hierarchy

        to ensure uniformity in the frontend.


        **Required Role:** Authenticated User with Active Organization'
      parameters:
      - name: only_visible
        required: false
        in: query
        description: An optional boolean filter to show visible items. If only_visible is set to `false`, then all tags (including hidden tags) are returned, otherwise only visible tags are returned.
        schema:
          type: string
      tags:
      - tags
      security:
      - JWTAuthentication: []
      - tokenAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TagsHierarchy'
          description: ''
      x-role-requirements: Authenticated User with Active Organization
  /v1/tags/items/:
    patch:
      operationId: tags_items_partial_update
      description: 'Update multiple tagged items.


        **Required Role:** Data Manager or higher'
      tags:
      - tags
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchedTagItemsBulkEditRequest'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/PatchedTagItemsBulkEditRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/PatchedTagItemsBulkEditRequest'
      security:
      - JWTAuthentication: []
      - tokenAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TagItemsBulkEdit'
          description: ''
      x-role-requirements: Data Manager or higher
  /v1/tags/items/{guid}/:
    get:
      operationId: tags_items_list
      description: 'List of the taggedItems available


        **Required Role:** Viewer or higher'
      parameters:
      - in: path
        name: guid
        schema:
          type: string
          pattern: ^([a-zA-z]{2}_[a-zA-Z0-9]{22})|me|default|([a-zA-z]{2}_[a-zA-Z0-9]{22}).personal$
        required: true
      - name: kind
        required: false
        in: query
        description: Filter out any tagged item kind. Allowed values 'user' and 'suggestion'
        schema:
          type: string
      - name: object_type
        required: false
        in: query
        description: A comma separated list of asset types to filter for tagged_items
        schema:
          type: string
      - name: order
        required: false
        in: query
        description: "Specify the ordering for the results. \n\n A comma separated list for ordering by multiple fields and a preceding `-` indicates reverse order. \n\nNote: Order is case-sensitive."
        schema:
          type: string
          enum:
          - description
          - name
          - popularity
      - name: page
        required: false
        in: query
        description: A page number within the paginated result set.
        schema:
          type: integer
      - name: page_size
        required: false
        in: query
        description: Number of results to return per page.
        schema:
          type: integer
      - name: search_description
        required: false
        in: query
        description: A search term.
        schema:
          type: string
      - name: search_name
        required: false
        in: query
        description: A search term.
        schema:
          type: string
      - name: search_tag_name
        required: false
        in: query
        description: Search for an asset using a tag name
        schema:
          type: string
      tags:
      - tags
      security:
      - JWTAuthentication: []
      - tokenAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedTaggedItemsList'
          description: ''
      x-role-requirements: Viewer or higher
components:
  schemas:
    Type6b6Enum:
      enum:
      - airflow
      - aws_s3
      - bigquery
      - data_studio
      - databricks
      - db_agent
      - db2
      - dbt
      - fivetran
      - glue
      - hex
      - looker
      - metabase
      - mode
      - monte_carlo
      - mssql
      - mysql
      - omni
      - openlineage
      - oracle
      - periscope
      - postgres
      - power_bi
      - quicksight
      - redshift
      - salesforce
      - salesforce_crma
      - sigma
      - snowflake
      - tableau
      - thoughtspot
      - trial
      - trial_redshift
      type: string
      description: '* `airflow` - Airflow

        * `aws_s3` - AWS S3

        * `bigquery` - BigQuery

        * `data_studio` - Looker Studio

        * `databricks` - Databricks

        * `db_agent` - DB Agent

        * `db2` - DB2

        * `dbt` - dbt

        * `fivetran` - Fivetran

        * `glue` - Glue

        * `hex` - Hex

        * `looker` - Looker

        * `metabase` - Metabase

        * `mode` - Mode

        * `monte_carlo` - Monte Carlo

        * `mssql` - MS SQL

        * `mysql` - MySQL

        * `omni` - Omni BI

        * `openlineage` - Open Lineage

        * `oracle` - Oracle

        * `periscope` - Periscope

        * `postgres` - PostgreSQL

        * `power_bi` - Power BI

        * `quicksight` - QuickSight

        * `redshift` - Redshift

        * `salesforce` - Salesforce

        * `salesforce_crma` - Salesforce Analytics

        * `sigma` - Sigma

        * `snowflake` - Snowflake

        * `tableau` - Tableau

        * `thoughtspot` - ThoughtSpot

        * `trial` - Trial

        * `trial_redshift` - Trial Redshift'
    LookMLView:
      type: object
      description: 'Adds support for reading a description from metadata

        that support modifying description'
      properties:
        guid:
          type: string
          readOnly: true
        name:
          type: string
          readOnly: true
          description: Fully-qualified name of the field
        label:
          type: string
          readOnly: true
          description: Fully-qualified human-readable label of the field
        project_name:
          type:
          - string
          - 'null'
          readOnly: true
          description: Name of project containing the view
        data_source:
          allOf:
          - $ref: '#/components/schemas/DataSourceInfo'
          readOnly: true
        external_id:
          type: string
          readOnly: true
          description: External unique identifier of this resource
        breadcrumbs:
          type: array
          items:
            $ref: '#/components/schemas/Breadcrumb'
          readOnly: true
        tagged_items:
          type: array
          items:
            $ref: '#/components/schemas/TaggedItemsLiteWithSource'
          readOnly: true
        description:
          type:
          - string
          - 'null'
          description: Active description
        description_source:
          allOf:
          - $ref: '#/components/schemas/DescriptionSourceEnum'
          readOnly: true
        user_description:
          type:
          - string
          - 'null'
          readOnly: true
          description: User description
        user_description_author:
          allOf:
          - $ref: '#/components/schemas/UserLite'
          readOnly: true
        ai_description:
          type:
          - string
          - 'null'
          readOnly: true
          description: AI-generated description
        ingested_description:
          type:
          - string
          - 'null'
          readOnly: true
          description: Unmodified description from the data source
        richtext_description:
          type:
          - string
          - 'null'
          description: Richtext formatted description. Can be in Slatejs or Draftjs format.
        explores:
          type: array
          items:
            $ref: '#/components/schemas/ExploreLabel'
          readOnly: true
        business_owner:
          $ref: '#/components/schemas/LookMLViewSerializer.GuidReferenceField.business_owner'
        technical_owner:
          $ref: '#/components/schemas/LookMLViewSerializer.GuidReferenceField.technical_owner'
        popularity:
          allOf:
          - $ref: '#/components/schemas/LookerViewPopularity'
          readOnly: true
        search_name:
          type: string
          readOnly: true
        downstream_objects_counts:
          allOf:
          - $ref: '#/components/schemas/RelatedObjectsCounts'
          readOnly: true
        upstream_objects_counts:
          allOf:
          - $ref: '#/components/schemas/RelatedObjectsCounts'
          readOnly: true
        data_types:
          allOf:
          - $ref: '#/components/schemas/BaseType'
          readOnly: true
        collections:
          type: array
          items:
            $ref: '#/components/schemas/CollectionLite'
          readOnly: true
      required:
      - ai_description
      - breadcrumbs
      - collections
      - data_source
      - data_types
      - description_source
      - downstream_objects_counts
      - explores
      - external_id
      - guid
      - ingested_description
      - label
      - name
      - popularity
      - project_name
      - search_name
      - tagged_items
      - upstream_objects_counts
      - user_description
      - user_description_author
    Tag:
      type: object
      properties:
        guid:
          type: string
          maxLength: 25
        type:
          $ref: '#/components/schemas/TypeB32Enum'
        name:
          type: string
          description: Tag display name
        description:
          type:
          - string
          - 'null'
          description: Active description
        richtext_description:
          type:
          - string
          - 'null'
          description: Richtext formatted description. Can be in Slatejs or Draftjs format.
        icon:
          type: string
          description: Icon identifier (for status tags)
        color:
          type: string
          description: 'Tag color (for category tags). Allowed formats: ''#ffeedd'' and ''#ffeeddcc'' (RGB/ARGB hexadecimal)'
          maxLength: 9
          deprecated: true
        parent:
          type:
          - string
          - 'null'
        ordinal:
          type: integer
          readOnly: true
        updated_on:
          type: string
          format: date-time
          readOnly: true
        owner:
          allOf:
          - $ref: '#/components/schemas/TagSerializer.GuidReferenceField.owner'
        breadcrumbs:
          type: array
          items:
            $ref: '#/components/schemas/Breadcrumb'
          readOnly: true
        visible:
          type: boolean
        links_to:
          type:
          - string
          - 'null'
        count:
          type: integer
          readOnly: true
        linked_from:
          type: array
          items:
            type: string
          readOnly: true
          description: Tags having a link to this tag
        data_types:
          allOf:
          - $ref: '#/components/schemas/BaseType'
          readOnly: true
        is_auto_generated:
          type: boolean
          description: Whether this tag was auto-generated by the system
      required:
      - breadcrumbs
      - count
      - data_types
      - linked_from
      - name
      - ordinal
      - type
      - updated_on
    DescriptionSourceEnum:
      enum:
      - user
      - ingestion
      - ai
      - public_docs
      - lineage
      - downstream_lineage
      - upstream_lineage
      - similarity
      - unknown
      type: string
      description: '* `user` - User

        * `ingestion` - Ingestion

        * `ai` - Ai

        * `public_docs` - Public Docs

        * `lineage` - Lineage

        * `downstream_lineage` - Downstream Lineage

        * `upstream_lineage` - Upstream Lineage

        * `similarity` - Similarity

        * `unknown` - Unknown'
    Dashboard:
      type: object
      description: 'Adds support for reading a description from metadata

        that support modifying description'
      properties:
        guid:
          type: string
          maxLength: 25
        bifolder:
          $ref: '#/components/schemas/BIFolder'
        name:
          type:
          - string
          - 'null'
        data_type:
          type: string
          readOnly: true
        description:
          type:
          - string
          - 'null'
          description: Active description
        search_name:
          type: string
          readOnly: true
        description_source:
          allOf:
          - $ref: '#/components/schemas/DescriptionSourceEnum'
        user_description:
          type:
          - string
          - 'null'
          description: User description
        user_description_author:
          allOf:
          - $ref: '#/components/schemas/UserLite'
          readOnly: true
        ingested_description:
          type:
          - string
          - 'null'
          description: Unmodified description from the data source
        ai_description:
          type:
          - string
          - 'null'
          description: AI-generated description
        richtext_description:
          type:
          - string
          - 'null'
          description: Richtext formatted description. Can be in Slatejs or Draftjs format.
        dashboard_created_at:
          type:
          - string
          - 'null'
          format: date-time
          description: The creation date ingested from API
        dashboard_updated_at:
          type:
          - string
          - 'null'
          format: date-time
          description: The updation date ingested from API
        last_successful_run:
          type:
          - string
          - 'null'
          format: date-time
          description: The last date where the dashboard was successfully run at
        was_last_run_successful:
          type:
          - boolean
          - 'null'
          description: Was the last run to this dashboard successful at the time we ingested?
        last_run_at:
          type:
          - string
          - 'null'
          format: date-time
          description: The last date where the dashboard was attempted to run at
        query_count:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
        chart_count:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
        runs_count:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
        view_count:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
        dsuser_created_by:
          $ref: '#/components/schemas/DSUser'
        top_dsuser:
          $ref: '#/components/schemas/DSUser'
        dsuser_owned_by:
          $ref: '#/components/schemas/DSUser'
        business_owner:
          $ref: '#/components/schemas/DashboardSerializer.GuidReferenceField.business_owner'
        technical_owner:
          $ref: '#/components/schemas/DashboardSerializer.GuidReferenceField.technical_owner'
        url:
          type:
          - string
          - 'null'
          readOnly: true
          description: 'The full url of the report obtained from the links field. '
        popularity:
          allOf:
          - $ref: '#/components/schemas/DashboardPopularity'
          readOnly: true
        query_errors:
          type: array
          items:
            $ref: '#/components/schemas/QueryError'
        tagged_items:
          type: array
          items:
            $ref: '#/components/schemas/TaggedItemsLiteWithSource'
          readOnly: true
        size:
          type:
          - integer
          - 'null'
          maximum: 9223372036854775807
          minimum: -9223372036854775808
          format: int64
          description: Size of dashboard objects in bytes
        full_path:
          type:
          - string
          - 'null'
          description: The cached full path of the dashboard folder
        is_hidden:
          type: boolean
          readOnly: true
        downstream_objects_counts:
          allOf:
          - $ref: '#/components/schemas/RelatedObjectsCounts'
          readOnly: true
        upstream_objects_counts:
          allOf:
          - $ref: '#/components/schemas/RelatedObjectsCounts'
          readOnly: true
        source_tables_count:
          type: integer
          default: 0
        last_query_error:
          $ref: '#/components/schemas/QueryError'
        breadcrumbs:
          type: array
          items:
            $ref: '#/components/schemas/Breadcrumb'
          readOnly: true
        data_types:
          allOf:
          - $ref: '#/components/schemas/BaseType'
          readOnly: true
        raw_sql:
          type:
          - string
          - 'null'
        last_viewed_at:
          type: string
          format: date
        collections:
          type: array
          items:
            $ref: '#/components/schemas/CollectionLite'
          readOnly: true
      required:
      - bifolder
      - breadcrumbs
      - collections
      - data_type
      - data_types
      - downstream_objects_counts
      - is_hidden
      - popularity
      - search_name
      - tagged_items
      - upstream_objects_counts
      - url
      - user_description_author
    TagSetListToItems:
      type: object
      description: 'This serializer represents a list of tag guids to be applied

        to a given item'
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ListSerializer.GuidReferenceField.'
        tags:
          type: array
          items:
            $ref: '#/components/schemas/ListSerializer.GuidReferenceField.'
      required:
      - items
      - tags
    DashboardSerializer.GuidReferenceField.technical_owner:
      anyOf:
      - $ref: '#/components/schemas/DSUserName'
      - $ref: '#/components/schemas/Team'
      - $ref: '#/components/schemas/UserLite'
      discriminator:
        propertyName: object_type
        mapping:
          dsuser: '#/components/schemas/DSUserName'
          team: '#/components/schemas/Team'
          user: '#/components/schemas/UserLite'
    SuggestedDescriptionSourceObject:
      type: object
      properties:
        object_type:
          type: string
          readOnly: true
        guid:
          type: string
          readOnly: true
        name:
          type:
          - string
          - 'null'
          readOnly: true
        breadcrumbs:
          type: array
          items:
            $ref: '#/components/schemas/Breadcrumb'
          readOnly: true
        data_types:
          allOf:
          - $ref: '#/components/schemas/BaseType'
          readOnly: true
        parent_guid:
          type: string
      required:
      - breadcrumbs
      - data_types
      - guid
      - name
      - object_type
    TaggedItemsObject:
      type: object
      description: 'Adds support for reading a description from metadata

        that support modifying description'
      properties:
        suggested_description:
          type:
          - string
          - 'null'
          description: 'Suggested description coming from lineage, similar table, or public docs.


            When `force_showing_suggested_description` query parameter value is `false`,

            suggested description is returned only if there is no user or ingested description.'
          readOnly: true
        suggested_description_source:
          type:
          - string
          - 'null'
          readOnly: true
        suggested_description_source_object:
          allOf:
          - $ref: '#/components/schemas/SuggestedDescriptionSourceObject'
          readOnly: true
        data_types:
          allOf:
          - $ref: '#/components/schemas/BaseType'
          readOnly: true
        object_type:
          type: string
          readOnly: true
        guid:
          type: string
          readOnly: true
        name:
          type:
          - string
          - 'null'
          readOnly: true
        short_name:
          type: string
          readOnly: true
        description:
          type: string
          default: ''
        description_source:
          allOf:
          - $ref: '#/components/schemas/DescriptionSourceEnum'
          description: 'The source of the active description.


            * `user` - User

            * `ingestion` - Ingestion

            * `ai` - Ai

            * `public_docs` - Public Docs

            * `lineage` - Lineage

            * `downstream_lineage` - Downstream Lineage

            * `upstream_lineage` - Upstream Lineage

            * `similarity` - Similarity

            * `unknown` - Unknown'
        user_description:
          type: string
          readOnly: true
        user_description_author:
          allOf:
          - $ref: '#/components/schemas/UserLite'
          readOnly: true
        ingested_description:
          type: string
          readOnly: true
        ai_description:
          type: string
          readOnly: true
        search_name:
          type: string
          readOnly: true
          default: ''
        data_type:
          type: string
          readOnly: true
          default: ''
        external_type:
          type: string
          readOnly: true
          default: ''
        data_source:
          allOf:
          - $ref: '#/components/schemas/BaseDataSource'
          readOnly: true
        data_source_type:
          type:
          - string
          - 'null'
          readOnly: true
          default: ''
        url:
          type: string
          format: uri
          readOnly: true
        parent_guid:
          type: string
          readOnly: true
        last_updated_on:
          type: string
          format: date-time
          readOnly: true
        is_hidden:
          type: boolean
          readOnly: true
        breadcrumbs:
          type: array
          items:
            $ref: '#/components/schemas/Breadcrumb'
          readOnly: true
        richtext_description:
          type: string
          default: ''
          description: Rich text version of `description` using SlateJS or Markdown format.
        popularity:
          type:
      

# --- truncated at 32 KB (74 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/select-star/refs/heads/main/openapi/select-star-tags-api-openapi.yml