# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Snowflake Artifact Repository API
  version: 1.0.0
extends: openapi/snowflake-artifact-repository-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: 6
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/artifact-repositories'].get
  update:
    x-apievangelist-phrasing:
      intent: List artifact repositories in a schema
      effect: read
      questions:
      - Which artifact repositories are defined in this schema?
      - Can I see the package repositories available to my Snowflake code?
      instructions:
      - text: List the artifact repositories in schema {schema} of database {database}.
        slots:
          database: path.database
          schema: path.schema
      - text: Show me every artifact repository in the schema I named.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/artifact-repositories'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an artifact repository
      effect: write
      questions:
      - How do I register a package repository so functions can install packages from it?
      - Which API integration does a new artifact repository need?
      instructions:
      - text: Create artifact repository {name} of type {type} in {database}.{schema} using API integration {api_integration}.
        slots:
          database: path.database
          schema: path.schema
          name: requestBody.name
          type: requestBody.type
          api_integration: requestBody.api_integration
      - text: Add a new {type} artifact repository {name} through {api_integration} with comment {comment}.
        slots:
          type: requestBody.type
          name: requestBody.name
          api_integration: requestBody.api_integration
          comment: requestBody.comment
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/artifact-repositories/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an artifact repository
      effect: read
      questions:
      - What type and API integration does a specific artifact repository use?
      - Who owns a given artifact repository?
      instructions:
      - text: Fetch artifact repository {name} from {database}.{schema}.
        slots:
          database: path.database
          schema: path.schema
          name: path.name
      - text: Show the type and integration of this artifact repository.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/artifact-repositories/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an artifact repository
      effect: write
      questions:
      - Can I change the API integration an existing artifact repository uses?
      - Is there a single call that creates an artifact repository or updates it if it exists?
      instructions:
      - text: Create or update artifact repository {name} in {database}.{schema} as type {type} with integration {api_integration}.
        slots:
          database: path.database
          schema: path.schema
          name: path.name
          type: requestBody.type
          api_integration: requestBody.api_integration
      - text: Update the existing artifact repository {name} so it uses {api_integration}.
        slots:
          name: requestBody.name
          api_integration: requestBody.api_integration
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/artifact-repositories/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an artifact repository
      effect: destructive
      questions:
      - How do I remove an artifact repository?
      - What happens to code that depends on an artifact repository I drop?
      instructions:
      - text: Delete artifact repository {name} from {database}.{schema}.
        slots:
          database: path.database
          schema: path.schema
          name: path.name
      - text: Drop this artifact repository from the schema.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/databases/{database}/schemas/{schema}/artifact-repositories/{name}:rename'].post
  update:
    x-apievangelist-phrasing:
      intent: Rename or move an artifact repository
      effect: write
      questions:
      - How do I rename an artifact repository?
      - Can I move an artifact repository to another database or schema?
      instructions:
      - text: Rename artifact repository {name} in {database}.{schema} to {targetName}.
        slots:
          database: path.database
          schema: path.schema
          name: path.name
          targetName: query.targetName
      - text: Move the artifact repository to {targetDatabase}.{targetSchema} as {targetName}.
        slots:
          targetDatabase: query.targetDatabase
          targetSchema: query.targetSchema
          targetName: query.targetName
      method: generated
      generated: '2026-10-01'