Adobe Analytics Clone a Segment

arazzo: 1.0.1
info:
  title: Adobe Analytics Clone a Segment
  summary: Read an existing segment and create a copy of it under a new name.
  description: >-
    Duplicates an Adobe Analytics segment so it can be modified independently of
    the original. The workflow retrieves the source segment by ID — including its
    definition and report suite — and then creates a new segment that reuses that
    definition under a caller-supplied name. Every step spells out its request
    inline, including the Adobe IMS bearer token and Developer Console API key
    headers.
  version: 1.0.0
  x-realizes-capability-ids:
  - BC-420.20
  x-capability-derivation:
    method: 'deterministic join: sourceDescriptions -> per-tag OpenAPI -> tag/capability edge. No classification at this step.'
    min_confidence: 0.7
    sources:
    - capability_id: BC-420.20
      capability_name: Customer Segmentation Management
      spec: adobe-analytics-segments-api-openapi.yml
      confidence: 0.75
    model: Turbo EA Capabilities by Vincent Verdet — Turbo EA, https://github.com/vincentmakes/turbo-ea-capabilities, CC BY 4.0
sourceDescriptions:
- name: segmentsApi
  url: ../openapi/adobe-analytics-segments-api-openapi.yml
  type: openapi
workflows:
- workflowId: clone-segment
  summary: Read a source segment and create a copy of it.
  description: >-
    Fetches the source segment by ID and creates a new segment that reuses the
    source definition and report suite under a new name.
  inputs:
    type: object
    required:
    - accessToken
    - apiKey
    - sourceSegmentId
    - newSegmentName
    properties:
      accessToken:
        type: string
        description: Adobe IMS OAuth 2.0 access token (sent as a Bearer token).
      apiKey:
        type: string
        description: Adobe Developer Console API key (x-api-key header).
      sourceSegmentId:
        type: string
        description: The ID of the segment to clone.
      newSegmentName:
        type: string
        description: Display name for the cloned segment.
      locale:
        type: string
        description: Locale for response labels (e.g. en_US).
        default: en_US
  steps:
  - stepId: getSourceSegment
    description: Retrieve the source segment, including its definition and report suite.
    operationId: getSegment
    parameters:
    - name: Authorization
      in: header
      value: "Bearer $inputs.accessToken"
    - name: x-api-key
      in: header
      value: $inputs.apiKey
    - name: segmentId
      in: path
      value: $inputs.sourceSegmentId
    - name: locale
      in: query
      value: $inputs.locale
    - name: expansion
      in: query
      value: definition
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      sourceRsid: $response.body#/rsid
      sourceDefinition: $response.body#/definition
      sourceDescription: $response.body#/description
  - stepId: createClone
    description: Create a new segment that reuses the source definition under a new name.
    operationId: createSegment
    parameters:
    - name: Authorization
      in: header
      value: "Bearer $inputs.accessToken"
    - name: x-api-key
      in: header
      value: $inputs.apiKey
    requestBody:
      contentType: application/json
      payload:
        name: $inputs.newSegmentName
        description: $steps.getSourceSegment.outputs.sourceDescription
        rsid: $steps.getSourceSegment.outputs.sourceRsid
        definition: $steps.getSourceSegment.outputs.sourceDefinition
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      clonedSegmentId: $response.body#/id
      clonedSegmentName: $response.body#/name
  outputs:
    clonedSegmentId: $steps.createClone.outputs.clonedSegmentId
    clonedSegmentName: $steps.createClone.outputs.clonedSegmentName