# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Adobe Workfront Baseline API
  version: 1.0.0
extends: openapi/adobe-suite-baseline-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: 10
- target: $.paths['/baseline/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Workfront baseline
      effect: read
      questions:
      - How do I fetch one Workfront project baseline by ID?
      - Can I choose which fields come back for a single baseline?
      instructions:
      - text: Show me baseline {id}.
        slots:
          id: path.id
      - text: Get baseline {id} with fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/baseline/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a Workfront baseline
      effect: write
      questions:
      - How do I update one project baseline?
      - Can I edit a single baseline and get specific fields back?
      instructions:
      - text: Update baseline {id}.
        slots:
          id: path.id
      - text: Edit baseline {id} and return fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/baseline/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Workfront baseline
      effect: destructive
      questions:
      - How do I delete one project baseline?
      - Can I force-delete a baseline that has dependencies?
      instructions:
      - text: Delete baseline {id}.
        slots:
          id: path.id
      - text: Delete baseline {id} with force set to {force}.
        slots:
          id: path.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/baseline'].get
  update:
    x-apievangelist-phrasing:
      intent: Get several baselines by ID
      effect: read
      questions:
      - How do I fetch multiple baselines in one request?
      - Can I bulk-read baselines when I have a list of IDs?
      instructions:
      - text: Get baselines {ids}.
        slots:
          ids: query.id
      - text: Fetch baselines {ids} with fields {fields}.
        slots:
          ids: query.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/baseline'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk edit baselines
      effect: write
      questions:
      - How do I update many baselines at once?
      - Is there a bulk edit for project baselines?
      instructions:
      - text: Bulk update these baselines.
      - text: Edit several baselines at once and return fields {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/baseline'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a project baseline
      effect: write
      questions:
      - How do I create a new baseline to snapshot a project's plan?
      - Can I capture a baseline of a project's dates through the API?
      instructions:
      - text: Create a new baseline.
      - text: Create a baseline and return fields {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/baseline'].delete
  update:
    x-apievangelist-phrasing:
      intent: Bulk delete baselines
      effect: destructive
      questions:
      - How do I delete several baselines in one call?
      - Can I force-delete a batch of baselines?
      instructions:
      - text: Delete baselines {ids}.
        slots:
          ids: query.id
      - text: Force delete baselines {ids} with force {force}.
        slots:
          ids: query.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/baseline/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count baselines
      effect: read
      questions:
      - How many baselines exist in Workfront?
      - Can I count baselines that match a filter?
      instructions:
      - text: Count all baselines.
      - text: Count baselines matching {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/baseline/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search baselines
      effect: read
      questions:
      - How do I search baselines by project or date?
      - What filters can I use to find baselines?
      instructions:
      - text: Search baselines where {filters}.
        slots:
          filters: query.filters
      - text: Find baselines matching {filters} and return {fields}.
        slots:
          filters: query.filters
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/baseline/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run a report on baselines
      effect: read
      questions:
      - Can I get aggregated report data about baselines?
      - How do I build a grouped report over project baselines?
      instructions:
      - text: Run a baseline report.
      - text: Report on baselines filtered by {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'