Select Star joins API

openapi: 3.2.0
info:
  title: Select Star Metadata bi Joins 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: joins
paths:
  /v1/joins/:
    get:
      operationId: joins_list
      description: 'List of the joins available in authenticated user''s organization


        **Required Role:** Authenticated User with Active Organization'
      parameters:
      - name: columns
        required: false
        in: query
        description: A comma separated list of column guids to filter for joins that this table was a source or target column of the join.
        schema:
          type: string
          pattern: ^(co)_(?P<guid>[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22})$
      - name: datasources
        required: false
        in: query
        description: A comma separated list of data source guids to filter for items within those data sources.
        schema:
          type: string
          pattern: ^(ds)_(?P<guid>[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22})$
      - 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:
          - created_on
          - popularity
          - popularity_value
      - 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: popularity
        required: false
        in: query
        description: A comma separated list of popularity ranges (inclusive) can include integers from 1-100 ex) 1-10,90-100 would be the bottom 10 percent and the top 10 percent, respectively. Ranges can overlap.
        schema:
          type: string
      - name: source_tables
        required: false
        in: query
        description: A comma separated list of table guids to filter for joins that this table was a source table of the join.
        schema:
          type: string
          pattern: ^(ta)_(?P<guid>[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22})$
      - name: tables
        required: false
        in: query
        description: A comma separated list of table guids to filter for joins that this table was a source or target table of the join.
        schema:
          type: string
          pattern: ^(ta)_(?P<guid>[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22})$
      tags:
      - joins
      security:
      - JWTAuthentication: []
      - tokenAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedJoinList'
          description: ''
      x-role-requirements: Authenticated User with Active Organization
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'
    Table:
      type: object
      description: 'Adds support for reading a description from metadata

        that support modifying description'
      properties:
        guid:
          type: string
          readOnly: true
        database:
          $ref: '#/components/schemas/Database'
        schema:
          allOf:
          - $ref: '#/components/schemas/Schema'
        name:
          type: string
        search_name:
          type: string
          description: 'Full path for Table is ''DATABASE.SCHEMA.TABLE'' or ''DATABASE.TABLE'' if

            there''s no schema.'
          readOnly: true
        description_source:
          allOf:
          - $ref: '#/components/schemas/DescriptionSourceEnum'
          readOnly: true
        description:
          type:
          - string
          - 'null'
          description: Active description
        richtext_description:
          type:
          - string
          - 'null'
          description: Richtext formatted description. Can be in Slatejs or Draftjs format.
        user_description:
          type:
          - string
          - 'null'
          readOnly: true
          description: User description
        user_description_author:
          allOf:
          - $ref: '#/components/schemas/UserLite'
          readOnly: true
        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
        ingested_description:
          type:
          - string
          - 'null'
          readOnly: true
          description: Unmodified description from the data source
        ai_description:
          type:
          - string
          - 'null'
          readOnly: true
          description: AI-generated description
        created_by:
          $ref: '#/components/schemas/User'
        dsuser_created_by:
          $ref: '#/components/schemas/DSUserName'
        business_owner:
          allOf:
          - $ref: '#/components/schemas/TableSerializer.GuidReferenceField.business_owner'
          readOnly: true
        technical_owner:
          allOf:
          - $ref: '#/components/schemas/TableSerializer.GuidReferenceField.technical_owner'
          readOnly: true
        updates_on:
          type:
          - string
          - 'null'
          format: date-time
        last_updated_on:
          type:
          - string
          - 'null'
          format: date-time
          description: this field is updated during metadata_ingestion based on field updated_on for a given table in external DS information schema
        last_queried_on:
          type:
          - string
          - 'null'
          format: date-time
        last_refreshed_on:
          type:
          - string
          - 'null'
          format: date-time
          description: When this table was modified in the datasource (without SELECT queries)
        db_created_on:
          type:
          - string
          - 'null'
          format: date-time
          description: When this table was created in the datasource
        columns:
          type: array
          items:
            $ref: '#/components/schemas/TableColumn'
          readOnly: true
        popularity:
          allOf:
          - $ref: '#/components/schemas/TablePopularity'
          readOnly: true
        tagged_items:
          type: array
          items:
            $ref: '#/components/schemas/TaggedItemsLiteWithSource'
          readOnly: true
        updated_on:
          type: string
          format: date-time
          readOnly: true
        created_on:
          type: string
          format: date-time
          readOnly: true
        table_type:
          allOf:
          - $ref: '#/components/schemas/TableTypeEnum'
          description: 'Table type as defined in the datasource


            * `table` - table

            * `view` - view

            * `materialized_view` - materialized_view

            * `external_table` - external_table

            * `dynamic_table` - dynamic_table

            * `incremental` - dbt_incremental

            * `ephemeral` - dbt_ephemeral

            * `source` - dbt_source

            * `seed` - dbt_seed

            * `model` - dbt_model_legacy'
        data_type:
          type: string
          readOnly: true
        data_types:
          allOf:
          - $ref: '#/components/schemas/BaseType'
          readOnly: true
        bytes:
          type:
          - integer
          - 'null'
          maximum: 9223372036854775807
          minimum: -9223372036854775808
          format: int64
          description: Number of bytes accessed by a scan of the table
        row_count:
          type:
          - integer
          - 'null'
          maximum: 9223372036854775807
          minimum: -9223372036854775808
          format: int64
          description: Number of rows in the table
        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
        extra:
          readOnly: true
          description: Extra unstructured metadata for the table
        breadcrumbs:
          type: array
          items:
            $ref: '#/components/schemas/Breadcrumb'
          readOnly: true
        suggested_description_source:
          allOf:
          - $ref: '#/components/schemas/SuggestedDescriptionSourceEnum'
          readOnly: true
        suggested_description_source_object:
          allOf:
          - $ref: '#/components/schemas/TableSerializer.GuidReferenceField.suggested_description_source_object'
          readOnly: true
        cloud_object:
          $ref: '#/components/schemas/CloudObjectLite'
        is_implicit:
          type:
          - boolean
          - 'null'
          description: Whether this table was implicitly found in query metadata, instead of ingested from database metadata.
        collections:
          type: array
          items:
            $ref: '#/components/schemas/CollectionLite'
          readOnly: true
        deactivation_scheduled_on:
          type:
          - string
          - 'null'
          format: date-time
          description: A time when objects is fully deactivated, so deactivate grace period pass too
          readOnly: true
      required:
      - ai_description
      - breadcrumbs
      - business_owner
      - collections
      - columns
      - created_on
      - data_type
      - data_types
      - database
      - deactivation_scheduled_on
      - description_source
      - downstream_objects_counts
      - extra
      - guid
      - ingested_description
      - is_hidden
      - name
      - popularity
      - search_name
      - suggested_description
      - suggested_description_source
      - suggested_description_source_object
      - tagged_items
      - technical_owner
      - updated_on
      - upstream_objects_counts
      - user_description
      - user_description_author
    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'
    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
    JoinPopularity:
      type: object
      properties:
        timeframe:
          type: integer
          readOnly: true
          default: 90
        user_count:
          type: integer
          readOnly: true
        service_query_count:
          type: integer
          readOnly: true
        popularity:
          type: integer
          readOnly: true
          description: Popularity score for this object from 0-100
        query_count:
          type: integer
      required:
      - popularity
      - query_count
      - service_query_count
      - timeframe
      - user_count
    TableLite:
      type: object
      properties:
        guid:
          type: string
          maxLength: 25
        name:
          type: string
        table_type:
          allOf:
          - $ref: '#/components/schemas/TableTypeEnum'
          description: 'Table type as defined in the datasource


            * `table` - table

            * `view` - view

            * `materialized_view` - materialized_view

            * `external_table` - external_table

            * `dynamic_table` - dynamic_table

            * `incremental` - dbt_incremental

            * `ephemeral` - dbt_ephemeral

            * `source` - dbt_source

            * `seed` - dbt_seed

            * `model` - dbt_model_legacy'
        data_types:
          allOf:
          - $ref: '#/components/schemas/BaseType'
          readOnly: true
        updated_on:
          type: string
          format: date-time
          readOnly: true
      required:
      - data_types
      - name
      - updated_on
    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'
    DatabasePopularity:
      type: object
      properties:
        timeframe:
          type: integer
          readOnly: true
          default: 90
        user_count:
          type: integer
          readOnly: true
        service_query_count:
          type: integer
          readOnly: true
        popularity:
          type: integer
          readOnly: true
          description: Popularity score for this object from 0-100
        query_count:
          type: integer
      required:
      - popularity
      - query_count
      - service_query_count
      - timeframe
      - user_count
    ColumnPopularity:
      type: object
      properties:
        timeframe:
          type: integer
          readOnly: true
          default: 90
        user_count:
          type: integer
          readOnly: true
        service_query_count:
          type: integer
          readOnly: true
        popularity:
          type: integer
          readOnly: true
          description: Popularity score for this object from 0-100
        query_count:
          type: integer
      required:
      - popularity
      - query_count
      - service_query_count
      - timeframe
      - user_count
    TableSerializer.GuidReferenceField.suggested_description_source_object:
      $ref: '#/components/schemas/SuggestedDescriptionSourceObject'
    PaginatedJoinList:
      type: object
      required:
      - count
      - results
      properties:
        count:
          type: integer
          example: 123
        next:
          type:
          - string
          - 'null'
          format: uri
          example: http://api.example.org/accounts/?page=4
        previous:
          type:
          - string
          - 'null'
          format: uri
          example: http://api.example.org/accounts/?page=2
        results:
          type: array
          items:
            $ref: '#/components/schemas/Join'
    PiiRule:
      type: object
      properties:
        guid:
          type: string
          maxLength: 25
        name:
          type: string
          description: PII Rule name display name
          maxLength: 50
        type:
          allOf:
          - $ref: '#/components/schemas/PIIType'
          description: 'The type of PII this represents


            * `address` - address

            * `banking` - banking

            * `birthdate` - birthdate

            * `document` - document

            * `email` - email

            * `face_photo` - face_photo

            * `gender` - gender

            * `marital_status` - marital_status

            * `nationality` - nationality

            * `online_account` - online_account

            * `online_address` - online_address

            * `password` - password

            * `person` - person

            * `phone` - phone

            * `salary` - salary

            * `ssn` - ssn

            * `username` - username'
        regex:
          type: string
          description: The PII Rule
        created_by:
          allOf:
          - $ref: '#/components/schemas/UserLite'
          readOnly: true
        active:
          type: boolean
        item_count:
          type: integer
          readOnly: true
      required:
      - created_by
      - item_count
      - name
      - regex
      - type
    CloudObjectTypeEnum:
      enum:
      - s3
      - unsupported
      type: string
      description: '* `s3` - s3

        * `unsupported` - unsupported'
    FormatEnum:
      enum:
      - csv
      - json
      - unknown
      type: string
      description: '* `csv` - csv

        * `json` - json

        * `unknown` - unknown'
    SchemaPopularity:
      type: object
      properties:
        timeframe:
          type: integer
          readOnly: true
          default: 90
        user_count:
          type: integer
          readOnly: true
        service_query_count:
          type: integer
          readOnly: true
        popularity:
          type: integer
          readOnly: true
          description: Popularity score for this object from 0-100
        query_count:
          type: integer
      required:
      - popularity
      - query_count
      - service_query_count
      - timeframe
      - user_count
    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'
    TableTypeEnum:
      enum:
      - table
      - view
      - materialized_view
      - external_table
      - dynamic_table
      - incremental
      - ephemeral
      - source
      - seed
      - model
      type: string
      description: '* `table` - table

        * `view` - view

        * `materialized_view` - materialized_view

        * `external_table` - external_table

        * `dynamic_table` - dynamic_table

        * `incremental` - dbt_incremental

        * `ephemeral` - dbt_ephemeral

        * `source` - dbt_source

        * `seed` - dbt_seed

        * `model` - dbt_model_legacy'
    TableInfo:
      type: object
      properties:
        guid:
          type: string
          maxLength: 25
        name:
          type: string
        table_type:
          allOf:
          - $ref: '#/components/schemas/TableTypeEnum'
          description: 'Table type as defined in the datasource


            * `table` - table

            * `view` - view

            * `materialized_view` - materialized_view

            * `external_table` - external_table

            * `dynamic_table` - dynamic_table

            * `incremental` - dbt_incremental

            * `ephemeral` - dbt_ephemeral

            * `source` - dbt_source

            * `seed` - dbt_seed

            * `model` - dbt_model_legacy'
        data_types:
          allOf:
          - $ref: '#/components/schemas/BaseType'
          readOnly: true
        updated_on:
          type: string
          format: date-time
          readOnly: true
        schema:
          allOf:
          - $ref: '#/components/schemas/Schema'
        database:
          $ref: '#/components/schemas/Database'
      required:
      - data_types
      - database
      - name
      - updated_on
    Condition:
      type: object
      properties:
        raw:
          type: string
        left_column:
          $ref: '#/components/schemas/Column'
        right_column:
          $ref: '#/components/schemas/Column'
      required:
      - left_column
      - raw
      - right_column
    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'
    TagLite:
      type: object
      properties:
        guid:
          type: string
          maxLength: 25
        type:
          $ref: '#/components/schemas/TypeB32Enum'
        name:
          type: string
          readOnly: true
          description: Tag display name
        icon:
          type: string
          readOnly: true
          description: Icon identifier (for status tags)
        color:
          type: string
          readOnly: true
          description: 'Tag color (for category tags). Allowed formats: ''#ffeedd'' and ''#ffeeddcc'' (RGB/ARGB hexadecimal)'
          deprecated: true
        visible:
          type: boolean
          readOnly: true
        links_to:
          type:
          - string
          - 'null'
        breadcrumbs:
          type: array
          items:
            $ref: '#/components/schemas/Breadcrumb'
          readOnly: true
      required:
      - breadcrumbs
      - color
      - icon
      - name
      - type
      - visible
    TableSerializer.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'
    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
    SuggestedDescriptionSourceEnum:
      enum:
      - public_docs
      - lineage
      - downstream_lineage
      - upstream_lineage
      - similarity
      - unknown
      type: string
      description: '* `public_docs` - Public Docs

        * `lineage` - Lineage

        * `downstream_lineage` - Downstream Lineage

        * `upstream_lineage` - Upstream Lineage

        * `similarity` - Similarity

        * `unknown` - Unknown'
    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
          - 'null'
          readOnly: true
          description: Unicode representation of the selected emoji
        color_scheme:
          type:
          - string
          - 'null'
          readOnly: 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
    User:
      type: object
      properties:
        guid:
          type: string
          readOnly: true
        first_name:
          type: string
        last_name:
          type: string
        email:
          type: string
          format: email
          pattern: ''
          description: Email address of the user. Only corporate email addresses are allowed.
        avatar:
          type:
          - string
          - 'null'
          format: uri
          readOnly: true
        team:
          allOf:
          - $ref: '#/components/schemas/TeamShortcut'
          readOnly: true
        last_login:
          type:
          - string
          - 'null'
          format: date-time
          readOnly: true
        last_activity:
          type:
          - string
          - 'null'
          format: date-time
          readOnly: true
        is_invitation_pending:
          readOnly: true
        is_active:
          type: boolean
          readOnly: true
        is_verified:
          type: boolean
          readOnly: true
          description: Whether the user has verified email or not
        is_agreed_to_terms:
          type: boolean
        settings:
          $ref: '#/components/schemas/UserSetting'
        created_on:
          type: string
          format: date-time
          readOnly: true
      required:
      - avatar
      - created_on
      - email
      - first_name
      - guid
      - is_active
      - is_agreed_to_terms
      - is_invitation_pending
      - is_verified
      - last_activity
      - last_login
      - last_name
      - team
    DatabaseSerializer.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'
    TableColumn:
      type: object
      properties:
        guid:
          type: string
          maxLength: 25
        name:
          type: string
        ordinal:
          type:
          - integer
          - 'null'
          maximum: 2147483647
          minimum: 0
          description: Ordering of columns within the table
        description:
          type:
          - string
          - 'null'
          description: Active description
        field_type:
          type: string
        external_type:
          type: string
        data_type:
          type: string
          description: Map field_type to a Select Star type
          readOnly: true
        data_types:
          allOf:
          - $ref: '#/components/schemas/BaseType'
          readOnly: true
        popularity:
          allOf:
          - $ref: '#/components/schemas/ColumnPopularity'
          readOnly: true
        is_primary_key:
          type: boolean
          description: Whether this column is part of table's primary key
        is_foreign_key:
          type: boolean
          readOnly: true
        is_join_key:
          type: boolean
          description: Whether this c

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