# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Adobe Experience Platform Edge Network Client-to-server…
  version: 1.0.0
extends: openapi/adobe-launch-client-to-server-collection-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/v1/interact'].post
  update:
    x-apievangelist-phrasing:
      intent: Send one browser event and get a live response
      effect: write
      questions:
      - How do I send a single event from a web or mobile client to the Edge Network and get personalization back?
      - Can an unauthenticated client call return real-time decisions for the event it just sent?
      - What datastream ID does the client-side interact call need?
      instructions:
      - text: Send event {events} from the client to datastream {configId} and return the interactive response.
        slots:
          events: requestBody.events
          configId: query.configId
      - text: Push a single interact event {events} to datastream {configId} with first-party ID {FPID}.
        slots:
          events: requestBody.events
          configId: query.configId
          FPID: cookie.FPID
      - text: Call client interact on datastream {configId} for events {events}, tracing it as {requestId}.
        slots:
          configId: query.configId
          events: requestBody.events
          requestId: query.requestId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/collect'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a batch of client events without a response
      effect: write
      questions:
      - Can I push events from several different end users in one unauthenticated client request?
      - Which client-side call collects events when I don't need anything back?
      - Is there a fire-and-forget way to send many events to a datastream from the browser?
      instructions:
      - text: Collect events {events} on datastream {configId} without waiting for response content.
        slots:
          events: requestBody.events
          configId: query.configId
      - text: Batch-send client events {events} for multiple users to datastream {configId}, request ID {requestId}.
        slots:
          events: requestBody.events
          configId: query.configId
          requestId: query.requestId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/identity/acquire'].post
  update:
    x-apievangelist-phrasing:
      intent: Acquire identities for given namespaces
      effect: write
      questions:
      - How do I fetch the visitor's identities for specific identity namespaces from the Edge Network?
      - Can I acquire an ECID for a visitor before sending any events?
      - Which call returns identities in the namespaces I ask for?
      instructions:
      - text: Acquire the identities for namespaces in query {query} via datastream {configId}.
        slots:
          query: requestBody.query
          configId: query.configId
      - text: Fetch the visitor's identity from datastream {configId} using XDM context {xdm}.
        slots:
          configId: query.configId
          xdm: requestBody.xdm
      method: generated
      generated: '2026-10-01'