# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router Jobs API
  version: 1.0.0
extends: openapi/agoragentic-com-jobs-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['/jobs/summary'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a health summary of my recurring jobs
      effect: read
      questions:
      - How healthy are my recurring jobs overall, and are any under budget pressure?
      - Is there a single overview of job health, recent run performance and recommendations?
      instructions:
      - text: Give me the operating summary for my recurring jobs.
      - text: Summarize job health and budget pressure, including up to {limit} active jobs.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List my scheduled jobs
      effect: read
      questions:
      - Which scheduled jobs do I have set up on Agoragentic?
      - Can I list only my paused jobs?
      instructions:
      - text: List all my scheduled jobs.
      - text: Show my scheduled jobs with status {status}, up to {limit}.
        slots:
          status: query.status
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/jobs'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a recurring scheduled job
      effect: write
      questions:
      - How do I schedule a task to run on a recurring basis?
      - Can I cap how much a scheduled job spends per run and in total?
      instructions:
      - text: Create a job called {name} that runs {task} on a {schedule_type} schedule.
        slots:
          name: requestBody.name
          task: requestBody.task
          schedule_type: requestBody.schedule_type
      - text: Schedule job {name} to do {task} every {schedule_value} ({schedule_type}) with a {max_budget_per_run} per-run budget.
        slots:
          name: requestBody.name
          task: requestBody.task
          schedule_value: requestBody.schedule_value
          schedule_type: requestBody.schedule_type
          max_budget_per_run: requestBody.max_budget_per_run
      method: generated
      generated: '2026-09-26'
- target: $.paths['/jobs/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of one scheduled job
      effect: read
      questions:
      - How can I see the budget policy and recovery state of a specific job?
      - What does the configuration of one of my scheduled jobs look like?
      instructions:
      - text: Show me the details of job {id}.
        slots:
          id: path.id
      - text: Get the budget policy and recommendations for scheduled job {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/jobs/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a scheduled job
      effect: destructive
      questions:
      - How do I permanently remove a scheduled job?
      - Can I delete a job that has Fleet binding history?
      instructions:
      - text: Delete scheduled job {id}.
        slots:
          id: path.id
      - text: Remove job {id} permanently from my schedule.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/jobs/{id}/pause'].post
  update:
    x-apievangelist-phrasing:
      intent: Pause a scheduled job
      effect: write
      questions:
      - How do I temporarily stop a recurring job without deleting it?
      - Can I pause a job that has an active Fleet binding?
      instructions:
      - text: Pause job {id}.
        slots:
          id: path.id
      - text: Put scheduled job {id} on hold until I resume it.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/jobs/{id}/resume'].post
  update:
    x-apievangelist-phrasing:
      intent: Resume a paused job
      effect: write
      questions:
      - How do I restart a job I previously paused?
      - What happens if I try to resume a paused job that's bound to Fleet?
      instructions:
      - text: Resume paused job {id}.
        slots:
          id: path.id
      - text: Turn scheduled job {id} back on so it runs on its schedule again.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/jobs/{id}/run-now'].post
  update:
    x-apievangelist-phrasing:
      intent: Trigger a job run immediately
      effect: write
      questions:
      - Can I run a scheduled job right now instead of waiting for its next slot?
      - Which jobs are allowed to run manually while paid execution is frozen?
      instructions:
      - text: Run job {id} now.
        slots:
          id: path.id
      - text: Manually trigger an off-schedule run of job {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/jobs/{id}/runs'].get
  update:
    x-apievangelist-phrasing:
      intent: List the runs of one job
      effect: read
      questions:
      - How do I see the execution history of a single scheduled job?
      - When did a particular job last run, and did it succeed?
      instructions:
      - text: List the runs of job {id}.
        slots:
          id: path.id
      - text: Show the run history for scheduled job {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/jobs/{id}/reconciliation'].get
  update:
    x-apievangelist-phrasing:
      intent: Reconcile a job's spend and receipts
      effect: read
      questions:
      - How much has one scheduled job spent, and what is its success rate?
      - Can I see the invocation receipts and budget utilization for a specific job?
      instructions:
      - text: Reconcile spend and receipts for job {id}.
        slots:
          id: path.id
      - text: Show budget utilization and the last {limit} receipts for job {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-09-26'