Snowflake · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Snowflake Network Policy API

8 actions 8 updates phrasing extends openapi/snowflake-network-policy-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Snowflake's API. It is a proposal applied on top of the contract, not a document Snowflake publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 8

$.info
$.paths['/api/v2/network-policies'].get
$.paths['/api/v2/network-policies'].post
$.paths['/api/v2/network-policies/{name}'].get
$.paths['/api/v2/network-policies/{name}'].delete
$.paths['/api/v2/network-policies/{name}:set-tags'].post
$.paths['/api/v2/network-policies/{name}:unset-tags'].post
$.paths['/api/v2/network-policies/{name}:get-tags'].get

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Snowflake Network Policy API
  version: 1.0.0
extends: openapi/snowflake-network-policy-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/network-policies'].get
  update:
    x-apievangelist-phrasing:
      intent: List network policies
      effect: read
      questions:
      - Which network policies are defined in my account?
      - Can I see all the IP allow and block policies we have?
      instructions:
      - text: List all network policies in the account.
      - text: Show me every network policy.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/network-policies'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a network policy
      effect: write
      questions:
      - How do I restrict logins to a set of allowed IP addresses?
      - Can a network policy block specific IP ranges?
      - Is it possible to build a network policy from existing network rules?
      instructions:
      - text: Create network policy {name} allowing IPs {allowed_ip_list}.
        slots:
          name: requestBody.name
          allowed_ip_list: requestBody.allowed_ip_list
      - text: Create network policy {name} that blocks {blocked_ip_list}.
        slots:
          name: requestBody.name
          blocked_ip_list: requestBody.blocked_ip_list
      - text: Create network policy {name} using allowed network rules {allowed_network_rule_list}.
        slots:
          name: requestBody.name
          allowed_network_rule_list: requestBody.allowed_network_rule_list
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/network-policies/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe a network policy
      effect: read
      questions:
      - What IPs and rules does this network policy allow or block?
      - Can I look up one network policy's settings?
      instructions:
      - text: Describe network policy {name}.
        slots:
          name: path.name
      - text: Fetch this network policy's allowed and blocked lists.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/network-policies/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a network policy
      effect: destructive
      questions:
      - How do I drop a network policy?
      - Can a network policy be removed through the API?
      instructions:
      - text: Drop network policy {name}.
        slots:
          name: path.name
      - text: Delete the network policy I named.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/network-policies/{name}:set-tags'].post
  update:
    x-apievangelist-phrasing:
      intent: Set tags on a network policy
      effect: write
      questions:
      - How do I tag a network policy?
      - Can I label a network policy with a security tag?
      instructions:
      - text: Set tags on network policy {name}.
        slots:
          name: path.name
      - text: Apply my tag assignments to the network policy I named.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/network-policies/{name}:unset-tags'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove tags from a network policy
      effect: write
      questions:
      - Can I remove tags from a network policy?
      - What's the way to clear a tag off a network policy?
      instructions:
      - text: Unset the tags on network policy {name}.
        slots:
          name: path.name
      - text: Remove the tag assignments from the network policy I named.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/network-policies/{name}:get-tags'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the tags assigned to a network policy
      effect: read
      questions:
      - Which tags are assigned to this network policy?
      - Does reading a network policy's tags need an active warehouse?
      instructions:
      - text: Show every tag assigned to network policy {name}.
        slots:
          name: path.name
      - text: List the tag assignments on the network policy I named.
      method: generated
      generated: '2026-10-01'