# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Adobe Assets API
  version: 1.0.0
extends: openapi/adobe-assets-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: 6
- target: $.paths['/assets'].post
  update:
    x-apievangelist-phrasing:
      intent: Get an upload URL for a new asset
      effect: write
      questions:
      - How do I upload a PDF so PDF Services operations can use it?
      - How long does a pre-signed upload URI stay valid?
      instructions:
      - text: Get a pre-signed upload URI for a file of type {mediaType}.
        slots:
          mediaType: requestBody.mediaType
      - text: Create a new asset and give me the URL to upload my PDF to.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/assets/{assetId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a download URL for an asset
      effect: read
      questions:
      - Where can I download the content of an asset I stored?
      - Can I fetch a stored asset straight from the cloud storage with a pre-signed link?
      instructions:
      - text: Get the pre-signed download URI for my stored asset.
      - text: Give me a temporary link to download the content of this asset.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/assets/{assetId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an asset from storage
      effect: destructive
      questions:
      - Can I remove a stored asset from the cloud provider before it expires?
      - How do I clean up temporary assets I no longer need?
      instructions:
      - text: Delete this stored asset from cloud storage.
      - text: Remove my uploaded asset from storage now.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/assets/{assetId}/metadata'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the metadata of a stored asset
      effect: read
      questions:
      - What metadata is kept for a temporary asset I uploaded?
      - Can I check the details of a stored asset without downloading it?
      instructions:
      - text: Get the metadata for my stored asset.
      - text: Show the stored metadata of this temporary asset.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/assets/{assetID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a download URI for an asset or job output
      effect: read
      questions:
      - How do I download the result file from a finished PDF job?
      - Is the download URI for a job output only valid for a limited time?
      instructions:
      - text: Get a download URI for asset {assetID}.
        slots:
          assetID: path.assetID
      - text: Fetch the download link for job output asset {assetID}.
        slots:
          assetID: path.assetID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/assets/{assetID}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a previously uploaded asset
      effect: destructive
      questions:
      - Can I delete an asset I uploaded to the platform by its asset ID?
      - Which call removes a previously uploaded asset ID from the platform?
      instructions:
      - text: Delete asset {assetID}.
        slots:
          assetID: path.assetID
      - text: Remove the previously uploaded asset {assetID} from the platform.
        slots:
          assetID: path.assetID
      method: generated
      generated: '2026-09-26'