# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Trello Actions API
  version: 1.0.0
extends: openapi/trello-actions-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: 18
- target: $.paths['/actions/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an activity event
      effect: read
      questions:
      - How do I look up a single Trello action, like a comment or card move, by its id?
      - What details does one activity event record?
      instructions:
      - text: Show me action {id}.
        slots:
          id: path.id
      - text: Fetch the full activity event {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/actions/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit the text of a comment action
      effect: write
      questions:
      - How do I edit a comment when I only have the action id?
      - Can I update actions other than comments?
      instructions:
      - text: Replace the text of comment action {id} with {text}.
        slots:
          id: path.id
          text: query.text
      - text: Update action {id} so the comment says {text}.
        slots:
          id: path.id
          text: query.text
      method: generated
      generated: '2026-09-26'
- target: $.paths['/actions/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a comment action
      effect: destructive
      questions:
      - How do I delete a comment using its action id?
      - Which kinds of actions am I allowed to delete?
      instructions:
      - text: Delete comment action {id}.
        slots:
          id: path.id
      - text: Remove the comment behind action {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/actions/{id}/{field}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one field of an action
      effect: read
      questions:
      - Can I read just the date or type of an action without the rest?
      - How do I fetch a single property from an activity event?
      instructions:
      - text: Get only the {field} of action {id}.
        slots:
          field: path.field
          id: path.id
      - text: Read the {field} value on activity event {id}.
        slots:
          field: path.field
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/actions/{id}/board'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the board an action happened on
      effect: read
      questions:
      - Which board did a given activity event happen on?
      - How do I get the board behind an action?
      instructions:
      - text: Get the board for action {id}.
        slots:
          id: path.id
      - text: Tell me which board activity event {id} occurred on.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/actions/{id}/card'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the card an action relates to
      effect: read
      questions:
      - Which card was an activity event about?
      - How do I get the card referenced by an action?
      instructions:
      - text: Get the card for action {id}.
        slots:
          id: path.id
      - text: Show the card that activity event {id} touched.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/actions/{id}/list'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the list an action relates to
      effect: read
      questions:
      - Which list was involved in an activity event?
      - How do I get the list referenced by an action?
      instructions:
      - text: Get the list for action {id}.
        slots:
          id: path.id
      - text: Show which list activity event {id} involved.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/actions/{id}/member'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the member an action was about
      effect: read
      questions:
      - Who was the subject of an activity event, such as the person added to a card?
      - How do I find the member an action affected?
      instructions:
      - text: Get the member that action {id} was about.
        slots:
          id: path.id
      - text: Show the person affected by activity event {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/actions/{id}/memberCreator'].get
  update:
    x-apievangelist-phrasing:
      intent: Get who performed an action
      effect: read
      questions:
      - Who created a particular action or comment?
      - How do I find out which member performed an activity event?
      instructions:
      - text: Get the member who created action {id}.
        slots:
          id: path.id
      - text: Tell me who performed activity event {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/actions/{id}/organization'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the workspace an action belongs to
      effect: read
      questions:
      - Which workspace did an activity event happen in?
      - How do I get the organization tied to an action?
      instructions:
      - text: Get the workspace for action {id}.
        slots:
          id: path.id
      - text: Show the organization behind activity event {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/actions/{id}/reactions'].get
  update:
    x-apievangelist-phrasing:
      intent: List emoji reactions on an action
      effect: read
      questions:
      - What emoji reactions has a comment received?
      - How do I list every reaction on an action?
      instructions:
      - text: List all emoji reactions on action {id}.
        slots:
          id: path.id
      - text: Show everyone's reactions to comment {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/actions/{id}/reactions'].post
  update:
    x-apievangelist-phrasing:
      intent: React to an action with an emoji
      effect: write
      questions:
      - How do I add an emoji reaction to a comment?
      - Can I choose a skin tone when reacting?
      instructions:
      - text: React to action {id} with {shortName}.
        slots:
          id: path.id
          shortName: requestBody.shortName
      - text: Add a {shortName} emoji with skin variation {skinVariation} to action {id}.
        slots:
          shortName: requestBody.shortName
          skinVariation: requestBody.skinVariation
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/actions/{id}/text'].put
  update:
    x-apievangelist-phrasing:
      intent: Set a comment action's text field
      effect: write
      questions:
      - Is there a dedicated endpoint to overwrite just the text field of a comment action?
      - How do I change a comment's text via the action's text property?
      instructions:
      - text: Overwrite the text property of action {id} with {value}.
        slots:
          id: path.id
          value: query.value
      - text: Use the action text endpoint to set comment {id} to {value}.
        slots:
          id: path.id
          value: query.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/actions/{idAction}/reactions'].get
  update:
    x-apievangelist-phrasing:
      intent: List an action's reactions with member details
      effect: read
      questions:
      - Can I list reactions on an action with the reacting member and emoji details expanded?
      - How do I include who reacted when listing a comment's reactions?
      instructions:
      - text: List reactions on action {idAction} including member {member} and emoji {emoji} details.
        slots:
          idAction: path.idAction
          member: query.member
          emoji: query.emoji
      - text: Show who reacted to action {idAction} and with which emoji.
        slots:
          idAction: path.idAction
      method: generated
      generated: '2026-09-26'
- target: $.paths['/actions/{idAction}/reactions'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a reaction using a native emoji
      effect: write
      questions:
      - Can I react to an action by sending the native emoji character or its unified code?
      - How do I post a reaction identified by a unicode codepoint?
      instructions:
      - text: React to action {idAction} with the native emoji {native}.
        slots:
          idAction: path.idAction
          native: requestBody.native
      - text: Add reaction with unified code {unified} to action {idAction}.
        slots:
          unified: requestBody.unified
          idAction: path.idAction
      method: generated
      generated: '2026-09-26'
- target: $.paths['/actions/{idAction}/reactions/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one reaction on an action
      effect: read
      questions:
      - How do I look up a single reaction by its id?
      - Can I see which member left a specific reaction?
      instructions:
      - text: Get reaction {id} on action {idAction}.
        slots:
          id: path.id
          idAction: path.idAction
      - text: Show details of reaction {id} left on comment {idAction}.
        slots:
          id: path.id
          idAction: path.idAction
      method: generated
      generated: '2026-09-26'
- target: $.paths['/actions/{idAction}/reactions/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a reaction from an action
      effect: destructive
      questions:
      - How do I remove an emoji reaction I added?
      - Can I delete one reaction from a comment?
      instructions:
      - text: Delete reaction {id} from action {idAction}.
        slots:
          id: path.id
          idAction: path.idAction
      - text: Take back my reaction {id} on comment {idAction}.
        slots:
          id: path.id
          idAction: path.idAction
      method: generated
      generated: '2026-09-26'
- target: $.paths['/actions/{idAction}/reactionsSummary'].get
  update:
    x-apievangelist-phrasing:
      intent: Summarize reactions on an action
      effect: read
      questions:
      - How many of each emoji has a comment received?
      - Is there a tally of reactions per emoji for an action?
      instructions:
      - text: Summarize the reaction counts on action {idAction}.
        slots:
          idAction: path.idAction
      - text: Give me the per-emoji tally for comment {idAction}.
        slots:
          idAction: path.idAction
      method: generated
      generated: '2026-09-26'