# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Canva Connect Resizes API
  version: 1.0.0
extends: openapi/canva-resizes-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: 2
- target: $.paths['/resizes'].post
  update:
    x-apievangelist-phrasing:
      intent: Resize a design
      effect: write
      questions:
      - Can I resize a design to custom dimensions without changing the original?
      - How do I convert a design into a doc or whiteboard?
      instructions:
      - text: Resize design {design_id} as {design_type}.
        slots:
          design_id: requestBody.design_id
          design_type: requestBody.design_type
      - text: Create a resized copy of design {design_id} using {design_type}.
        slots:
          design_id: requestBody.design_id
          design_type: requestBody.design_type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/resizes/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a resize job's result
      effect: read
      questions:
      - Is my resize job done?
      - What does a successful resize job return?
      instructions:
      - text: Get resize job {jobId}.
        slots:
          jobId: path.jobId
      - text: Show the new design produced by resize job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-09-26'