# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Prisma Postgres Management Buckets API
  version: 1.0.0
extends: openapi/prisma-buckets-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 7
- target: $.paths['/v1/buckets'].get
  update:
    x-apievangelist-phrasing:
      intent: List object-store buckets
      effect: read
      questions:
      - Which object-store buckets can my token access?
      - Can I list only the buckets that belong to one project?
      instructions:
      - text: List my storage buckets.
      - text: List buckets in project {projectId}.
        slots:
          projectId: query.projectId
      - text: Show the buckets attached to git branch {branchGitName}.
        slots:
          branchGitName: query.branchGitName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/buckets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an object-store bucket
      effect: write
      questions:
      - How do I create an object storage bucket in a Prisma project?
      - Can a new bucket be attached to a specific branch?
      instructions:
      - text: Create a bucket named {name} in project {projectId}.
        slots:
          name: requestBody.name
          projectId: requestBody.projectId
      - text: Create a bucket in {projectId} for git branch {branchGitName}.
        slots:
          projectId: requestBody.projectId
          branchGitName: requestBody.branchGitName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/buckets/{bucketId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a bucket's details
      effect: read
      questions:
      - What details can I pull up for a single bucket by its ID?
      - Where do I look up which project a given bucket belongs to?
      instructions:
      - text: Get bucket {bucketId}.
        slots:
          bucketId: path.bucketId
      - text: Show me the details of storage bucket {bucketId}.
        slots:
          bucketId: path.bucketId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/buckets/{bucketId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a bucket and all its objects
      effect: destructive
      questions:
      - Does deleting a bucket also remove its objects and access keys?
      - Can a deleted bucket be recovered?
      instructions:
      - text: Delete bucket {bucketId}.
        slots:
          bucketId: path.bucketId
      - text: Permanently remove storage bucket {bucketId} with everything stored in it.
        slots:
          bucketId: path.bucketId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/buckets/{bucketId}/keys'].get
  update:
    x-apievangelist-phrasing:
      intent: List a bucket's access keys
      effect: read
      questions:
      - Which access keys exist for a bucket?
      - Can I page through a bucket's access keys?
      instructions:
      - text: List the access keys for bucket {bucketId}.
        slots:
          bucketId: path.bucketId
      - text: Show the first {limit} keys on bucket {bucketId}.
        slots:
          limit: query.limit
          bucketId: path.bucketId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/buckets/{bucketId}/keys'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an access key for a bucket
      effect: write
      questions:
      - How do I create an access key for a bucket?
      - Can I see a bucket key's secret access key again after creating it?
      - What role can I give a new bucket key?
      instructions:
      - text: Create a {role} access key for bucket {bucketId}.
        slots:
          role: requestBody.role
          bucketId: path.bucketId
      - text: Issue a bucket key named {name} with role {role} on {bucketId}.
        slots:
          name: requestBody.name
          role: requestBody.role
          bucketId: path.bucketId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/buckets/{bucketId}/keys/{keyId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revoke a bucket access key
      effect: destructive
      questions:
      - Can I revoke one bucket key without deleting the bucket?
      - What happens when a bucket access key is revoked?
      instructions:
      - text: Delete key {keyId} from bucket {bucketId}.
        slots:
          keyId: path.keyId
          bucketId: path.bucketId
      - text: Revoke bucket access key {keyId} on {bucketId}.
        slots:
          keyId: path.keyId
          bucketId: path.bucketId
      method: generated
      generated: '2026-09-26'