Microsoft Entra ID (formerly Azure AD) · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Groups.conversation Thread API

40 actions 40 updates phrasing extends openapi/azure-ad-groups-conversationthread-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Microsoft Entra ID (formerly Azure AD)'s API. It is a proposal applied on top of the contract, not a document Microsoft Entra ID (formerly Azure AD) publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 40 · first 16 shown; the file carries all of them

$.info
$.paths['/groups/{group-id}/threads'].get
$.paths['/groups/{group-id}/threads'].post
$.paths['/groups/{group-id}/threads/{conversationThread-id}'].get
$.paths['/groups/{group-id}/threads/{conversationThread-id}'].delete
$.paths['/groups/{group-id}/threads/{conversationThread-id}'].patch
$.paths['/groups/{group-id}/threads/{conversationThread-id}/microsoft.graph.reply'].post
$.paths['/groups/{group-id}/threads/{conversationThread-id}/posts'].get
$.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}'].get
$.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/attachments'].get
$.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/attachments'].post
$.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/attachments/{attachment-id}'].get
$.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/attachments/{attachment-id}'].delete
$.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/attachments/$count'].get
$.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/attachments/microsoft.graph.createUploadSession'].post
$.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/extensions'].get

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 Groups.conversation Thread API
  version: 1.0.0
