# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Snowflake Password Policy API
  version: 1.0.0
extends: openapi/snowflake-password-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: 8
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/password-policies'].get
  update:
    x-apievangelist-phrasing:
      intent: List password policies in a schema
      effect: read
      questions:
      - Which password policies are defined in this schema?
      - Can I see all the password rules we've set up?
      instructions:
      - text: List all password policies in schema {schema} of database {database}.
        slots:
          database: path.database
          schema: path.schema
      - text: Show me the password policies defined here.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/password-policies'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a password policy
      effect: write
      questions:
      - How do I require a minimum password length and special characters for users?
      - Can a password policy lock users out after too many failed attempts?
      - Is it possible to force passwords to expire after a set number of days?
      instructions:
      - text: Create password policy {name} in {database}.{schema} requiring at least {password_min_length} characters.
        slots:
          name: requestBody.name
          password_min_length: requestBody.password_min_length
          database: path.database
          schema: path.schema
      - text: Create password policy {name} that locks users out for {password_lockout_time_mins} minutes after {password_max_retries} failed tries.
        slots:
          name: requestBody.name
          password_lockout_time_mins: requestBody.password_lockout_time_mins
          password_max_retries: requestBody.password_max_retries
      - text: Create password policy {name} where passwords expire after {password_max_age_days} days.
        slots:
          name: requestBody.name
          password_max_age_days: requestBody.password_max_age_days
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/password-policies/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe a password policy
      effect: read
      questions:
      - What length, complexity and lockout rules does this password policy enforce?
      - Can I look up the settings of one password policy?
      instructions:
      - text: Describe password policy {policy} in {database}.{schema}.
        slots:
          policy: path.name
          database: path.database
          schema: path.schema
      - text: Fetch this password policy's rules.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/password-policies/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a password policy
      effect: destructive
      questions:
      - How do I drop a password policy?
      - Can a password policy be removed through the API?
      instructions:
      - text: Drop password policy {policy} from {database}.{schema}.
        slots:
          policy: path.name
          database: path.database
          schema: path.schema
      - text: Delete the password policy I named.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/password-policies/{name}:rename'].post
  update:
    x-apievangelist-phrasing:
      intent: Rename or move a password policy
      effect: write
      questions:
      - How do I rename a password policy?
      - Can I move a password policy into a different schema?
      instructions:
      - text: Rename password policy {policy} in {database}.{schema} to {targetName}.
        slots:
          policy: path.name
          database: path.database
          schema: path.schema
          targetName: query.targetName
      - text: Move this password policy to {targetDatabase}.{targetSchema} as {targetName}.
        slots:
          targetDatabase: query.targetDatabase
          targetSchema: query.targetSchema
          targetName: query.targetName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/password-policies/{name}:set-tags'].post
  update:
    x-apievangelist-phrasing:
      intent: Set tags on a password policy
      effect: write
      questions:
      - How do I tag a password policy?
      - Can I label a password policy with a compliance tag?
      instructions:
      - text: Set tags on password policy {policy} in {database}.{schema}.
        slots:
          policy: path.name
          database: path.database
          schema: path.schema
      - text: Apply my tag assignments to the password policy I named.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/password-policies/{name}:unset-tags'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove tags from a password policy
      effect: write
      questions:
      - Can I remove tags from a password policy?
      - What's the way to clear a tag off a password policy?
      instructions:
      - text: Unset the tags on password policy {policy} in {database}.{schema}.
        slots:
          policy: path.name
          database: path.database
          schema: path.schema
      - text: Remove the tag assignments from the password policy I named.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/password-policies/{name}:get-tags'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the tags assigned to a password policy
      effect: read
      questions:
      - Which tags are assigned to this password policy?
      - Does reading a password policy's tags need an active warehouse?
      instructions:
      - text: Show every tag assigned to password policy {policy} in {database}.{schema}.
        slots:
          policy: path.name
          database: path.database
          schema: path.schema
      - text: List the tag assignments on the password policy I named.
      method: generated
      generated: '2026-10-01'