# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Conversations Inbox & Messages Actors API
  version: 1.0.0
extends: openapi/hubspot-actors-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-24'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/conversations/v3/conversations/actors/batch/read'].post
  update:
    x-apievangelist-phrasing:
      intent: Resolve several conversation actors at once
      effect: write
      questions:
      - How do I turn a batch of actor IDs from conversation messages into real participants?
      - Can I look up many conversation participants in a single request?
      instructions:
      - text: Resolve conversation actor IDs {inputs} to their participants.
        slots:
          inputs: requestBody.inputs
      - text: Batch-look up actors {inputs} and return their {property}.
        slots:
          inputs: requestBody.inputs
          property: query.property
      method: generated
      generated: '2026-09-24'
- target: $.paths['/conversations/v3/conversations/actors/{actorId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one conversation actor
      effect: read
      questions:
      - Who is behind a particular actor ID on a conversation message?
      - What details can I get about a single participant in an inbox conversation?
      instructions:
      - text: Show conversation actor {actorId}.
        slots:
          actorId: path.actorId
      - text: Get the {property} of actor {actorId}.
        slots:
          property: query.property
          actorId: path.actorId
      method: generated
      generated: '2026-09-24'