# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Cohesity REST Test Data Management API
  version: 1.0.0
extends: openapi/cohesity-test-data-management-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: 8
- target: $.paths['/tdm/objects'].get
  update:
    x-apievangelist-phrasing:
      intent: List test data management objects
      effect: read
      questions:
      - Which databases are being managed for test data cloning?
      - Can I find TDM objects by name or by the task that created them?
      instructions:
      - text: List TDM objects named {name}.
        slots:
          name: query.name
      - text: Show TDM objects from tasks {taskIds}.
        slots:
          taskIds: query.taskIds
      - text: List TDM objects with status {statuses}.
        slots:
          statuses: query.statuses
      method: generated
      generated: '2026-10-01'
- target: $.paths['/tdm/objects/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a test data management object
      effect: read
      questions:
      - How do I see details for one TDM clone object?
      - What state is a particular test data object in?
      instructions:
      - text: Get TDM object {id}.
        slots:
          id: path.id
      - text: Show details of test data object {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/tdm/objects/{id}/timeline-events'].get
  update:
    x-apievangelist-phrasing:
      intent: Show the timeline of a TDM object
      effect: read
      questions:
      - What has happened to a test data clone over time, like snapshots and refreshes?
      - Can I limit a TDM object's timeline to events after a certain date?
      instructions:
      - text: Show timeline events for TDM object {id}.
        slots:
          id: path.id
      - text: List events for TDM object {id} created after {createdAfter}.
        slots:
          id: path.id
          createdAfter: query.createdAfter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/tdm/snapshots/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Relabel a TDM snapshot
      effect: write
      questions:
      - Can I give a test data snapshot a friendlier label?
      - How do I rename a TDM snapshot?
      instructions:
      - text: Label TDM snapshot {id} as {label}.
        slots:
          id: path.id
          label: requestBody.label
      - text: Set the label of snapshot {id} to {label}.
        slots:
          id: path.id
          label: requestBody.label
      method: generated
      generated: '2026-10-01'
- target: $.paths['/tdm/snapshots/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a TDM snapshot
      effect: destructive
      questions:
      - How do I delete a test data snapshot I don't need anymore?
      - Can I remove one TDM snapshot without touching the object?
      instructions:
      - text: Delete TDM snapshot {id}.
        slots:
          id: path.id
      - text: Remove test data snapshot {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/tdm/tasks'].get
  update:
    x-apievangelist-phrasing:
      intent: List test data management tasks
      effect: read
      questions:
      - Which test data clone or refresh tasks ran in the last day?
      - Can I list TDM tasks for a specific object or action?
      instructions:
      - text: List TDM tasks for objects {objectIds}.
        slots:
          objectIds: query.objectIds
      - text: Show TDM tasks with action {actions} and status {statuses}.
        slots:
          actions: query.actions
          statuses: query.statuses
      method: generated
      generated: '2026-10-01'
- target: $.paths['/tdm/tasks'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a test data management task
      effect: write
      questions:
      - How do I kick off a clone or refresh of test data?
      - Can I name a TDM task when I start it?
      instructions:
      - text: Create a TDM task with action {action}.
        slots:
          action: requestBody.action
      - text: Start TDM task {name} performing {action}.
        slots:
          name: requestBody.name
          action: requestBody.action
      method: generated
      generated: '2026-10-01'
- target: $.paths['/tdm/tasks/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a test data management task
      effect: read
      questions:
      - How do I check on one TDM task I started?
      - Did a particular test data task finish successfully?
      instructions:
      - text: Get TDM task {id}.
        slots:
          id: path.id
      - text: Show the status of test data task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'