# 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 Monitoring API
  version: 1.0.0
extends: openapi/cohesity-monitoring-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: 3
- target: $.paths['/public/monitoring/jobRunInfo'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a single job run
      effect: read
      questions:
      - What happened during one particular backup job run?
      - Can I get the run details when I know the job type, job id and run id?
      instructions:
      - text: Show run {jobRunId} of {jobType} job {jobId}.
        slots:
          jobRunId: query.jobRunId
          jobType: query.jobType
          jobId: query.jobId
      - text: Get the run info for job {jobId} run {jobRunId} of type {jobType}.
        slots:
          jobId: query.jobId
          jobRunId: query.jobRunId
          jobType: query.jobType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/monitoring/jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List job runs in a time range
      effect: read
      questions:
      - Which jobs ran on the cluster between two points in time?
      - Can I filter job runs by environment type and page through them?
      instructions:
      - text: List all job runs between {startTimeMsecs} and {endTimeMsecs}.
        slots:
          startTimeMsecs: query.startTimeMsecs
          endTimeMsecs: query.endTimeMsecs
      - text: List {jobTypes} job runs from {startTimeMsecs} to {endTimeMsecs}.
        slots:
          jobTypes: query.jobTypes
          startTimeMsecs: query.startTimeMsecs
          endTimeMsecs: query.endTimeMsecs
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/monitoring/objectDetails'].get
  update:
    x-apievangelist-phrasing:
      intent: List objects processed in a job run
      effect: read
      questions:
      - Which objects were backed up in a given job run, and how did each do?
      - Can I see per-object results for one run?
      instructions:
      - text: List the objects in run {jobRunId} of {jobType} job {jobId}.
        slots:
          jobRunId: query.jobRunId
          jobType: query.jobType
          jobId: query.jobId
      - text: Show per-object details for job {jobId}, run {jobRunId}, type {jobType}.
        slots:
          jobId: query.jobId
          jobRunId: query.jobRunId
          jobType: query.jobType
      method: generated
      generated: '2026-10-01'