extends: openapi/azure-ad-groups-conversationthread-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 39
- target: $.paths['/groups/{group-id}/threads'].get
  update:
    x-apievangelist-phrasing:
      intent: List a group's conversation threads
      effect: read
      questions:
      - How do I see all the conversation threads in a Microsoft 365 group?
      - Can I pull every discussion thread a group has, not just one conversation?
      instructions:
      - text: List all conversation threads in group {group}.
        slots:
          group: path.group-id
      - text: Show me the discussion threads for group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a new group conversation thread
      effect: write
      questions:
      - How do I start a brand new conversation in a group through the Graph API?
      - Can I set the topic and recipients when opening a new group thread?
      instructions:
      - text: Start a new conversation thread in group {group} with the topic {topic}.
        slots:
          group: path.group-id
          topic: requestBody.topic
      - text: Open a new thread in group {group} and send it to {recipients}.
        slots:
          group: path.group-id
          recipients: requestBody.toRecipients
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one conversation thread in a group
      effect: read
      questions:
      - How do I read the details of a single thread in a group, like its topic and senders?
      - What does a specific group conversation thread look like, including its preview text?
      instructions:
      - text: Get thread {thread} in group {group}.
        slots:
          thread: path.conversationThread-id
          group: path.group-id
      - text: Show the topic and unique senders of thread {thread} in group {group}.
        slots:
          thread: path.conversationThread-id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a group conversation thread
      effect: destructive
      questions:
      - How do I delete an entire conversation thread from a group?
      - Can I remove a whole discussion thread from a Microsoft 365 group?
      instructions:
      - text: Delete thread {thread} from group {group}.
        slots:
          thread: path.conversationThread-id
          group: path.group-id
      - text: Remove the whole conversation thread {thread} in group {group}.
        slots:
          thread: path.conversationThread-id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a group conversation thread
      effect: write
      questions:
      - How do I lock an existing group thread so nobody can reply?
      - Can I change the recipients on a thread that already exists in a group?
      instructions:
      - text: Lock thread {thread} in group {group} by setting isLocked to {locked}.
        slots:
          thread: path.conversationThread-id
          group: path.group-id
          locked: requestBody.isLocked
      - text: Update the cc recipients on existing thread {thread} in group {group} to {cc}.
        slots:
          thread: path.conversationThread-id
          group: path.group-id
          cc: requestBody.ccRecipients
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/microsoft.graph.reply'].post
  update:
    x-apievangelist-phrasing:
      intent: Reply to a group conversation thread
      effect: write
      questions:
      - How do I reply to a whole group thread rather than to one specific post?
      - Can I add a reply to an existing conversation thread in a group?
      instructions:
      - text: Reply to thread {thread} in group {group} with post {post}.
        slots:
          thread: path.conversationThread-id
          group: path.group-id
          post: requestBody.Post
      - text: Post a reply at the thread level of {thread} in group {group}.
        slots:
          thread: path.conversationThread-id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts'].get
  update:
    x-apievangelist-phrasing:
      intent: List the posts in a group thread
      effect: read
      questions:
      - How do I read every message posted in a group conversation thread?
      - Which posts make up a particular thread in a group?
      instructions:
      - text: List all posts in thread {thread} of group {group}.
        slots:
          thread: path.conversationThread-id
          group: path.group-id
      - text: Show the messages people posted in thread {thread} in group {group}.
        slots:
          thread: path.conversationThread-id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a single post in a group thread
      effect: read
      questions:
      - How do I fetch one specific post from a group conversation thread?
      - Can I read a single message in a thread by its post id?
      instructions:
      - text: Get post {post} from thread {thread} in group {group}.
        slots:
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Open message {post} in group {group}'s thread {thread}.
        slots:
          post: path.post-id
          group: path.group-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/attachments'].get
  update:
    x-apievangelist-phrasing:
      intent: List attachments on a group thread post
      effect: read
      questions:
      - How do I see which files are attached to a post in a group conversation?
      - What attachments did someone include on a particular group post?
      instructions:
      - text: List the attachments on post {post} in thread {thread} of group {group}.
        slots:
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Show all files attached to group {group} post {post} in thread {thread}.
        slots:
          group: path.group-id
          post: path.post-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/attachments'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an attachment to a group thread post
      effect: write
      questions:
      - How do I attach a small file to a post in a group thread?
      - Can I add an inline attachment to an existing group post?
      instructions:
      - text: Attach a file named {name} to post {post} in thread {thread} of group {group}.
        slots:
          name: requestBody.name
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Add an attachment of type {content_type} to group {group} post {post} in thread {thread}.
        slots:
          content_type: requestBody.contentType
          group: path.group-id
          post: path.post-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/attachments/{attachment-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one attachment from a group thread post
      effect: read
      questions:
      - How do I download the details of one specific attachment on a group post?
      - Can I look up a single attachment on a thread post by its id?
      instructions:
      - text: Get attachment {attachment} on post {post} in thread {thread} of group {group}.
        slots:
          attachment: path.attachment-id
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Show the name and size of attachment {attachment} on group {group} post {post}, thread {thread}.
        slots:
          attachment: path.attachment-id
          group: path.group-id
          post: path.post-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/attachments/{attachment-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an attachment from a group thread post
      effect: destructive
      questions:
      - How do I remove an attachment someone added to a group post?
      - Can I delete one file from a post in a group conversation thread?
      instructions:
      - text: Delete attachment {attachment} from post {post} in thread {thread} of group {group}.
        slots:
          attachment: path.attachment-id
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Remove file {attachment} from group {group} post {post} in thread {thread}.
        slots:
          attachment: path.attachment-id
          group: path.group-id
          post: path.post-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/attachments/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count attachments on a group thread post
      effect: read
      questions:
      - How many attachments are on a given post in a group thread?
      - Is there a quick way to count the files attached to a group post without listing them?
      instructions:
      - text: Count the attachments on post {post} in thread {thread} of group {group}.
        slots:
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Tell me how many files are attached to group {group} post {post} in thread {thread}.
        slots:
          group: path.group-id
          post: path.post-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/attachments/microsoft.graph.createUploadSession'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an upload session for a large post attachment
      effect: write
      questions:
      - How do I attach a large file to a group post by uploading it in chunks?
      - Can I upload an attachment to a group thread post in byte ranges?
      instructions:
      - text: Create an upload session to attach {attachment_item} to post {post} in thread {thread} of group {group}.
        slots:
          attachment_item: requestBody.AttachmentItem
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Start a chunked upload for a big file on group {group} post {post}, thread {thread}.
        slots:
          group: path.group-id
          post: path.post-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/extensions'].get
  update:
    x-apievangelist-phrasing:
      intent: List open extensions on a group thread post
      effect: read
      questions:
      - How do I see the custom open extension data stored on a group post?
      - Which open extensions have been added to a particular thread post?
      instructions:
      - text: List the open extensions on post {post} in thread {thread} of group {group}.
        slots:
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Show all custom extension data on group {group} post {post} in thread {thread}.
        slots:
          group: path.group-id
          post: path.post-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/extensions'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an open extension to a group thread post
      effect: write
      questions:
      - How do I store my own custom properties on a post in a group thread?
      - Can I attach an open extension to a group post?
      instructions:
      - text: Add an open extension with id {extension} to post {post} in thread {thread} of group {group}.
        slots:
          extension: requestBody.id
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Create custom extension data on group {group} post {post}, thread {thread}.
        slots:
          group: path.group-id
          post: path.post-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/extensions/{extension-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one open extension on a group thread post
      effect: read
      questions:
      - How do I read a single open extension on a group post by its name?
      - Can I fetch one specific custom extension from a thread post?
      instructions:
      - text: Get open extension {extension} on post {post} in thread {thread} of group {group}.
        slots:
          extension: path.extension-id
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Read the custom data in extension {extension} on group {group} post {post}, thread {thread}.
        slots:
          extension: path.extension-id
          group: path.group-id
          post: path.post-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/extensions/{extension-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an open extension from a group thread post
      effect: destructive
      questions:
      - How do I remove an open extension I added to a group post?
      - Can I delete custom extension data from a thread post?
      instructions:
      - text: Delete open extension {extension} from post {post} in thread {thread} of group {group}.
        slots:
          extension: path.extension-id
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Remove extension {extension} from group {group} post {post} in thread {thread}.
        slots:
          extension: path.extension-id
          group: path.group-id
          post: path.post-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/extensions/{extension-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an open extension on a group thread post
      effect: write
      questions:
      - How do I change the custom properties in an open extension on a group post?
      - What happens to existing values when I update an open extension on a thread post?
      instructions:
      - text: Update open extension {extension} on post {post} in thread {thread} of group {group}.
        slots:
          extension: path.extension-id
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Change the custom data in extension {extension} on group {group} post {post}, thread {thread}.
        slots:
          extension: path.extension-id
          group: path.group-id
          post: path.post-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/extensions/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count open extensions on a group thread post
      effect: read
      questions:
      - How many open extensions are stored on a given group post?
      - Can I get just the number of custom extensions on a thread post?
      instructions:
      - text: Count the open extensions on post {post} in thread {thread} of group {group}.
        slots:
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Tell me how many extensions group {group} post {post} in thread {thread} carries.
        slots:
          group: path.group-id
          post: path.post-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the post a group post replied to
      effect: read
      questions:
      - How do I find the earlier post that a given group post was replying to?
      - Can I see the parent message of a reply in a group thread?
      instructions:
      - text: Get the post that {post} replied to in thread {thread} of group {group}.
        slots:
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Show the parent message of reply {post} in group {group}, thread {thread}.
        slots:
          post: path.post-id
          group: path.group-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/attachments'].get
  update:
    x-apievangelist-phrasing:
      intent: List attachments on the post a reply answered
      effect: read
      questions:
      - How do I see the files attached to the original post that a reply was responding to?
      - Which attachments were on the parent post of a group reply?
      instructions:
      - text: List the attachments on the parent post that {post} replied to in thread {thread} of group {group}.
        slots:
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Show files on the in-reply-to post of {post} in group {group}, thread {thread}.
        slots:
          post: path.post-id
          group: path.group-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/attachments'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an attachment to the post a reply answered
      effect: write
      questions:
      - How do I add a file to the original post that a group reply was answering?
      - Can I attach something to the parent post of a reply in a group thread?
      instructions:
      - text: Attach a file named {name} to the parent post that {post} replied to in thread {thread} of group {group}.
        slots:
          name: requestBody.name
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Add an attachment to the in-reply-to post of {post} in group {group}, thread {thread}.
        slots:
          post: path.post-id
          group: path.group-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/attachments/{attachment-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one attachment on the post a reply answered
      effect: read
      questions:
      - How do I read one specific attachment on the parent post of a group reply?
      - Can I look up a single file on the post a reply was responding to?
      instructions:
      - text: Get attachment {attachment} on the parent post that {post} replied to in thread {thread} of group {group}.
        slots:
          attachment: path.attachment-id
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Show attachment {attachment} of the in-reply-to post of {post} in group {group}, thread {thread}.
        slots:
          attachment: path.attachment-id
          post: path.post-id
          group: path.group-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/attachments/{attachment-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an attachment on the post a reply answered
      effect: destructive
      questions:
      - How do I remove a file from the original post a group reply was answering?
      - Can I delete an attachment on the parent post of a reply?
      instructions:
      - text: Delete attachment {attachment} from the parent post that {post} replied to in thread {thread} of group {group}.
        slots:
          attachment: path.attachment-id
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Remove file {attachment} from the in-reply-to post of {post} in group {group}, thread {thread}.
        slots:
          attachment: path.attachment-id
          post: path.post-id
          group: path.group-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/attachments/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count attachments on the post a reply answered
      effect: read
      questions:
      - How many attachments does the parent post of a group reply have?
      - Can I count the files on the post that a reply was responding to?
      instructions:
      - text: Give me only the attachment count for the post that reply {post} answered (group {group}, thread {thread}).
        slots:
          post: path.post-id
          group: path.group-id
          thread: path.conversationThread-id
      - text: Tell me how many files the in-reply-to post of {post} has in group {group}, thread {thread}.
        slots:
          post: path.post-id
          group: path.group-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/attachments/microsoft.graph.createUploadSession'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a large attachment to a reply's parent post
      effect: write
      questions:
      - How do I upload a big file in chunks to the post that a group reply answered?
      - Can I start an upload session for the parent post of a reply?
      instructions:
      - text: Create an upload session to attach {attachment_item} to the parent post that {post} replied to in thread {thread} of group {group}.
        slots:
          attachment_item: requestBody.AttachmentItem
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Start a chunked upload on the in-reply-to post of {post} in group {group}, thread {thread}.
        slots:
          post: path.post-id
          group: path.group-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/extensions'].get
  update:
    x-apievangelist-phrasing:
      intent: List open extensions on the post a reply answered
      effect: read
      questions:
      - How do I see custom extension data on the original post a group reply was answering?
      - Which open extensions exist on the parent post of a reply?
      instructions:
      - text: List the open extensions on the parent post that {post} replied to in thread {thread} of group {group}.
        slots:
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Show extensions on the in-reply-to post of {post} in group {group}, thread {thread}.
        slots:
          post: path.post-id
          group: path.group-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/extensions'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an open extension to a reply's parent post
      effect: write
      questions:
      - How do I store custom properties on the post that a group reply was answering?
      - Can I create an open extension on the parent post of a reply?
      instructions:
      - text: Add open extension {extension} to the parent post that {post} replied to in thread {thread} of group {group}.
        slots:
          extension: requestBody.id
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Create custom extension data on the in-reply-to post of {post} in group {group}, thread {thread}.
        slots:
          post: path.post-id
          group: path.group-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/extensions/{extension-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one open extension on a reply's parent post
      effect: read
      questions:
      - How do I read one named open extension on the parent post of a group reply?
      - Can I fetch a single custom extension from the post a reply answered?
      instructions:
      - text: Get open extension {extension} on the parent post that {post} replied to in thread {thread} of group {group}.
        slots:
          extension: path.extension-id
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Read extension {extension} of the in-reply-to post of {post} in group {group}, thread {thread}.
        slots:
          extension: path.extension-id
          post: path.post-id
          group: path.group-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/extensions/{extension-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an open extension on a reply's parent post
      effect: destructive
      questions:
      - How do I remove custom extension data from the post a group reply answered?
      - Is it possible to wipe an open extension off the parent post of a reply?
      instructions:
      - text: Delete open extension {extension} from the parent post that {post} replied to in thread {thread} of group {group}.
        slots:
          extension: path.extension-id
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
      - text: Remove extension {extension} from the in-reply-to post of {post} in group {group}, thread {thread}.
        slots:
          extension: path.extension-id
          post: path.post-id
          group: path.group-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/extensions/{extension-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an open extension on a reply's parent post
      effect: write
      questions:
      - How do I change custom extension values on the post a group reply was answering?
      - Can I overwrite values in an existing open extension on a reply's parent post?
      instructions:
      - text: Patch the values of open extension {extension} on the post that reply {post} answered in group {group}, thread {thread}.
        slots:
          extension: path.extension-id
          post: path.post-id
          group: path.group-id
          thread: path.conversationThread-id
      - text: Change extension {extension} on the in-reply-to post of {post} in group {group}, thread {thread}.
        slots:
          extension: path.extension-id
          post: path.post-id
          group: path.group-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/extensions/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count open extensions on a reply's parent post
      effect: read
      questions:
      - How many open extensions are on the post a group reply was answering?
      - Can I count the custom extensions on the parent post of a reply?
      instructions:
      - text: Tally the open extensions on the original message that reply {post} responds to in group {group}, thread {thread}.
        slots:
          post: path.post-id
          group: path.group-id
          thread: path.conversationThread-id
      - text: Tell me how many extensions the in-reply-to post of {post} carries in group {group}, thread {thread}.
        slots:
          post: path.post-id
          group: path.group-id
          thread: path.conversationThread-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/microsoft.graph.forward'].post
  update:
    x-apievangelist-phrasing:
      intent: Forward the post a reply answered
      effect: write
      questions:
      - How do I forward the original post that a group reply was responding to?
      - Can I send the parent post of a reply on to someone outside the thread with a comment?
      instructions:
      - text: Forward the parent post that {post} replied to in thread {thread} of group {group} to {recipients}.
        slots:
          post: path.post-id
          thread: path.conversationThread-id
          group: path.group-id
          recipients: requestBody.ToRecipients
      - text: Forward the in-reply-to post of {post} in group {group}, thread {thread} with the comment {comment}.
        slots:
          post: path.post-id
          group: path.group-id
          thread: path.conversationThread-id
          comment: requestBody.Comment
      method: generated
      generated: '2026-10-01'


# --- truncated at 32 KB (35 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/overlays/azure-ad-groups-conversationthread-api-phrasing-overlay.yaml