Mux · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Mux URL Signing Keys API

5 actions 5 updates phrasing extends openapi/mux-com-url-signing-keys-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Mux's API. It is a proposal applied on top of the contract, not a document Mux publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 5

$.info
$.paths['/video/v1/signing-keys'].get
$.paths['/video/v1/signing-keys'].post
$.paths['/video/v1/signing-keys/{SIGNING_KEY_ID}'].get
$.paths['/video/v1/signing-keys/{SIGNING_KEY_ID}'].delete

OpenAPI Overlay

Raw ↑ 
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Mux URL Signing Keys API
  version: 1.0.0
extends: openapi/mux-com-url-signing-keys-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: 4
- target: $.paths['/video/v1/signing-keys'].get
  update:
    x-apievangelist-phrasing:
      intent: List URL signing keys (deprecated)
      effect: read
      questions:
      - Can I still list keys through the older video URL signing keys route?
      - Which URL signing keys does the deprecated video endpoint return?
      instructions:
      - text: List URL signing keys using the deprecated video route.
      - text: List legacy URL signing keys, {limit} per page.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/video/v1/signing-keys'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a URL signing key (deprecated)
      effect: write
      questions:
      - Does the deprecated video signing-keys route still create key pairs?
      - How did the legacy URL signing key creation work?
      instructions:
      - text: Create a URL signing key with the deprecated video route.
      - text: Generate a legacy URL signing key pair.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/video/v1/signing-keys/{SIGNING_KEY_ID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a URL signing key (deprecated)
      effect: read
      questions:
      - Can I look up a key through the old video URL signing keys route?
      - What details does the deprecated URL signing key lookup return?
      instructions:
      - text: Show URL signing key {signing_key_id} from the deprecated video route.
        slots:
          signing_key_id: path.SIGNING_KEY_ID
      - text: Get legacy URL signing key {signing_key_id}.
        slots:
          signing_key_id: path.SIGNING_KEY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/video/v1/signing-keys/{SIGNING_KEY_ID}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a URL signing key (deprecated)
      effect: destructive
      questions:
      - Will deleting a legacy URL signing key break my existing signed URLs?
      - How do I remove a key via the deprecated video signing-keys route?
      instructions:
      - text: Delete URL signing key {signing_key_id} via the deprecated video route.
        slots:
          signing_key_id: path.SIGNING_KEY_ID
      - text: Remove legacy URL signing key {signing_key_id}.
        slots:
          signing_key_id: path.SIGNING_KEY_ID
      method: generated
      generated: '2026-09-26'