Adobe Suite · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Cloud Manager EDS Sites API

7 actions 7 updates phrasing extends openapi/adobe-suite-eds-sites-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Adobe Suite's API. It is a proposal applied on top of the contract, not a document Adobe Suite publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 7

$.info
$.paths['/api/program/{programId}/site/{siteId}'].get
$.paths['/api/program/{programId}/site/{siteId}'].put
$.paths['/api/program/{programId}/site/{siteId}'].delete
$.paths['/api/program/{programId}/site/{siteId}/validate'].put
$.paths['/api/program/{programId}/sites'].get
$.paths['/api/program/{programId}/sites'].post

OpenAPI Overlay

Raw ↑ 
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Cloud Manager EDS Sites API
  version: 1.0.0
extends: openapi/adobe-suite-eds-sites-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['/api/program/{programId}/site/{siteId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Edge Delivery Services site
      effect: read
      questions:
      - What configuration does a specific Edge Delivery Services site in my program have?
      - Can I look up one EDS site by its ID?
      instructions:
      - text: Show EDS site {siteId} in program {programId}.
        slots:
          siteId: path.siteId
          programId: path.programId
      - text: Get the details of site {siteId} from program {programId}.
        slots:
          siteId: path.siteId
          programId: path.programId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/program/{programId}/site/{siteId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an Edge Delivery Services site
      effect: write
      questions:
      - How do I change the settings of an existing EDS site?
      - Can I edit a site that is already registered in my Cloud Manager program?
      instructions:
      - text: Update EDS site {siteId} in program {programId} with these settings.
        slots:
          siteId: path.siteId
          programId: path.programId
      - text: Save my changes to site {siteId} of program {programId}.
        slots:
          siteId: path.siteId
          programId: path.programId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/program/{programId}/site/{siteId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Edge Delivery Services site
      effect: destructive
      questions:
      - How do I remove an EDS site from my program?
      - What happens when I delete an Edge Delivery Services site?
      instructions:
      - text: Delete EDS site {siteId} from program {programId}.
        slots:
          siteId: path.siteId
          programId: path.programId
      - text: Remove site {siteId} out of program {programId}.
        slots:
          siteId: path.siteId
          programId: path.programId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/program/{programId}/site/{siteId}/validate'].put
  update:
    x-apievangelist-phrasing:
      intent: Validate an Edge Delivery Services site
      effect: write
      questions:
      - How can I check that an EDS site is set up correctly?
      - Is there a validation step I can run on a site before mapping a domain?
      instructions:
      - text: Validate EDS site {siteId} in program {programId}.
        slots:
          siteId: path.siteId
          programId: path.programId
      - text: Run the validation check on site {siteId} for program {programId}.
        slots:
          siteId: path.siteId
          programId: path.programId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/program/{programId}/sites'].get
  update:
    x-apievangelist-phrasing:
      intent: List Edge Delivery Services sites in a program
      effect: read
      questions:
      - Which EDS sites belong to my Cloud Manager program?
      - Can I see all Edge Delivery Services sites at once?
      instructions:
      - text: List all EDS sites in program {programId}.
        slots:
          programId: path.programId
      - text: Show every site registered under program {programId}.
        slots:
          programId: path.programId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/program/{programId}/sites'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an Edge Delivery Services site
      effect: write
      questions:
      - How do I register a new Edge Delivery Services site in a program?
      - Can I add an EDS site through the API?
      instructions:
      - text: Create a new EDS site in program {programId}.
        slots:
          programId: path.programId
      - text: Add a site to program {programId} with the configuration I provide.
        slots:
          programId: path.programId
      method: generated
      generated: '2026-09-26'