Select Star collections API

openapi: 3.0.3
info:
  title: Select Star Metadata bi collections 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
tags:
- name: collections
paths:
  /v1/collections/:
    get:
      operationId: collections_list
      parameters:
      - 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:
          - asset_count
          - business_owner
          - created_on
          - description
          - is_favorite
          - last_updated
          - name
          - technical_owner
          - updated_on
      - 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: parent
        required: false
        in: query
        description: Collection parent GUID to filter by. Use `parent=null` to retrieve top-level collections.
        schema:
          type: string
      - name: search_all
        required: false
        in: query
        description: Search a collections with multiple types of params in one go
        schema:
          type: string
      - name: search_business_owner
        required: false
        in: query
        description: Search for an asset using business owner name
        schema:
          type: string
      - name: search_description
        required: false
        in: query
        description: Search for an asset using its description
        schema:
          type: string
      - name: search_name
        required: false
        in: query
        description: Search for an asset using its name
        schema:
          type: string
      - name: search_tag_name
        required: false
        in: query
        description: Search for an asset using a tag name
        schema:
          type: string
      - name: search_technical_owner
        required: false
        in: query
        description: Search for an asset using technical owner name
        schema:
          type: string
      tags:
      - collections
      security:
      - JWTAuthentication: []
      - tokenAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedCollectionList'
          description: ''
      description: '**Required Role:** Viewer or higher'
      x-role-requirements: Viewer or higher
    post:
      operationId: collections_create
      tags:
      - collections
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateUpdateCollectionRequest'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/CreateUpdateCollectionRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/CreateUpdateCollectionRequest'
        required: true
      security:
      - JWTAuthentication: []
      - tokenAuth: []
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Collection'
          description: ''
      description: '**Required Role:** Admin'
      x-role-requirements: Admin
    delete:
      operationId: collections_bulk_delete
      parameters:
      - 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:
          - asset_count
          - business_owner
          - created_on
          - description
          - is_favorite
          - last_updated
          - name
          - technical_owner
          - updated_on
      - name: parent
        required: false
        in: query
        description: Collection parent GUID to filter by. Use `parent=null` to retrieve top-level collections.
        schema:
          type: string
      - name: search_all
        required: false
        in: query
        description: Search a collections with multiple types of params in one go
        schema:
          type: string
      - name: search_business_owner
        required: false
        in: query
        description: Search for an asset using business owner name
        schema:
          type: string
      - name: search_description
        required: false
        in: query
        description: Search for an asset using its description
        schema:
          type: string
      - name: search_name
        required: false
        in: query
        description: Search for an asset using its name
        schema:
          type: string
      - name: search_tag_name
        required: false
        in: query
        description: Search for an asset using a tag name
        schema:
          type: string
      - name: search_technical_owner
        required: false
        in: query
        description: Search for an asset using technical owner name
        schema:
          type: string
      tags:
      - collections
      security:
      - JWTAuthentication: []
      - tokenAuth: []
      responses:
        '204':
          description: No response body
      description: '**Required Role:** Admin'
      x-role-requirements: Admin
  /v1/collections/{collection__guid}/items/:
    get:
      operationId: collections_items_list
      parameters:
      - in: path
        name: collection__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: data_source_type
        required: false
        in: query
        description: A comma separated list of data source types to filter for assets within those data source types.
        schema:
          type: string
      - name: datasources
        required: false
        in: query
        description: A comma separated list of data source guids to filter for assets within those data sources.
        schema:
          type: string
          pattern: ^(ds)_(?P<guid>[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22})$
      - name: object_type
        required: false
        in: query
        description: A comma separated list of object types to filter for assets of those types.
        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
          - object_type
          - popularity
          - source
      - 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_all
        required: false
        in: query
        description: Search a collection item with multiple types of params in one go
        schema:
          type: string
      - name: sources
        required: false
        in: query
        description: A comma separated list of sources to filter items. Valid values include data source type display labels (e.g. 'Postgres', 'PostgreSQL', 'snowflake'), 'External' for links, and 'Select Star' for internal items.
        schema:
          type: string
      tags:
      - collections
      security:
      - JWTAuthentication: []
      - tokenAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedCollectionItemList'
          description: ''
      description: '**Required Role:** Viewer or higher'
      x-role-requirements: Viewer or higher
  /v1/collections/{guid}/:
    get:
      operationId: collections_retrieve
      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:
      - collections
      security:
      - JWTAuthentication: []
      - tokenAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Collection'
          description: ''
      description: '**Required Role:** Viewer or higher'
      x-role-requirements: Viewer or higher
    patch:
      operationId: collections_partial_update
      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:
      - collections
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchedCreateUpdateCollectionRequest'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/PatchedCreateUpdateCollectionRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/PatchedCreateUpdateCollectionRequest'
      security:
      - JWTAuthentication: []
      - tokenAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Collection'
          description: ''
      description: '**Required Role:** Admin'
      x-role-requirements: Admin
    delete:
      operationId: collections_destroy
      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: 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:
          - asset_count
          - business_owner
          - created_on
          - description
          - is_favorite
          - last_updated
          - name
          - technical_owner
          - updated_on
      - name: parent
        required: false
        in: query
        description: Collection parent GUID to filter by. Use `parent=null` to retrieve top-level collections.
        schema:
          type: string
      - name: search_all
        required: false
        in: query
        description: Search a collections with multiple types of params in one go
        schema:
          type: string
      - name: search_business_owner
        required: false
        in: query
        description: Search for an asset using business owner name
        schema:
          type: string
      - name: search_description
        required: false
        in: query
        description: Search for an asset using its description
        schema:
          type: string
      - name: search_name
        required: false
        in: query
        description: Search for an asset using its name
        schema:
          type: string
      - name: search_tag_name
        required: false
        in: query
        description: Search for an asset using a tag name
        schema:
          type: string
      - name: search_technical_owner
        required: false
        in: query
        description: Search for an asset using technical owner name
        schema:
          type: string
      tags:
      - collections
      security:
      - JWTAuthentication: []
      - tokenAuth: []
      responses:
        '204':
          description: No response body
      description: '**Required Role:** Admin'
      x-role-requirements: Admin
  /v1/collections/items/:
    patch:
      operationId: collections_items_bulk_update
      tags:
      - collections
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchedCollectionItemBulkUpdateRequest'
            examples:
              AddItemsToCollections:
                value:
                  collection_set:
                  - items:
                    - table-guid-1
                    collections:
                    - collection-guid-1
                    - collection-guid-2
                  replace_existing: true
                summary: Add items to collections
                description: Add items to multiple collections, optionally replacing existing collection assignments
              RemoveItemsFromCollections:
                value:
                  collection_set:
                  - items:
                    - table-guid-1
                    collections:
                    - collection-guid-1
                  remove_only: true
                summary: Remove items from collections
                description: Remove items from specific collections while preserving other collection assignments
              AddItemsToCollectionsWithoutReplacing:
                value:
                  collection_set:
                  - items:
                    - table-guid-1
                    collections:
                    - collection-guid-1
                    - collection-guid-2
                  replace_existing: false
                summary: Add items to collections without replacing
                description: Add items to collections while preserving existing collection assignments
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/PatchedCollectionItemBulkUpdateRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/PatchedCollectionItemBulkUpdateRequest'
      security:
      - JWTAuthentication: []
      - tokenAuth: []
      responses:
        '200':
          description: No response body
      description: '**Required Role:** Data Manager or higher'
      x-role-requirements: Data Manager or higher
  /v1/collections/owners/:
    patch:
      operationId: collections_owners_partial_update
      tags:
      - collections
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchedCollectionOwnersBulkEditRequest'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/PatchedCollectionOwnersBulkEditRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/PatchedCollectionOwnersBulkEditRequest'
      security:
      - JWTAuthentication: []
      - tokenAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CollectionOwnersBulkEdit'
          description: ''
      description: '**Required Role:** Admin'
      x-role-requirements: Admin
