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

# Relation capabilities

> relation capabilities. GET /api/v1/catalogs/{catalog_id}/relations/{name}/capabilities. Uses the same payload, validation, revision checks and response as the unified HTTP API.

ReferenceApplies to: Unified engine deployments

## Related guidance

[Addresses and access](https://docs.e6data.com/transformation/http/access.md) · [Request identity](https://docs.e6data.com/transformation/http/request-identity.md) · [Errors and recovery](https://docs.e6data.com/transformation/http/errors.md) · [Pagination and results](https://docs.e6data.com/transformation/http/results.md)


## OpenAPI

````yaml openapi/transformation.json GET /api/v1/catalogs/{catalog_id}/relations/{name}/capabilities
openapi: 3.1.0
info:
  description: >-
    HTTP contracts for the Unified engine. Requests use the connected
    deployment's access model and configured owner. Response examples are
    illustrative; inspect your engine response in your client. SQL-managed
    secrets, credentials, streaming pipelines and maintenance run through
    session operations.
  title: Laminar Unified HTTP API
  version: v1
servers:
  - url: https://engine.example.com
    description: >-
      Example engine origin. Replace it with your deployment URL and any API
      mount prefix.
security: []
paths:
  /api/v1/catalogs/{catalog_id}/relations/{name}/capabilities:
    get:
      tags:
        - Catalogs and tables
      summary: relation capabilities
      description: >-
        relation capabilities. GET
        /api/v1/catalogs/{catalog_id}/relations/{name}/capabilities. Uses the
        same payload, validation, revision checks and response as the unified
        HTTP API.
      operationId: relation_capabilities
      parameters:
        - in: path
          name: catalog_id
          required: true
          schema:
            format: uuid
            type: string
        - in: path
          name: name
          required: true
          schema:
            type: string
        - in: query
          name: continuation_token
          required: false
          schema:
            type: string
        - in: query
          name: limit
          required: false
          schema:
            description: >-
              Page size, bounded by the server. For query results this counts
              Arrow batches, default 1.
            minimum: 1
            type: integer
        - in: query
          name: namespace
          required: false
          schema:
            items:
              type: string
            type: array
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/data_catalog_core_src_models_introspection_rs_RelationCapabilitiesResponse
          description: Successful response.
        default:
          content:
            application/json:
              example:
                error:
                  code: invalid_request
                  message: Check the request fields
              schema:
                $ref: '#/components/schemas/ApiError'
          description: A rejected or failed request. Inspect error.code before retrying.
components:
  schemas:
    data_catalog_core_src_models_introspection_rs_RelationCapabilitiesResponse:
      properties:
        capabilities:
          $ref: >-
            #/components/schemas/data_catalog_core_src_models_introspection_rs_RelationCapabilities
        kind:
          $ref: >-
            #/components/schemas/data_catalog_core_src_models_mod_rs_RelationKind
        relation:
          $ref: >-
            #/components/schemas/data_catalog_core_src_models_mod_rs_RelationReference
        supported_commit_operations:
          items:
            $ref: '#/components/schemas/shared_common_src_lib_rs_TableCommitOperation'
          type: array
        table_format_version:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
      required:
        - relation
        - kind
        - capabilities
        - supported_commit_operations
        - table_format_version
      type: object
    ApiError:
      properties:
        error:
          properties:
            code:
              type: string
            message:
              type: string
          required:
            - code
            - message
          type: object
      required:
        - error
      type: object
    data_catalog_core_src_models_introspection_rs_RelationCapabilities:
      properties:
        add_partition_fields:
          type: boolean
        alter_comment:
          type: boolean
        alter_location:
          type: boolean
        alter_properties:
          type: boolean
        alter_sort_order:
          type: boolean
        constraints:
          items:
            type: string
          type: array
        drop_metadata:
          type: boolean
        drop_partition_fields:
          type: boolean
        mutation_guards:
          $ref: >-
            #/components/schemas/data_catalog_core_src_models_introspection_rs_MutationGuardCapabilities
        permissions_verified:
          type: boolean
        purge_data:
          type: boolean
        read:
          type: boolean
        rename:
          type: boolean
        rename_partition_fields:
          type: boolean
        replace_view_definition:
          type: boolean
        schema_evolution:
          anyOf:
            - $ref: >-
                #/components/schemas/data_catalog_core_src_models_introspection_rs_SchemaEvolutionCapabilities
            - type: 'null'
        snapshot_history:
          type: boolean
        time_travel:
          type: boolean
        upgrade_format_versions:
          items:
            minimum: 0
            type: integer
          type: array
      required:
        - permissions_verified
        - read
        - rename
        - drop_metadata
        - purge_data
        - alter_properties
        - alter_comment
        - replace_view_definition
        - snapshot_history
        - time_travel
        - alter_location
        - add_partition_fields
        - drop_partition_fields
        - rename_partition_fields
        - alter_sort_order
        - upgrade_format_versions
        - schema_evolution
        - mutation_guards
        - constraints
      type: object
    data_catalog_core_src_models_mod_rs_RelationKind:
      oneOf:
        - const: Table
          type: string
        - const: View
          type: string
    data_catalog_core_src_models_mod_rs_RelationReference:
      properties:
        catalog:
          $ref: >-
            #/components/schemas/data_catalog_core_src_models_mod_rs_CatalogReference
        name:
          type: string
        namespace:
          items:
            type: string
          type: array
      required:
        - catalog
        - namespace
        - name
      type: object
    shared_common_src_lib_rs_TableCommitOperation:
      oneOf:
        - const: Append
          type: string
        - const: Replace
          type: string
        - const: RowChanges
          type: string
        - const: Rewrite
          type: string
    data_catalog_core_src_models_introspection_rs_MutationGuardCapabilities:
      properties:
        catalog_revision:
          type: boolean
        full_metadata_revision_compare_and_swap:
          description: >-
            A metadata-location preflight is not atomic full metadata revision
            CAS.
          type: boolean
        guarded_drop:
          type: boolean
        guarded_rename:
          type: boolean
        guarded_view_alter:
          type: boolean
        table_identity_schema_layout:
          description: Identity, schema and layout checks are native commit requirements.
          type: boolean
      required:
        - catalog_revision
        - table_identity_schema_layout
        - full_metadata_revision_compare_and_swap
        - guarded_rename
        - guarded_drop
        - guarded_view_alter
      type: object
    data_catalog_core_src_models_introspection_rs_SchemaEvolutionCapabilities:
      properties:
        add_nullable_columns:
          type: boolean
        add_required_columns:
          type: boolean
        column_comments:
          type: boolean
        column_defaults:
          type: boolean
        drop_columns:
          type: boolean
        generated_columns:
          type: boolean
        relax_nullability:
          type: boolean
        rename_columns:
          type: boolean
        reorder_columns:
          type: boolean
        supported_type_promotions:
          items:
            type: string
          type: array
        tighten_nullability:
          type: boolean
      required:
        - add_nullable_columns
        - add_required_columns
        - drop_columns
        - rename_columns
        - reorder_columns
        - column_comments
        - relax_nullability
        - tighten_nullability
        - column_defaults
        - generated_columns
        - supported_type_promotions
      type: object
    data_catalog_core_src_models_mod_rs_CatalogReference:
      properties:
        catalog_id:
          $ref: '#/components/schemas/shared_common_src_lib_rs_CatalogId'
        revision:
          type: string
      required:
        - catalog_id
        - revision
      type: object
    shared_common_src_lib_rs_CatalogId:
      format: uuid
      type: string

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.