LinkedIn Pull Social Action Notifications

arazzo: 1.0.1
info:
  title: LinkedIn Pull Social Action Notifications
  summary: Confirm organization access, then pull pending social action notifications.
  description: >-
    The pull delivery model lets an application poll for organization social
    action notifications it is authorized to read. This workflow first confirms
    the authenticated member's access to the organization via the access control
    finder, and then retrieves pending social action notifications for the
    authenticated member's organization. Every step spells out its request
    inline, including the Authorization bearer token and the required
    LinkedIn-Version header, so the flow can be read and executed without opening
    the underlying OpenAPI description.
  version: 1.0.0
sourceDescriptions:
- name: useCasesOrganizationAccessControlsApi
  url: ../openapi/linkedin-use-cases-organization-access-controls-api-openapi.yml
  type: openapi
- name: useCasesSocialActionsNotificationsOrganizationSocialActionsNotificationsPullWorkflowApi
  url: ../openapi/linkedin-use-cases-social-actions-notifications-organization-social-actions-notifications-pull-workflow-api-openapi.yml
  type: openapi
workflows:
- workflowId: pull-social-action-notifications
  summary: Confirm organization access and pull pending social action notifications.
  description: >-
    Confirms the authenticated member's access to the organization, then
    retrieves pending organization social action notifications.
  inputs:
    type: object
    required:
    - authorization
    - linkedinVersion
    - organizationUrn
    properties:
      authorization:
        type: string
        description: The OAuth 2.0 bearer credential, e.g. "Bearer <access-token>".
      linkedinVersion:
        type: string
        description: The LinkedIn-Version header in YYYYMM format (e.g. "202401").
      organizationUrn:
        type: string
        description: The URL-encoded organization URN to check access for (e.g. "urn%3Ali%3Aorganization%3A123456").
  steps:
  - stepId: confirmAccess
    description: >-
      Confirm the authenticated member's access control role on the organization
      before polling notifications.
    operationId: getFindOrganizationAccessControl
    parameters:
    - name: Authorization
      in: header
      value: $inputs.authorization
    - name: Linkedin-Version
      in: header
      value: $inputs.linkedinVersion
    - name: X-Restli-Protocol-Version
      in: header
      value: "2.0.0"
    - name: q
      in: query
      value: organization
    - name: organization
      in: query
      value: $inputs.organizationUrn
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      accessControl: $response.body
  - stepId: pullNotifications
    description: >-
      Retrieve pending social action notifications for the authenticated
      member's organization.
    operationId: getRetrieveNotificationsForThe
    parameters:
    - name: Authorization
      in: header
      value: $inputs.authorization
    - name: Linkedin-Version
      in: header
      value: $inputs.linkedinVersion
    - name: X-Restli-Protocol-Version
      in: header
      value: "2.0.0"
    - name: q
      in: query
      value: subscriberAndEventType
    - name: eventType
      in: query
      value: ORGANIZATION_SOCIAL_ACTION_NOTIFICATIONS
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      notifications: $response.body
  outputs:
    notifications: $steps.pullNotifications.outputs.notifications