# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for LinkedIn Pages Data Portability Feed Content API
  version: 1.0.0
extends: openapi/linkedin-feed-content-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: 3
- target: $.paths['/rest/dmaPosts'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an organization's posts for data portability
      effect: read
      questions:
      - Can I export all posts published by an organization?
      - Which posts has a given author published, for a portability request?
      instructions:
      - text: Get posts authored by {author}.
        slots:
          author: query.author
      - text: Export {count} posts by {author} starting at {start}.
        slots:
          count: query.count
          author: query.author
          start: query.start
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/dmaReactions'].get
  update:
    x-apievangelist-phrasing:
      intent: Get reactions on a piece of content
      effect: read
      questions:
      - Who reacted to a post, and with which reaction type?
      - Can I export reactions on an activity for data portability?
      instructions:
      - text: Get reactions on activity {activityUrn}.
        slots:
          activityUrn: query.activityUrn
      - text: Export {count} reactions for {activityUrn} from offset {start}.
        slots:
          count: query.count
          activityUrn: query.activityUrn
          start: query.start
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/dmaComments'].get
  update:
    x-apievangelist-phrasing:
      intent: Get comments on a piece of content
      effect: read
      questions:
      - Can I export the comments left on a post?
      - Which comments, with authors and timestamps, are on an activity?
      instructions:
      - text: Get comments on activity {activityUrn}.
        slots:
          activityUrn: query.activityUrn
      - text: Export {count} comments on {activityUrn} starting at {start}.
        slots:
          count: query.count
          activityUrn: query.activityUrn
          start: query.start
      method: generated
      generated: '2026-09-26'