# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Thehiveryiq Com Media Origin API
  version: 1.0.0
extends: openapi/thehiveryiq-com-media-origin-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: 8
- target: $.paths['/v1/media-origin/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check media-origin service health
      effect: read
      questions:
      - Is the /v1/media-origin receipt service up?
      - Can I health-check media-origin before issuing receipts?
      instructions:
      - text: Check media-origin health.
      - text: Ping the /v1/media-origin service.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/media-origin/receipt'].post
  update:
    x-apievangelist-phrasing:
      intent: Issue a media origin receipt (media-origin path)
      effect: write
      questions:
      - How do I get a signed origin receipt for a media file from its content hash on /v1/media-origin?
      - Can a media-origin receipt include a perceptual hash that survives transcoding?
      instructions:
      - text: Issue a media-origin receipt for asset hash {cryptographic_hash}.
        slots:
          cryptographic_hash: requestBody.cryptographic_hash
      - text: Create a media-origin receipt for {cryptographic_hash} with perceptual hash {perceptual_hash} and rights {rights_state}.
        slots:
          cryptographic_hash: requestBody.cryptographic_hash
          perceptual_hash: requestBody.perceptual_hash
          rights_state: requestBody.rights_state
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/media-origin/verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify a media origin receipt (media-origin path)
      effect: read
      questions:
      - How can I check that a media origin receipt is genuine through /v1/media-origin?
      - Does media-origin verification need the full receipt object?
      instructions:
      - text: Verify media origin receipt {receipt} via /v1/media-origin.
        slots:
          receipt: requestBody.receipt
      - text: Check the signature on media-origin receipt {receipt}.
        slots:
          receipt: requestBody.receipt
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/media-origin/examples'].get
  update:
    x-apievangelist-phrasing:
      intent: Get sample media-origin payloads
      effect: read
      questions:
      - Where can I see example media-origin receipt requests?
      - Are sample payloads published for /v1/media-origin?
      instructions:
      - text: Show the media-origin examples.
      - text: Fetch sample requests for /v1/media-origin.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/mor/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check M.O.R. short-path health
      effect: read
      questions:
      - Is the short /v1/mor endpoint healthy?
      - Can I health-check the M.O.R. alias on its own?
      instructions:
      - text: Check /v1/mor health.
      - text: Ping the M.O.R. short alias.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/mor/issue'].post
  update:
    x-apievangelist-phrasing:
      intent: Issue a media origin receipt (short /v1/mor path)
      effect: write
      questions:
      - Can I issue an M.O.R. receipt through the shorter /v1/mor/issue route?
      - Can per-stem or per-layer hash bindings go on an M.O.R. issue call?
      instructions:
      - text: Using /v1/mor, issue an M.O.R. receipt for {cryptographic_hash}.
        slots:
          cryptographic_hash: requestBody.cryptographic_hash
      - text: Issue an M.O.R. for {cryptographic_hash} with component bindings {component_bindings} on the short route.
        slots:
          cryptographic_hash: requestBody.cryptographic_hash
          component_bindings: requestBody.component_bindings
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/mor/verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify a media origin receipt (short /v1/mor path)
      effect: read
      questions:
      - Can I verify an M.O.R. receipt via the /v1/mor alias?
      - What does the short M.O.R. verify call check?
      instructions:
      - text: Verify {receipt} with /v1/mor/verify.
        slots:
          receipt: requestBody.receipt
      - text: Run the short M.O.R. verify on {receipt}.
        slots:
          receipt: requestBody.receipt
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/mor/examples'].get
  update:
    x-apievangelist-phrasing:
      intent: Get sample payloads for /v1/mor
      effect: read
      questions:
      - Where are the example payloads for the /v1/mor alias?
      - Does the short M.O.R. route publish its own samples?
      instructions:
      - text: Show the /v1/mor examples.
      - text: Fetch sample requests for the M.O.R. short alias.
      method: generated
      generated: '2026-09-26'