Microsoft Entra ID (formerly Azure AD) · OpenAPI Overlay 1.0.0
API Evangelist conversational phrasing for Groups.conversation API
45 actions
45 updates
phrasing
extends
openapi/azure-ad-groups-conversation-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.
What the actions change
x-apievangelist-phrasing
Targets 45 · first 16 shown; the file carries all of them
$.info
$.paths['/groups/{group-id}/conversations'].get
$.paths['/groups/{group-id}/conversations'].post
$.paths['/groups/{group-id}/conversations/{conversation-id}'].get
$.paths['/groups/{group-id}/conversations/{conversation-id}'].delete
$.paths['/groups/{group-id}/conversations/{conversation-id}/threads'].get
$.paths['/groups/{group-id}/conversations/{conversation-id}/threads'].post
$.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}'].get
$.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}'].delete
$.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}'].patch
$.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/microsoft.graph.reply'].post
$.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts'].get
$.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}'].get
$.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/attachments'].get
$.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/attachments'].post
$.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/attachments/{attachment-id}'].get
OpenAPI Overlay
# 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 API
version: 1.0.0
extends: openapi/azure-ad-groups-conversation-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: 44
- target: $.paths['/groups/{group-id}/conversations'].get
update:
x-apievangelist-phrasing:
intent: List a group's conversations
effect: read
questions:
- How do I see every conversation in a Microsoft 365 group's inbox?
- Can I pull the list of discussion topics a group has had?
instructions:
- text: List all conversations in group {group}.
slots:
group: path.group-id
- text: Show me the conversation topics in the {group} group.
slots:
group: path.group-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations'].post
update:
x-apievangelist-phrasing:
intent: Start a new conversation in a group
effect: write
questions:
- Can I start a brand-new discussion in a group with its own topic?
- What do I send to open a new conversation in a Microsoft 365 group?
instructions:
- text: Start a new conversation in group {group} with topic {topic}.
slots:
group: path.group-id
topic: requestBody.topic
- text: Open a fresh group conversation in {group} with its first threads.
slots:
group: path.group-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}'].get
update:
x-apievangelist-phrasing:
intent: Get one group conversation
effect: read
questions:
- Where can I read the topic, preview and senders of a single group conversation?
- Can I fetch the details of one specific conversation in a group?
instructions:
- text: Get conversation {conversation} in group {group}.
slots:
conversation: path.conversation-id
group: path.group-id
- text: Show the topic and unique senders of conversation {conversation} in {group}.
slots:
conversation: path.conversation-id
group: path.group-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}'].delete
update:
x-apievangelist-phrasing:
intent: Delete a group conversation
effect: destructive
questions:
- Can I remove an entire conversation from a group, threads and all?
- Is deleting a group conversation permanent?
instructions:
- text: Delete conversation {conversation} from group {group}.
slots:
conversation: path.conversation-id
group: path.group-id
- text: Remove the whole {conversation} discussion from the {group} group.
slots:
conversation: path.conversation-id
group: path.group-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads'].get
update:
x-apievangelist-phrasing:
intent: List threads in a group conversation
effect: read
questions:
- Which threads make up a particular group conversation?
- How do I get all the reply threads inside one group conversation?
instructions:
- text: List the threads in conversation {conversation} of group {group}.
slots:
conversation: path.conversation-id
group: path.group-id
- text: Show every thread under group conversation {conversation}.
slots:
conversation: path.conversation-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads'].post
update:
x-apievangelist-phrasing:
intent: Create a thread in a group conversation
effect: write
questions:
- Can I add a new thread with its first post to an existing group conversation?
- What recipients and topic can I set when creating a conversation thread?
instructions:
- text: Create a new thread with topic {topic} in conversation {conversation} of group {group}.
slots:
topic: requestBody.topic
conversation: path.conversation-id
group: path.group-id
- text: Add a thread to group conversation {conversation} addressed to {recipients}.
slots:
conversation: path.conversation-id
recipients: requestBody.toRecipients
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}'].get
update:
x-apievangelist-phrasing:
intent: Get one thread from a group conversation
effect: read
questions:
- Can I look up a single conversation thread to see if it's locked and who it went to?
- Where do I read the details of one thread in a group conversation?
instructions:
- text: Get thread {thread} in conversation {conversation} of group {group}.
slots:
thread: path.conversationThread-id
conversation: path.conversation-id
group: path.group-id
- text: Tell me whether group thread {thread} is locked.
slots:
thread: path.conversationThread-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}'].delete
update:
x-apievangelist-phrasing:
intent: Delete a thread from a group conversation
effect: destructive
questions:
- Can I delete just one thread without removing the whole group conversation?
- What happens to the posts when I delete a conversation thread?
instructions:
- text: Delete thread {thread} from conversation {conversation} in group {group}.
slots:
thread: path.conversationThread-id
conversation: path.conversation-id
group: path.group-id
- text: Remove the {thread} thread from its group conversation.
slots:
thread: path.conversationThread-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}'].patch
update:
x-apievangelist-phrasing:
intent: Update a group conversation thread
effect: write
questions:
- Can I lock a conversation thread so nobody can reply to it?
- Is it possible to change the topic or recipients of an existing group thread?
instructions:
- text: Lock thread {thread} in conversation {conversation} of group {group}.
slots:
thread: path.conversationThread-id
conversation: path.conversation-id
group: path.group-id
- text: Change the topic of group thread {thread} to {topic}.
slots:
thread: path.conversationThread-id
topic: requestBody.topic
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-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 thread in a group conversation rather than a specific post?
- Can I post a new reply into an existing group thread?
instructions:
- text: Reply to thread {thread} in conversation {conversation} of group {group} with {post}.
slots:
thread: path.conversationThread-id
conversation: path.conversation-id
group: path.group-id
post: requestBody.Post
- text: Post a reply on group thread {thread}.
slots:
thread: path.conversationThread-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts'].get
update:
x-apievangelist-phrasing:
intent: List posts in a group thread
effect: read
questions:
- Which posts have been made in a particular group conversation thread?
- Can I read every message posted to one group thread?
instructions:
- text: List the posts in thread {thread} of conversation {conversation} in group {group}.
slots:
thread: path.conversationThread-id
conversation: path.conversation-id
group: path.group-id
- text: Show all messages posted in group thread {thread}.
slots:
thread: path.conversationThread-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}'].get
update:
x-apievangelist-phrasing:
intent: Get one post from a group thread
effect: read
questions:
- Can I fetch a single post by its ID from a group conversation thread?
- Where do I read the body and sender of one specific group post?
instructions:
- text: Fetch the single message {post} from group thread {thread} (conversation {conversation}, group {group}).
slots:
post: path.post-id
thread: path.conversationThread-id
conversation: path.conversation-id
group: path.group-id
- text: Open group post {post} and show me its content.
slots:
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/attachments'].get
update:
x-apievangelist-phrasing:
intent: List attachments on a group post
effect: read
questions:
- What files are attached to a particular post in a group thread?
- Can I list the attachments someone added to a group conversation post?
instructions:
- text: List the attachments on post {post} in thread {thread}, conversation {conversation}, group {group}.
slots:
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Show the files attached to group post {post} in conversation {conversation}.
slots:
post: path.post-id
conversation: path.conversation-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/attachments'].post
update:
x-apievangelist-phrasing:
intent: Add an attachment to a group post
effect: write
questions:
- Can I attach a small file directly to a post in a group thread?
- What name and content type do I give when adding an attachment to a group post?
instructions:
- text: Attach a file named {name} to post {post} in thread {thread}, conversation {conversation}, group {group}.
slots:
name: requestBody.name
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Add an inline {content_type} attachment to group post {post}.
slots:
content_type: requestBody.contentType
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/attachments/{attachment-id}'].get
update:
x-apievangelist-phrasing:
intent: Get one attachment from a group post
effect: read
questions:
- Can I retrieve a single attachment from a group conversation post?
- Where do I see the size and content type of one attachment on a group post?
instructions:
- text: Get attachment {attachment} on post {post} in thread {thread}, conversation {conversation}, group {group}.
slots:
attachment: path.attachment-id
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Show the details of attachment {attachment} on group post {post}.
slots:
attachment: path.attachment-id
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/attachments/{attachment-id}'].delete
update:
x-apievangelist-phrasing:
intent: Remove an attachment from a group post
effect: destructive
questions:
- Can I delete a file that was attached to a group conversation post?
- Is removing an attachment from a group post reversible?
instructions:
- text: Delete attachment {attachment} from post {post} in thread {thread}, conversation {conversation}, group {group}.
slots:
attachment: path.attachment-id
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Remove attachment {attachment} from group post {post}.
slots:
attachment: path.attachment-id
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/attachments/$count'].get
update:
x-apievangelist-phrasing:
intent: Count attachments on a group post
effect: read
questions:
- How many attachments does a given group post have?
- Can I get just the number of files on a group post without downloading them?
instructions:
- text: Count the attachments on post {post} in thread {thread}, conversation {conversation}, group {group}.
slots:
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Tell me how many files are attached to group post {post}.
slots:
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/attachments/microsoft.graph.createUploadSession'].post
update:
x-apievangelist-phrasing:
intent: Start a large-file upload to a group post
effect: write
questions:
- How do I attach a large file to a group post by uploading it in chunks?
- Can I get an upload session URL to iteratively upload a big attachment to a group post?
instructions:
- text: Create an upload session to attach {attachment_item} to post {post} in thread {thread}, conversation {conversation}, group {group}.
slots:
attachment_item: requestBody.AttachmentItem
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Start a chunked upload for a large file on group post {post}.
slots:
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/extensions'].get
update:
x-apievangelist-phrasing:
intent: List open extensions on a group post
effect: read
questions:
- What custom open extensions are stored on a group conversation post?
- Can I see the custom data my app attached to a group post?
instructions:
- text: List the open extensions on post {post} in thread {thread}, conversation {conversation}, group {group}.
slots:
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Show all custom extensions defined on group post {post}.
slots:
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/extensions'].post
update:
x-apievangelist-phrasing:
intent: Add an open extension to a group post
effect: write
questions:
- Can I store custom app data on a group post as an open extension?
- What does it take to create a new extension on a group conversation post?
instructions:
- text: Create an open extension with id {extension_name} on post {post} in thread {thread}, conversation {conversation}, group {group}.
slots:
extension_name: requestBody.id
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Add custom extension data to group post {post}.
slots:
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/extensions/{extension-id}'].get
update:
x-apievangelist-phrasing:
intent: Get one open extension on a group post
effect: read
questions:
- Can I read back a specific open extension stored on a group post?
- Where do I fetch one named extension from a group conversation post?
instructions:
- text: Get extension {extension} on post {post} in thread {thread}, conversation {conversation}, group {group}.
slots:
extension: path.extension-id
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Show the custom data in extension {extension} on group post {post}.
slots:
extension: path.extension-id
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/extensions/{extension-id}'].delete
update:
x-apievangelist-phrasing:
intent: Delete an open extension from a group post
effect: destructive
questions:
- Can I remove my app's custom extension from a group post?
- What happens to the custom data when I delete an extension on a group post?
instructions:
- text: Delete extension {extension} from post {post} in thread {thread}, conversation {conversation}, group {group}.
slots:
extension: path.extension-id
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Remove custom extension {extension} from group post {post}.
slots:
extension: path.extension-id
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/extensions/{extension-id}'].patch
update:
x-apievangelist-phrasing:
intent: Update an open extension on a group post
effect: write
questions:
- Can I change the custom data held in an existing extension on a group post?
- Is it possible to patch an open extension on a group conversation post?
instructions:
- text: Update extension {extension} on post {post} in thread {thread}, conversation {conversation}, group {group}.
slots:
extension: path.extension-id
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Patch the custom values in extension {extension} on group post {post}.
slots:
extension: path.extension-id
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/extensions/$count'].get
update:
x-apievangelist-phrasing:
intent: Count open extensions on a group post
effect: read
questions:
- How many open extensions are defined on a group post?
- Can I get a count of custom extensions on a group conversation post?
instructions:
- text: Count the extensions on post {post} in thread {thread}, conversation {conversation}, group {group}.
slots:
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Tell me the number of custom extensions on group post {post}.
slots:
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo'].get
update:
x-apievangelist-phrasing:
intent: Get the post a group post replies to
effect: read
questions:
- Which earlier post was a given group post replying to?
- Can I trace a group post back to the message it answered?
instructions:
- text: Get the post that post {post} in thread {thread}, conversation {conversation}, group {group} replies to.
slots:
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Show the parent message that group post {post} answered.
slots:
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/attachments'].get
update:
x-apievangelist-phrasing:
intent: List attachments on the replied-to group post
effect: read
questions:
- What files were attached to the original post that a group reply responded to?
- Can I list the parent post's attachments starting from a reply in a group thread?
instructions:
- text: List the attachments on the post that {post} replies to in thread {thread}, conversation {conversation}, group {group}.
slots:
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Show the files on the parent message of group reply {post}.
slots:
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/attachments'].post
update:
x-apievangelist-phrasing:
intent: Add an attachment to the replied-to group post
effect: write
questions:
- Can I attach a file to the parent post that a group reply answers?
- Is it possible to add an attachment to the in-reply-to post through a reply?
instructions:
- text: Attach {name} to the post that {post} replies to in thread {thread}, conversation {conversation}, group {group}.
slots:
name: requestBody.name
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Add an attachment to the parent message of group reply {post}.
slots:
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/attachments/{attachment-id}'].get
update:
x-apievangelist-phrasing:
intent: Get an attachment on the replied-to group post
effect: read
questions:
- Can I fetch one attachment from the original post a group reply answered?
- Where do I read a parent post's attachment when all I have is the reply?
instructions:
- text: Get attachment {attachment} on the post that {post} replies to in thread {thread}, conversation {conversation}, group {group}.
slots:
attachment: path.attachment-id
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Show attachment {attachment} on the parent message of group reply {post}.
slots:
attachment: path.attachment-id
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/attachments/{attachment-id}'].delete
update:
x-apievangelist-phrasing:
intent: Remove an attachment from the replied-to post
effect: destructive
questions:
- Can I delete a file from the original post that a group reply answered?
- Is it possible to strip an attachment off a parent post via its reply?
instructions:
- text: Delete attachment {attachment} from the post that {post} replies to in thread {thread}, conversation {conversation}, group {group}.
slots:
attachment: path.attachment-id
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Remove attachment {attachment} from the parent message of group reply {post}.
slots:
attachment: path.attachment-id
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/attachments/$count'].get
update:
x-apievangelist-phrasing:
intent: Count attachments on the replied-to group post
effect: read
questions:
- How many attachments did the original post behind a group reply carry?
- Can I count the parent post's files from a reply in a group thread?
instructions:
- text: Count the attachments on the post that {post} replies to in thread {thread}, conversation {conversation}, group {group}.
slots:
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Tell me how many files are on the parent message of group reply {post}.
slots:
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/attachments/microsoft.graph.createUploadSession'].post
update:
x-apievangelist-phrasing:
intent: Start a large upload to the replied-to post
effect: write
questions:
- Can I upload a large file in chunks to the parent post a group reply answered?
- How would I get an upload session for the in-reply-to post of a group message?
instructions:
- text: Create an upload session for {attachment_item} on the post that {post} replies to in thread {thread}, conversation {conversation}, group {group}.
slots:
attachment_item: requestBody.AttachmentItem
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Start a chunked upload to the parent message of group reply {post}.
slots:
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/extensions'].get
update:
x-apievangelist-phrasing:
intent: List extensions on the replied-to group post
effect: read
questions:
- What open extensions are on the original post a group reply answered?
- Can I read the parent post's custom extensions starting from its reply?
instructions:
- text: List the extensions on the post that {post} replies to in thread {thread}, conversation {conversation}, group {group}.
slots:
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Show custom extensions on the parent message of group reply {post}.
slots:
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/extensions'].post
update:
x-apievangelist-phrasing:
intent: Add an extension to the replied-to group post
effect: write
questions:
- Can I store custom data on the parent post that a group reply answered?
- Is there a way to create an open extension on the in-reply-to post?
instructions:
- text: Create extension {extension_name} on the post that {post} replies to in thread {thread}, conversation {conversation}, group {group}.
slots:
extension_name: requestBody.id
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Add custom extension data to the parent message of group reply {post}.
slots:
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/extensions/{extension-id}'].get
update:
x-apievangelist-phrasing:
intent: Get an extension on the replied-to group post
effect: read
questions:
- Can I read one open extension on the original post behind a group reply?
- Where do I fetch a named extension from a reply's parent post?
instructions:
- text: Get extension {extension} on the post that {post} replies to in thread {thread}, conversation {conversation}, group {group}.
slots:
extension: path.extension-id
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Show extension {extension} on the parent message of group reply {post}.
slots:
extension: path.extension-id
post: path.post-id
method: generated
generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/conversations/{conversation-id}/threads/{conversationThread-id}/posts/{post-id}/inReplyTo/extensions/{extension-id}'].delete
update:
x-apievangelist-phrasing:
intent: Delete an extension from the replied-to post
effect: destructive
questions:
- Can I remove a custom extension from the parent post of a group reply?
- Is deleting an extension on the in-reply-to post permanent?
instructions:
- text: Delete extension {extension} from the post that {post} replies to in thread {thread}, conversation {conversation}, group {group}.
slots:
extension: path.extension-id
post: path.post-id
thread: path.conversationThread-id
group: path.group-id
conversation: path.conversation-id
- text: Remove extension {extension} from the parent message of group reply {post}.
slots:
extension: path.extension-id
post: path.post-id
method: generated
generated: '2026-10-01'
# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/overlays/azure-ad-groups-conversation-api-phrasing-overlay.yaml