# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Trello Labels API
  version: 1.0.0
extends: openapi/trello-labels-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['/labels'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a label on a board
      effect: write
      questions:
      - How do I add a new colored label to a Trello board?
      - Which colors can I choose when creating a label?
      instructions:
      - text: Create a {color} label called {name} on board {idBoard}.
        slots:
          color: query.color
          name: query.name
          idBoard: query.idBoard
      - text: Add label {name} in color {color} to board {idBoard}.
        slots:
          name: query.name
          color: query.color
          idBoard: query.idBoard
      method: generated
      generated: '2026-09-26'
- target: $.paths['/labels/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a label
      effect: read
      questions:
      - How do I look up a label's name and color by its id?
      - Can I fetch a single label to see which board it belongs to?
      instructions:
      - text: Get label {id}.
        slots:
          id: path.id
      - text: Show the name and color of label {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/labels/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename or recolor a label
      effect: write
      questions:
      - Can I change both a label's name and color in one request?
      - How do I recolor an existing label?
      instructions:
      - text: Rename label {id} to {name} and make it {color}.
        slots:
          id: path.id
          name: query.name
          color: query.color
      - text: Change label {id}'s color to {color}.
        slots:
          id: path.id
          color: query.color
      method: generated
      generated: '2026-09-26'
- target: $.paths['/labels/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a label
      effect: destructive
      questions:
      - How do I delete a label from a board?
      - Is deleting a label permanent?
      instructions:
      - text: Delete label {id}.
        slots:
          id: path.id
      - text: Permanently remove label {id} from its board.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/labels/{id}/{field}'].put
  update:
    x-apievangelist-phrasing:
      intent: Set a single field on a label
      effect: write
      questions:
      - Can I update one label field by naming it in the URL?
      - Is there a per-field way to set only a label's name?
      instructions:
      - text: Set field {field} of label {id} to {value}.
        slots:
          field: path.field
          id: path.id
          value: query.value
      - text: Update just the {field} on label {id} to {value}.
        slots:
          field: path.field
          id: path.id
          value: query.value
      method: generated
      generated: '2026-09-26'