# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Oracle Cloud Object Storage Preauthenticated Requests API
  version: 1.0.0
extends: openapi/oracle-cloud-preauthenticated-requests-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: 2
- target: $.paths['/n/{namespaceName}/b/{bucketName}/p'].get
  update:
    x-apievangelist-phrasing:
      intent: List pre-authenticated requests on a bucket
      effect: read
      questions:
      - Which pre-authenticated links are currently open on my storage bucket?
      - Can I audit who has credential-free access to a bucket through shared links?
      instructions:
      - text: List pre-authenticated requests on bucket {bucketName} in namespace {namespaceName}.
        slots:
          bucketName: path.bucketName
          namespaceName: path.namespaceName
      - text: Show all shared access links for bucket {bucketName}, namespace {namespaceName}.
        slots:
          bucketName: path.bucketName
          namespaceName: path.namespaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/n/{namespaceName}/b/{bucketName}/p'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a pre-authenticated request for a bucket
      effect: write
      questions:
      - How do I share an object in Object Storage without giving someone credentials?
      - Can I make a pre-authenticated link that expires at a set time?
      instructions:
      - text: Create a pre-authenticated request {name} on bucket {bucketName} in namespace {namespaceName} with {accessType} access expiring {timeExpires}.
        slots:
          name: requestBody.name
          bucketName: path.bucketName
          namespaceName: path.namespaceName
          accessType: requestBody.accessType
          timeExpires: requestBody.timeExpires
      - text: Share object {objectName} from bucket {bucketName}, namespace {namespaceName}, via link {name} with {accessType} access until {timeExpires}.
        slots:
          objectName: requestBody.objectName
          bucketName: path.bucketName
          namespaceName: path.namespaceName
          name: requestBody.name
          accessType: requestBody.accessType
          timeExpires: requestBody.timeExpires
      method: generated
      generated: '2026-09-26'