# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Anthropic Dreams API
  version: 1.0.0
extends: openapi/anthropic-dreams-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: 5
- target: $.paths['/v1/dreams/{dream_id}/archive?beta=true'].post
  update:
    x-apievangelist-phrasing:
      intent: Archive a dream
      effect: destructive
      questions:
      - How do I archive a dream I no longer need?
      - Can archived dreams be hidden from the dream list?
      instructions:
      - text: Archive dream {dream_id}.
        slots:
          dream_id: path.dream_id
      - text: Move dream {dream_id} to the archive.
        slots:
          dream_id: path.dream_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dreams/{dream_id}/cancel?beta=true'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a running dream
      effect: destructive
      questions:
      - Can I stop a dream that's still running?
      - What's the way to abort a dream I started by mistake?
      instructions:
      - text: Cancel dream {dream_id}.
        slots:
          dream_id: path.dream_id
      - text: Stop the in-progress dream {dream_id}.
        slots:
          dream_id: path.dream_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dreams/{dream_id}?beta=true'].get
  update:
    x-apievangelist-phrasing:
      intent: Check on a dream
      effect: read
      questions:
      - What's the status of a dream I started?
      - Can I fetch a single dream's details by ID?
      instructions:
      - text: Show dream {dream_id}.
        slots:
          dream_id: path.dream_id
      - text: Check whether dream {dream_id} has finished.
        slots:
          dream_id: path.dream_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dreams?beta=true'].get
  update:
    x-apievangelist-phrasing:
      intent: List dreams
      effect: read
      questions:
      - Which dreams have I run recently?
      - Can I list only dreams with a particular lifecycle status?
      instructions:
      - text: List my dreams.
      - text: List dreams with status {statuses}.
        slots:
          statuses: query.statuses[]
      - text: List dreams created after {created_after}.
        slots:
          created_after: query.created_at[gt]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dreams?beta=true'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a dream
      effect: write
      questions:
      - How do I start a new dream over a set of inputs?
      - Which model runs a dream, and can I give it instructions?
      instructions:
      - text: Start a dream on {inputs} using {model}.
        slots:
          inputs: requestBody.inputs
          model: requestBody.model
      - text: Create a dream over {inputs} with {model} and instructions {instructions}.
        slots:
          inputs: requestBody.inputs
          model: requestBody.model
          instructions: requestBody.instructions
      method: generated
      generated: '2026-09-26'