components:
  schemas:
    DashboardSerializer.GuidReferenceField.business_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'
    TypeB32Enum:
      enum:
      - status
      - dbt
      type: string
      description: '* `status` - status

        * `dbt` - dbt'
    PatchedCreateUpdateCollectionRequest:
      type: object
      properties:
        name:
          type: string
          minLength: 1
          maxLength: 255
        icon:
          type: string
          minLength: 1
          default: collection
          maxLength: 255
        color_scheme:
          type: string
          nullable: true
          minLength: 1
          maxLength: 50
        emoji:
          type: string
          nullable: true
          minLength: 1
          maxLength: 50
        description:
          type: string
          nullable: true
          description: Active description
        richtext_description:
          type: string
          nullable: true
          description: Richtext formatted description. Can be in Slatejs or Draftjs format.
        business_owner:
          allOf:
          - $ref: '#/components/schemas/CreateUpdateCollectionSerializer.GuidReferenceField.business_ownerRequest'
          nullable: true
          description: GUID of the business owner. If not provided, the creator of the collection will be set as the business owner.
        technical_owner:
          allOf:
          - $ref: '#/components/schemas/CreateUpdateCollectionSerializer.GuidReferenceField.technical_ownerRequest'
          nullable: true
          description: GUID of the technical owner.
        parent:
          type: string
          minLength: 1
          nullable: true
          description: GUID of the parent collection.
    BaseDataSource:
      type: object
      properties:
        guid:
          type: string
          maxLength: 25
        type:
          $ref: '#/components/schemas/Type6b6Enum'
        name:
          type: string
          maxLength: 100
      required:
      - name
      - type
    CollectionOwnersBulkEditSerializer.GuidReferenceField.business_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'
    CollectionSerializer.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'
    BaseMetadata:
      type: object
      properties:
        object_type:
          type: string
          readOnly: true
        guid:
          type: string
          readOnly: true
        name:
          type: string
          nullable: true
          readOnly: true
        breadcrumbs:
          type: array
          items:
            $ref: '#/components/schemas/Breadcrumb'
          readOnly: true
      required:
      - breadcrumbs
      - guid
      - name
      - object_type
    ListSerializer.GuidReferenceField.:
      $ref: '#/components/schemas/Dashboard'
    TaggedItemsLite:
      type: object
      description: Serializer without suggestion source
      properties:
        item:
          $ref: '#/components/schemas/TaggedItemsLiteSerializer.GuidReferenceField.item'
        guid:
          type: string
          readOnly: true
        tag:
          $ref: '#/components/schemas/TagLite'
        kind:
          type: string
        suggested_source_kind:
          type: string
      required:
      - guid
      - item
      - kind
      - suggested_source_kind
      - tag
    Breadcrumb:
      type: object
      properties:
        guid:
          type: string
          maxLength: 25
        target_guid:
          type: string
          maxLength: 256
        target_name:
          type: string
          readOnly: true
        target_object_type:
          type: string
        target_data_type:
          type: string
        target_data_source_guid:
          type: string
          nullable: true
          readOnly: true
        target_data_source_type:
          allOf:
          - $ref: '#/components/schemas/TargetDataSourceTypeEnum'
          nullable: true
        ordinal:
          type: integer
          maximum: 2147483647
          minimum: 0
          description: Ordering of breadcrumb within the table
      required:
      - target_data_source_guid
      - target_data_type
      - target_guid
      - target_name
      - target_object_type
    PatchedCollectionItemBulkUpdateRequest:
      type: object
      properties:
        collection_set:
          type: array
          items:
            $ref: '#/components/schemas/CollectionSetRequest'
          writeOnly: true
          description: A list of collections and items to be added to or removed from.
        replace_existing:
          type: boolean
          writeOnly: true
          default: false
          description: Replace all items in a collection with the given request. Only items the user has access to will be added and removed.
        remove_only:
          type: boolean
          writeOnly: true
          default: false
          description: Only remove items from the specified collections. No additions will be made.
        ignore_conflicts:
          type: boolean
          writeOnly: true
          default: false
          description: Silently ignore conflicts when adding items that already exist in collections. If False, will raise validation errors for duplicates.
    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'
    PatchedCollectionOwnersBulkEditRequest:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ListSerializer.GuidReferenceField.Request'
        business_owner:
          allOf:
          - $ref: '#/components/schemas/CollectionOwnersBulkEditSerializer.GuidReferenceField.business_ownerRequest'
          nullable: true
        technical_owner:
          allOf:
          - $ref: '#/components/schemas/CollectionOwnersBulkEditSerializer.GuidReferenceField.technical_ownerRequest'
          nullable: true
    UserSetting:
      type: object
      properties:
        enable_email_notifications:
          type: boolean
          description: Whether this user wants an email notification or not
        enable_slack_notifications:
          type: boolean
          description: Whether this user wants a slack notification or not
        enable_notifications_for_schema_changes:
          type: boolean
          description: Whether this user wants a slack notification for schema changes or not
        enable_notifications_for_metadata_changes:
          type: boolean
          description: Whether this user wants a slack notification for metadata changes or not
        enable_discussions_notifications:
          type: boolean
          description: Whether this user wants a notification for new discussions or not
        enable_favorites_notifications_for_schema_changes:
          type: boolean
          description: Whether this user wants a schema change notification for favorited items or not
        enable_favorites_notifications_for_metadata_changes:
          type: boolean
          description: Whether this user wants a metadata change notification for favorited items or not
        enable_favorites_notifications_for_discussions:
          type: boolean
          description: Whether this user wants a discussion notification for favorited items or not
        default_database_table_column_order:
          allOf:
          - $ref: '#/components/schemas/DefaultDatabaseTableColumnOrderEnum'
          description: 'Database table column order. There are several different ways to order columns


            * `popularity` - popularity

            * `column_ordinal_position` - column_ordinal_position

            * `alphabetical` - alphabetical'
        default_table_dashboard_tab:
          allOf:
          - $ref: '#/components/schemas/DefaultTableDashboardTabEnum'
          description: 'Default tab for table / dashboard page


            * `overview` - overview

            * `columns_charts` - columns_charts'
    CollectionOwnersBulkEditSerializer.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'
    ListSerializer.GuidReferenceField.Request:
      type: string
      description: GUID
    TargetDataSourceTypeEnum:
      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'
    TaggedItemsLiteWithSourceSerializer.GuidReferenceField.suggestion_source_object:
      anyOf:
      - $ref: '#/components/schemas/PiiRule'
      - $ref: '#/components/schemas/TaggedItemsLite'
      discriminator:
        propertyName: object_type
        mapping:
          piirule: '#/components/schemas/PiiRule'
          taggeditems: '#/components/schemas/TaggedItemsLite'
    CollectionSetRequest:
      type: object
      description: 'This serializer represents a list of tag guids to be applied

        to a given item'
      properties:
        collections:
          type: array
          items:
            $ref: '#/components/schemas/ListSerializer.GuidReferenceField.Request'
        items:
          type: array
          items:
            $ref: '#/components/schemas/ListSerializer.GuidReferenceField.Request'
      required:
      - collections
      - items
    CreateUpdateCollectionSerializer.GuidReferenceField.business_ownerRequest:
      type: string
      description: GUID
    DefaultTableDashboardTabEnum:
      enum:
      - overview
      - columns_charts
      type: string
      description: '* `overview` - overview

        * `columns_charts` - columns_charts'
    UserLite:
      type: object
      properties:
        guid:
          type: string
          readOnly: true
        first_name:
          type: string
          readOnly: true
        last_name:
          type: string
          readOnly: true
        team:
          allOf:
          - $ref: '#/components/schemas/TeamShortcut'
          readOnly: true
        email:
          type: string
          format: email
          readOnly: true
          title: Email address
        avatar:
          type: string
          format: uri
          readOnly: true
          nullable: true
        is_active:
          type: boolean
          readOnly: true
      required:
      - avatar
      - email
      - first_name
      - guid
      - is_active
      - last_name
      - team
    CollectionLite:
      type: object
      properties:
        guid:
          type: string
          readOnly: true
        name:
          type: string
          readOnly: true
        icon:
          type: string
          readOnly: true
        data_types:
          allOf:
          - $ref: '#/components/schemas/BaseType'
          readOnly: true
        breadcrumbs:
          type: array
          items:
            $ref: '#/components/schemas/Breadcrumb'
          readOnly: true
        emoji:
          type: string
          readOnly: true
          nullable: true
          description: Unicode representation of the selected emoji
        color_scheme:
          type: string
          readOnly: true
          nullable: true
          description: Color scheme selected by the user for the icon
        linked_from:
          type: array
          items:
            type: string
          readOnly: true
          description: Tags having a link to this collection
      required:
      - breadcrumbs
      - color_scheme
      - data_types
      - emoji
      - guid
      - icon
      - linked_from
      - name
    CollectionItem:
      type: object
      description: A list of items that are part of one particular collection
      properties:
        guid:
          type: string
          readOnly: true
          description: The CollectionItem object guid.
        item:
          $ref: '#/components/schemas/CollectionItemSerializer.GuidReferenceField.item'
      required:
      - guid
      - item
    CollectionOwnersBulkEditSerializer.GuidReferenceField.technical_ownerRequest:
      type: string
      description: GUID
    DSUserName:
      type: object
      properties:
        guid:
          type: string
          maxLength: 25
        display_name:
          type: string
          nullable: true
          description: The username field for the user used by the datasource
          maxLength: 100
        name:
          type: string
          maxLength: 100
        data_source:
          $ref: '#/components/schemas/DataSourceInfo'
      required:
      - data_source
      - name
    TaggedItemsLiteSerializer.GuidReferenceField.item:
      $ref: '#/components/schemas/BaseMetadata'
    QueryError:
      type: object
      properties:
        event_on:
          type: string
          format: date-time
          description: When an event in 'History' was created. Each event is linked to a query in Looker.
        message:
          type: string
          description: General information about the query, often around error reporting or the current status
        source:
          type: string
          description: The source of a query, such as a saved Look, Explore, scheduled task, API, etc
        issuer_source:
          type: string
          description: The source of a query, bucketed. Buckets are the API, users themselves, or automated system activities (PDTs & schedules)
  

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