API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router Agent OS Workspace Board API

# 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 Agent OS Workspace Board API
  version: 1.0.0
extends: openapi/agoragentic-com-agent-os-workspace-board-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: 12
- target: $.paths['/agent-os/workspace-boards/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a workspace board without saving
      effect: read
      questions:
      - Can I see what lanes a new Agent OS workspace board would have before creating it?
      - Does previewing a workspace board change anything?
      instructions:
      - text: Preview a workspace board for workspace {workspace_id} without writing it.
        slots:
          workspace_id: requestBody.workspace_id
      - text: Dry-run a board named {name} to see its evidence lanes.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/workspace-boards'].get
  update:
    x-apievangelist-phrasing:
      intent: List my workspace boards
      effect: read
      questions:
      - Which Agent OS workspace boards do I own?
      - Can I list only the boards belonging to one workspace?
      instructions:
      - text: List my workspace boards.
      - text: Show the boards in workspace {workspace_id}.
        slots:
          workspace_id: query.workspace_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/workspace-boards'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a workspace board
      effect: write
      questions:
      - How do I set up a new deployment evidence board for my Agent OS workspace?
      - Does creating a workspace board give it any authority to spend or execute?
      instructions:
      - text: Create a workspace board named {name} in workspace {workspace_id}.
        slots:
          name: requestBody.name
          workspace_id: requestBody.workspace_id
      - text: Save a new board {name} with idempotency key {idempotency_key}.
        slots:
          name: requestBody.name
          idempotency_key: requestBody.idempotency_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/workspace-boards/{board_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one workspace board
      effect: read
      questions:
      - How do I open a single workspace board to see its lanes and settings?
      - What does a workspace board record contain?
      instructions:
      - text: Show workspace board {board_id}.
        slots:
          board_id: path.board_id
      - text: Open board {board_id} and describe its lanes.
        slots:
          board_id: path.board_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/workspace-boards/{board_id}/cards'].get
  update:
    x-apievangelist-phrasing:
      intent: List cards on a workspace board
      effect: read
      questions:
      - What deployment cards are on my workspace board?
      - Can I see only the cards sitting in one lane of a board?
      instructions:
      - text: List the cards on board {board_id}.
        slots:
          board_id: path.board_id
      - text: Show cards in lane {lane_id} of board {board_id}.
        slots:
          lane_id: query.lane_id
          board_id: path.board_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/workspace-boards/{board_id}/cards'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a deployment card with evidence
      effect: write
      questions:
      - How do I add a deployment card with its goal and evidence sources to a board?
      - Does adding a card to a board run any proofs or deployments?
      instructions:
      - text: Add card {title} with goal {goal} to board {board_id}.
        slots:
          title: requestBody.title
          goal: requestBody.goal
          board_id: path.board_id
      - text: 'Create a card {title} on board {board_id} for deployment {deployment_id}, goal: {goal}.'
        slots:
          title: requestBody.title
          board_id: path.board_id
          deployment_id: requestBody.deployment_id
          goal: requestBody.goal
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/workspace-cards/{card_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one workspace card
      effect: read
      questions:
      - How do I look at a single deployment card and which lane it's in?
      - What's stored on a workspace card?
      instructions:
      - text: Show workspace card {card_id}.
        slots:
          card_id: path.card_id
      - text: Tell me the goal and current lane of card {card_id}.
        slots:
          card_id: path.card_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/workspace-cards/{card_id}/evidence'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a card's latest evidence bundle
      effect: read
      questions:
      - What evidence currently backs a deployment card?
      - Where can I see the redacted evidence bundle attached to a card?
      instructions:
      - text: Show the latest evidence bundle for card {card_id}.
        slots:
          card_id: path.card_id
      - text: Get the redacted evidence behind workspace card {card_id}.
        slots:
          card_id: path.card_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/workspace-cards/{card_id}/audit'].get
  update:
    x-apievangelist-phrasing:
      intent: View a card's audit trail
      effect: read
      questions:
      - Who moved or changed a workspace card, and when?
      - Is there an append-only history of events for each card?
      instructions:
      - text: Show the audit events for card {card_id}.
        slots:
          card_id: path.card_id
      - text: List the history of changes to workspace card {card_id}.
        slots:
          card_id: path.card_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/workspace-cards/{card_id}/move'].post
  update:
    x-apievangelist-phrasing:
      intent: Move a card to another lane
      effect: write
      questions:
      - How do I advance a deployment card to the next lane on the evidence ladder?
      - Why would moving a card to a lane be refused?
      instructions:
      - text: Move card {card_id} to lane {target_lane_id}.
        slots:
          card_id: path.card_id
          target_lane_id: requestBody.target_lane_id
      - text: Advance workspace card {card_id} into {target_lane_id} if its evidence passes.
        slots:
          card_id: path.card_id
          target_lane_id: requestBody.target_lane_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/workspace-cards/{card_id}/recheck'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh a card's evidence bundle
      effect: write
      questions:
      - How do I re-gather the evidence for a card after something changed?
      - Can I refresh a card's evidence bundle on demand?
      instructions:
      - text: Recheck the evidence for card {card_id}.
        slots:
          card_id: path.card_id
      - text: Rebuild workspace card {card_id}'s evidence bundle now.
        slots:
          card_id: path.card_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/workspace-cards/{card_id}/archive'].post
  update:
    x-apievangelist-phrasing:
      intent: Archive a workspace card
      effect: destructive
      questions:
      - How do I archive a deployment card I no longer need on the board?
      - Can I clear finished cards off a workspace board?
      instructions:
      - text: Archive card {card_id}.
        slots:
          card_id: path.card_id
      - text: Remove workspace card {card_id} from the board by archiving it.
        slots:
          card_id: path.card_id
      method: generated
      generated: '2026-09-26'