# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Snowflake View API
  version: 1.0.0
extends: openapi/snowflake-view-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 7
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/views'].get
  update:
    x-apievangelist-phrasing:
      intent: List views in a schema
      effect: read
      questions:
      - Which views are defined in this schema?
      - Can I include dependency information when listing views?
      instructions:
      - text: List all views in schema {schema} of database {database}.
        slots:
          database: path.database
          schema: path.schema
      - text: List the views here with dependency details ({deep}).
        slots:
          deep: query.deep
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/views'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a view
      effect: write
      questions:
      - How do I save a SELECT query as a reusable view?
      - Can I create a secure view that hides its definition from other users?
      instructions:
      - text: Create view {name} in {database}.{schema} with columns {columns} defined by {query}.
        slots:
          name: requestBody.name
          columns: requestBody.columns
          query: requestBody.query
          database: path.database
          schema: path.schema
      - text: Create a secure view ({secure}) named {name} over {query} exposing {columns}.
        slots:
          secure: requestBody.secure
          name: requestBody.name
          query: requestBody.query
          columns: requestBody.columns
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/views/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe a view
      effect: read
      questions:
      - What query and columns define this view?
      - Can I look up one view's definition?
      instructions:
      - text: Describe view {view} in {database}.{schema}.
        slots:
          view: path.name
          database: path.database
          schema: path.schema
      - text: Fetch this view's query and columns.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/views/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a view
      effect: destructive
      questions:
      - How do I drop a view?
      - Can a view be removed through the API?
      instructions:
      - text: Drop view {view} from {database}.{schema}.
        slots:
          view: path.name
          database: path.database
          schema: path.schema
      - text: Delete the view I named.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/views/{name}:set-tags'].post
  update:
    x-apievangelist-phrasing:
      intent: Set tags on a view
      effect: write
      questions:
      - How do I tag a view?
      - Can I label a view with a sensitivity tag?
      instructions:
      - text: Set tags on view {view} in {database}.{schema}.
        slots:
          view: path.name
          database: path.database
          schema: path.schema
      - text: Apply my tag assignments to the view I named.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/views/{name}:unset-tags'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove tags from a view
      effect: write
      questions:
      - Can I remove tags from a view?
      - What's the way to clear a tag off a view?
      instructions:
      - text: Unset the tags on view {view} in {database}.{schema}.
        slots:
          view: path.name
          database: path.database
          schema: path.schema
      - text: Remove the tag assignments from the view I named.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/views/{name}:get-tags'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the tags assigned to a view
      effect: read
      questions:
      - Which tags are assigned to this view?
      - Does reading a view's tags need an active warehouse?
      instructions:
      - text: Show every tag assigned to view {view} in {database}.{schema}.
        slots:
          view: path.name
          database: path.database
          schema: path.schema
      - text: List the tag assignments on the view I named.
      method: generated
      generated: '2026-10-01'