# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Adobe Launch Secrets API
  version: 1.0.0
extends: openapi/adobe-launch-secrets-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: 19
- target: $.paths['/properties/{PROPERTY_ID}/secrets'].get
  update:
    x-apievangelist-phrasing:
      intent: List a property's secrets with filters
      effect: read
      questions:
      - Which secrets are stored on my tag property?
      - Can I filter a property's secrets by status, type or environment?
      instructions:
      - text: List the secrets on tag property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Show secrets of type {type_of} with status {status} on tag property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          type_of: query.type_of
          status: query.status
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/secrets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a secret on a tag property
      effect: write
      questions:
      - How do I add a credential to a tag property so rules can use it?
      - What does the tags endpoint need to create a secret on a property?
      instructions:
      - text: Create a secret on tag property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: 'Store this secret on tag property {PROPERTY_ID}: {data}.'
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/secrets/{SECRET_ID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a secret's details
      effect: read
      questions:
      - How can I check the status of one secret by its ID?
      - What type and environment does a stored secret have?
      instructions:
      - text: Retrieve secret {SECRET_ID}.
        slots:
          SECRET_ID: path.SECRET_ID
      - text: Show me the status and type of secret {SECRET_ID}.
        slots:
          SECRET_ID: path.SECRET_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/secrets/{SECRET_ID}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a secret from a tag property
      effect: destructive
      questions:
      - How do I delete a secret from a tag property?
      - Can I remove a stored credential through the tags secrets endpoint?
      instructions:
      - text: Delete tag secret {SECRET_ID}.
        slots:
          SECRET_ID: path.SECRET_ID
      - text: Remove the stored credential {SECRET_ID} from its tag property.
        slots:
          SECRET_ID: path.SECRET_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/secrets/{SECRET_ID}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Test or retry a secret's exchange
      effect: write
      questions:
      - Can I manually retry a secret exchange that failed?
      - How do I test an oauth2 secret and see the authorization service's response?
      instructions:
      - text: Retry the exchange for secret {SECRET_ID}.
        slots:
          SECRET_ID: path.SECRET_ID
      - text: Test oauth2 secret {SECRET_ID} with payload {data}.
        slots:
          SECRET_ID: path.SECRET_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/environments/{ENVIRONMENT_ID}/secrets'].get
  update:
    x-apievangelist-phrasing:
      intent: List secrets scoped to an environment
      effect: read
      questions:
      - Which secrets are scoped to a particular tag environment?
      - Can I page through an environment's secrets?
      instructions:
      - text: List the secrets in tag environment {ENVIRONMENT_ID}.
        slots:
          ENVIRONMENT_ID: path.ENVIRONMENT_ID
      - text: Show {size} secrets per page for tag environment {ENVIRONMENT_ID}.
        slots:
          ENVIRONMENT_ID: path.ENVIRONMENT_ID
          size: query.page[size]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/secrets/{SECRET_ID}/notes'].get
  update:
    x-apievangelist-phrasing:
      intent: List the notes on a secret
      effect: read
      questions:
      - What notes have teammates left on a secret?
      - Can I search a secret's notes for a keyword?
      instructions:
      - text: List the notes on secret {SECRET_ID}.
        slots:
          SECRET_ID: path.SECRET_ID
      - text: Find notes on secret {SECRET_ID} that mention {text}.
        slots:
          SECRET_ID: path.SECRET_ID
          text: query.text
      method: generated
      generated: '2026-09-26'
- target: $.paths['/secrets/{SECRET_ID}/notes'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a note to a secret
      effect: write
      questions:
      - How do I leave a note on a secret, such as who owns the credential?
      - Can I annotate a secret with a comment?
      instructions:
      - text: Add a note to secret {SECRET_ID}.
        slots:
          SECRET_ID: path.SECRET_ID
      - text: Write a note on secret {SECRET_ID} recording when it was rotated.
        slots:
          SECRET_ID: path.SECRET_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/secrets/{SECRET_ID}/data_elements'].get
  update:
    x-apievangelist-phrasing:
      intent: List data elements that reference a secret
      effect: read
      questions:
      - Which data elements depend on a given secret?
      - What would be affected if I changed this secret?
      instructions:
      - text: List the data elements that reference secret {SECRET_ID}.
        slots:
          SECRET_ID: path.SECRET_ID
      - text: Show enabled data elements using secret {SECRET_ID}.
        slots:
          SECRET_ID: path.SECRET_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/secrets/{SECRET_ID}/environment'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the environment a tag secret is scoped to
      effect: read
      questions:
      - Which environment is a tag secret tied to?
      - Is this tag secret scoped to development, staging or production?
      instructions:
      - text: Retrieve the environment of tag secret {SECRET_ID}.
        slots:
          SECRET_ID: path.SECRET_ID
      - text: Tell me which environment tag secret {SECRET_ID} belongs to.
        slots:
          SECRET_ID: path.SECRET_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/secrets/{SECRET_ID}/property'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the property that owns a tag secret
      effect: read
      questions:
      - Which tag property owns a given secret?
      - How can I trace a tag secret back to its property?
      instructions:
      - text: Retrieve the property of tag secret {SECRET_ID}.
        slots:
          SECRET_ID: path.SECRET_ID
      - text: Tell me which tag property secret {SECRET_ID} is stored on.
        slots:
          SECRET_ID: path.SECRET_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{propertyId}/secrets'].get
  update:
    x-apievangelist-phrasing:
      intent: List secrets for an event forwarding property
      effect: read
      questions:
      - Which secrets does my event forwarding property use to reach external services?
      - Can I filter event forwarding secrets by when they were created or updated?
      instructions:
      - text: List the secrets on event forwarding property {propertyId}.
        slots:
          propertyId: path.propertyId
      - text: Show event forwarding secrets on property {propertyId} created since {created_at}.
        slots:
          propertyId: path.propertyId
          created_at: query.filter[created_at]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{propertyId}/secrets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an event forwarding secret
      effect: write
      questions:
      - How do I store a token, HTTP or OAuth credential for event forwarding?
      - Which credential types can an event forwarding secret use?
      instructions:
      - text: Create an event forwarding secret on property {propertyId}.
        slots:
          propertyId: path.propertyId
      - text: Add an oauth2 secret for event forwarding property {propertyId} using {data}.
        slots:
          propertyId: path.propertyId
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/environments/{environmentId}/secrets'].get
  update:
    x-apievangelist-phrasing:
      intent: List event forwarding secrets in an environment
      effect: read
      questions:
      - Which event forwarding secrets are scoped to one environment?
      - Can I list the server-side credentials for my production environment?
      instructions:
      - text: List the event forwarding secrets in environment {environmentId}.
        slots:
          environmentId: path.environmentId
      - text: Show page {number} of secrets for event forwarding environment {environmentId}.
        slots:
          environmentId: path.environmentId
          number: query.page[number]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/secrets/{secretId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an event forwarding secret
      effect: read
      questions:
      - How do I look up an event forwarding secret by its ID?
      - Did my event forwarding secret's last exchange succeed?
      instructions:
      - text: Fetch event forwarding secret {secretId}.
        slots:
          secretId: path.secretId
      - text: Show the exchange status of event forwarding secret {secretId}.
        slots:
          secretId: path.secretId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/secrets/{secretId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an event forwarding secret
      effect: destructive
      questions:
      - What happens to rules that reference an event forwarding secret when I delete it?
      - Can I permanently remove an event forwarding credential?
      instructions:
      - text: Delete event forwarding secret {secretId}.
        slots:
          secretId: path.secretId
      - text: Permanently remove event forwarding secret {secretId}, disabling rules that use it.
        slots:
          secretId: path.secretId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/secrets/{secretId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Test, retry or reauthorize a forwarding secret
      effect: write
      questions:
      - How do I reauthorize an oauth2-google secret used by event forwarding?
      - Can I re-run a failed exchange on an event forwarding secret?
      instructions:
      - text: Reauthorize event forwarding secret {secretId}.
        slots:
          secretId: path.secretId
      - text: Run action {data} on event forwarding secret {secretId}.
        slots:
          secretId: path.secretId
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/secrets/{secretId}/environment'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an event forwarding secret's environment
      effect: read
      questions:
      - Which environment is an event forwarding secret scoped to?
      - How can I check where a server-side credential is deployed?
      instructions:
      - text: Get the environment of event forwarding secret {secretId}.
        slots:
          secretId: path.secretId
      - text: Tell me which environment event forwarding secret {secretId} is scoped to.
        slots:
          secretId: path.secretId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/secrets/{secretId}/property'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an event forwarding secret's property
      effect: read
      questions:
      - Which event forwarding property owns a given secret?
      - How do I find the edge property a credential belongs to?
      instructions:
      - text: Get the property that owns event forwarding secret {secretId}.
        slots:
          secretId: path.secretId
      - text: Tell me which edge property secret {secretId} is stored on.
        slots:
          secretId: path.secretId
      method: generated
      generated: '2026-09-26'