From 8ffe8ed1d8c208229e090c03e0aad5484cd52f24 Mon Sep 17 00:00:00 2001 From: Vincent Biret Date: Thu, 28 Nov 2024 09:26:14 -0500 Subject: [PATCH 1/6] docs: fixes copilot plugin refresh commands Signed-off-by: Vincent Biret --- .../Resources/Plugins/CopilotAgentPlugins/README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/README.md b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/README.md index 693a71349a77..de372e47b7f7 100644 --- a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/README.md +++ b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/README.md @@ -13,7 +13,7 @@ cd dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins Microsoft Graph calendar events listing API for the current user. ```shell -kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /me/calendar/events#GET -o CopilotAgentPlugins/CalendarPlugin +kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /me/calendar/events#GET -o CopilotAgentPlugins/CalendarPlugin --pn Calendar ``` ### Contacts plugin @@ -21,7 +21,7 @@ kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /me/c Microsoft Graph contacts listing API for the current user. ```shell -kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /me/contacts#GET -o CopilotAgentPlugins/ContactsPlugin +kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /me/contacts#GET -o CopilotAgentPlugins/ContactsPlugin --pn Contacts ``` ### DriveItem plugin @@ -29,7 +29,7 @@ kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /me/c Microsoft Graph download a drive item for the current user. ```shell -kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /drive/root/children/{driveItem-id}/content#GET -o CopilotAgentPlugins/DriveItemPlugin +kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /drive/root/children/{driveItem-id}/content#GET -o CopilotAgentPlugins/DriveItemPlugin --pn DriveItem ``` ### Messages plugin @@ -37,7 +37,7 @@ kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /driv Microsoft Graph list message and create a draft message for the current user. ```shell -kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /me/messages#GET -i /me/messages#POST -o CopilotAgentPlugins/MessagesPlugin +kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /me/messages#GET -i /me/messages#POST -o CopilotAgentPlugins/MessagesPlugin --pn Messages ``` ### Astronomy plugin @@ -45,7 +45,7 @@ kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /me/m NASA Astronomy Picture of the day endpoint mixed with Microsoft Graph messages to demonstrate a plugin with multiple APIs. ```shell -kiota plugin add -t APIPlugin -d ../OpenAPI/NASA/apod.yaml -i /apod#GET -o CopilotAgentPlugins/AstronomyPlugin +kiota plugin add -t APIPlugin -d ../OpenAPI/NASA/apod.yaml -i /apod#GET -o CopilotAgentPlugins/AstronomyPlugin --pn Astronomy cp CopilotAgentPlugins/MessagesPlugin/messages-openapi.yml CopilotAgentPlugins/AstronomyPlugin ``` From 0e86c162efdb295b5053fa2f41e95731829ca170 Mon Sep 17 00:00:00 2001 From: Vincent Biret Date: Thu, 28 Nov 2024 10:08:03 -0500 Subject: [PATCH 2/6] chore: adds kiota workspace files to gitignore configuration to prevent accidental commits Signed-off-by: Vincent Biret --- .gitignore | 3 +++ 1 file changed, 3 insertions(+) diff --git a/.gitignore b/.gitignore index 3912623b85f8..cb94519c73a1 100644 --- a/.gitignore +++ b/.gitignore @@ -494,3 +494,6 @@ swa-cli.config.json # python devcontainer /python/.devcontainer/* + +# kiota workspace files +**/.kiota \ No newline at end of file From 71fb34c329099c938d2add4ea754634303e7323e Mon Sep 17 00:00:00 2001 From: Vincent Biret Date: Thu, 28 Nov 2024 10:17:53 -0500 Subject: [PATCH 3/6] fix: drive content path Signed-off-by: Vincent Biret --- .../DriveItemPlugin/driveitem-apiplugin.json | 6 +++--- .../Resources/Plugins/CopilotAgentPlugins/README.md | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/DriveItemPlugin/driveitem-apiplugin.json b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/DriveItemPlugin/driveitem-apiplugin.json index e421c6c2e23a..9154b421b2b4 100644 --- a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/DriveItemPlugin/driveitem-apiplugin.json +++ b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/DriveItemPlugin/driveitem-apiplugin.json @@ -9,13 +9,13 @@ "capabilities": { "conversation_starters": [ { - "text": "Get content for the navigation property children f" + "text": "Get content for the navigation property items from" } ] }, "functions": [ { - "name": "drive_root_GetChildrenContent", + "name": "drives_GetItemsContent", "description": "The content stream, if the item represents a file." } ], @@ -29,7 +29,7 @@ "url": "driveitem-openapi.yml" }, "run_for_functions": [ - "drive_root_GetChildrenContent" + "drives_GetItemsContent" ] } ] diff --git a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/README.md b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/README.md index de372e47b7f7..2dc42b1c360e 100644 --- a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/README.md +++ b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/README.md @@ -29,7 +29,7 @@ kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /me/c Microsoft Graph download a drive item for the current user. ```shell -kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /drive/root/children/{driveItem-id}/content#GET -o CopilotAgentPlugins/DriveItemPlugin --pn DriveItem +kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /drives/{drive-id}/items/{driveItem-id}/content#GET -o CopilotAgentPlugins/DriveItemPlugin --pn DriveItem ``` ### Messages plugin From 1eecf0c59fab1b60b0c25423ee6289e1cbb45ea0 Mon Sep 17 00:00:00 2001 From: Vincent Biret Date: Thu, 28 Nov 2024 10:24:33 -0500 Subject: [PATCH 4/6] fix: astronomy plugin definition Signed-off-by: Vincent Biret --- .../AstronomyPlugin/astronomy-apiplugin.json | 2 +- .../Resources/Plugins/CopilotAgentPlugins/README.md | 8 ++++---- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/AstronomyPlugin/astronomy-apiplugin.json b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/AstronomyPlugin/astronomy-apiplugin.json index 1d4eb5049091..dd0d1121335b 100644 --- a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/AstronomyPlugin/astronomy-apiplugin.json +++ b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/AstronomyPlugin/astronomy-apiplugin.json @@ -20,7 +20,7 @@ }, { "name": "me_ListMessages", - "description": "Get an open extension (openTypeExtension object) identified by name or fully qualified name. The table in the Permissions section lists the resources that support open extensions. The following table lists the three scenarios where you can get an open extension from a supported resource instance." + "description": "Get the messages in the signed-in user\u0026apos;s mailbox (including the Deleted Items and Clutter folders). Depending on the page size and mailbox data, getting messages from a mailbox can incur multiple requests. The default page size is 10 messages. Use $top to customize the page size, within the range of 1 and 1000. To improve the operation response time, use $select to specify the exact properties you need; see example 1 below. Fine-tune the values for $select and $top, especially when you must use a larger page size, as returning a page with hundreds of messages each with a full response payload may trigger the gateway timeout (HTTP 504). To get the next page of messages, simply apply the entire URL returned in @odata.nextLink to the next get-messages request. This URL includes any query parameters you may have specified in the initial request. Do not try to extract the $skip value from the @odata.nextLink URL to manipulate responses. This API uses the $skip value to keep count of all the items it has gone through in the user\u0026apos;s mailbox to return a page of message-type items. It\u0026apos;s therefore possible that even in the initial response, the $skip value is larger than the page size. For more information, see Paging Microsoft Graph data in your app. Currently, this operation returns message bodies in only HTML format. There are two scenarios where an app can get messages in another user\u0026apos;s mail folder:" } ], "runtimes": [ diff --git a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/README.md b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/README.md index 2dc42b1c360e..b5642696db64 100644 --- a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/README.md +++ b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/README.md @@ -45,7 +45,7 @@ kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /me/m NASA Astronomy Picture of the day endpoint mixed with Microsoft Graph messages to demonstrate a plugin with multiple APIs. ```shell -kiota plugin add -t APIPlugin -d ../OpenAPI/NASA/apod.yaml -i /apod#GET -o CopilotAgentPlugins/AstronomyPlugin --pn Astronomy +kiota plugin add -t APIPlugin -d ./OpenAPI/NASA/apod.yaml -i /apod#GET -o CopilotAgentPlugins/AstronomyPlugin --pn Astronomy cp CopilotAgentPlugins/MessagesPlugin/messages-openapi.yml CopilotAgentPlugins/AstronomyPlugin ``` @@ -55,10 +55,10 @@ Add this snippet under runtimes { "type": "OpenApi", "auth": { - "type": "None" + "type": "None" }, "spec": { - "url": "messages-openapi.yml" + "url": "messages-openapi.yml" }, "run_for_functions": ["me_ListMessages"] } @@ -69,6 +69,6 @@ And this snippet under functions ```json { "name": "me_ListMessages", - "description": "Get an open extension (openTypeExtension object) identified by name or fully qualified name. The table in the Permissions section lists the resources that support open extensions. The following table lists the three scenarios where you can get an open extension from a supported resource instance." + "description": "Get the messages in the signed-in user\u0026apos;s mailbox (including the Deleted Items and Clutter folders). Depending on the page size and mailbox data, getting messages from a mailbox can incur multiple requests. The default page size is 10 messages. Use $top to customize the page size, within the range of 1 and 1000. To improve the operation response time, use $select to specify the exact properties you need; see example 1 below. Fine-tune the values for $select and $top, especially when you must use a larger page size, as returning a page with hundreds of messages each with a full response payload may trigger the gateway timeout (HTTP 504). To get the next page of messages, simply apply the entire URL returned in @odata.nextLink to the next get-messages request. This URL includes any query parameters you may have specified in the initial request. Do not try to extract the $skip value from the @odata.nextLink URL to manipulate responses. This API uses the $skip value to keep count of all the items it has gone through in the user\u0026apos;s mailbox to return a page of message-type items. It\u0026apos;s therefore possible that even in the initial response, the $skip value is larger than the page size. For more information, see Paging Microsoft Graph data in your app. Currently, this operation returns message bodies in only HTML format. There are two scenarios where an app can get messages in another user\u0026apos;s mail folder:" } ``` From 8f6276072ed87e009c4f689f0a568d4ec92d890a Mon Sep 17 00:00:00 2001 From: Vincent Biret Date: Thu, 28 Nov 2024 10:24:46 -0500 Subject: [PATCH 5/6] chore: updates all CAPs descriptions Signed-off-by: Vincent Biret --- .../AstronomyPlugin/astronomy-openapi.yml | 2 - .../AstronomyPlugin/messages-openapi.yml | 732 ++++------ .../CalendarPlugin/calendar-openapi.yml | 1203 ++++++----------- .../ContactsPlugin/contacts-openapi.yml | 656 ++++----- .../DriveItemPlugin/driveitem-openapi.yml | 83 +- .../MessagesPlugin/messages-apiplugin.json | 8 +- .../MessagesPlugin/messages-openapi.yml | 732 ++++------ 7 files changed, 1212 insertions(+), 2204 deletions(-) diff --git a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/AstronomyPlugin/astronomy-openapi.yml b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/AstronomyPlugin/astronomy-openapi.yml index 3781f5a999f4..ca34201567d6 100644 --- a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/AstronomyPlugin/astronomy-openapi.yml +++ b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/AstronomyPlugin/astronomy-openapi.yml @@ -42,8 +42,6 @@ paths: schema: type: array items: { } - '400': - description: 'Date must be between Jun 16, 1995 and Mar 28, 2019.' security: - api_key: [ ] components: diff --git a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/AstronomyPlugin/messages-openapi.yml b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/AstronomyPlugin/messages-openapi.yml index f9c7b11e712b..7903450f0c53 100644 --- a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/AstronomyPlugin/messages-openapi.yml +++ b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/AstronomyPlugin/messages-openapi.yml @@ -10,11 +10,8 @@ paths: get: tags: - me.message - summary: Get open extension - description: Get an open extension (openTypeExtension object) identified by name or fully qualified name. The table in the Permissions section lists the resources that support open extensions. The following table lists the three scenarios where you can get an open extension from a supported resource instance. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/opentypeextension-get?view=graph-rest-1.0 + summary: List messages + description: 'Get the messages in the signed-in user''s mailbox (including the Deleted Items and Clutter folders). Depending on the page size and mailbox data, getting messages from a mailbox can incur multiple requests. The default page size is 10 messages. Use $top to customize the page size, within the range of 1 and 1000. To improve the operation response time, use $select to specify the exact properties you need; see example 1 below. Fine-tune the values for $select and $top, especially when you must use a larger page size, as returning a page with hundreds of messages each with a full response payload may trigger the gateway timeout (HTTP 504). To get the next page of messages, simply apply the entire URL returned in @odata.nextLink to the next get-messages request. This URL includes any query parameters you may have specified in the initial request. Do not try to extract the $skip value from the @odata.nextLink URL to manipulate responses. This API uses the $skip value to keep count of all the items it has gone through in the user''s mailbox to return a page of message-type items. It''s therefore possible that even in the initial response, the $skip value is larger than the page size. For more information, see Paging Microsoft Graph data in your app. Currently, this operation returns message bodies in only HTML format. There are two scenarios where an app can get messages in another user''s mail folder:' operationId: me_ListMessages parameters: - name: includeHiddenMessages @@ -38,69 +35,6 @@ paths: uniqueItems: true type: array items: - enum: - - id - - id desc - - categories - - categories desc - - changeKey - - changeKey desc - - createdDateTime - - createdDateTime desc - - lastModifiedDateTime - - lastModifiedDateTime desc - - bccRecipients - - bccRecipients desc - - body - - body desc - - bodyPreview - - bodyPreview desc - - ccRecipients - - ccRecipients desc - - conversationId - - conversationId desc - - conversationIndex - - conversationIndex desc - - flag - - flag desc - - from - - from desc - - hasAttachments - - hasAttachments desc - - importance - - importance desc - - inferenceClassification - - inferenceClassification desc - - internetMessageHeaders - - internetMessageHeaders desc - - internetMessageId - - internetMessageId desc - - isDeliveryReceiptRequested - - isDeliveryReceiptRequested desc - - isDraft - - isDraft desc - - isRead - - isRead desc - - isReadReceiptRequested - - isReadReceiptRequested desc - - parentFolderId - - parentFolderId desc - - receivedDateTime - - receivedDateTime desc - - replyTo - - replyTo desc - - sender - - sender desc - - sentDateTime - - sentDateTime desc - - subject - - subject desc - - toRecipients - - toRecipients desc - - uniqueBody - - uniqueBody desc - - webLink - - webLink desc type: string - name: $select in: query @@ -111,42 +45,6 @@ paths: uniqueItems: true type: array items: - enum: - - id - - categories - - changeKey - - createdDateTime - - lastModifiedDateTime - - bccRecipients - - body - - bodyPreview - - ccRecipients - - conversationId - - conversationIndex - - flag - - from - - hasAttachments - - importance - - inferenceClassification - - internetMessageHeaders - - internetMessageId - - isDeliveryReceiptRequested - - isDraft - - isRead - - isReadReceiptRequested - - parentFolderId - - receivedDateTime - - replyTo - - sender - - sentDateTime - - subject - - toRecipients - - uniqueBody - - webLink - - attachments - - extensions - - multiValueExtendedProperties - - singleValueExtendedProperties type: string - name: $expand in: query @@ -157,18 +55,10 @@ paths: uniqueItems: true type: array items: - enum: - - '*' - - attachments - - extensions - - multiValueExtendedProperties - - singleValueExtendedProperties type: string responses: - '200': + 2XX: $ref: '#/components/responses/microsoft.graph.messageCollectionResponse' - default: - $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore @@ -176,224 +66,194 @@ paths: post: tags: - me.message - summary: Create open extension - description: 'Create an open extension (openTypeExtension object) and add custom properties in a new or existing instance of a resource. You can create an open extension in a resource instance and store custom data to it all in the same operation, except for specific resources. The table in the Permissions section lists the resources that support open extensions.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/opentypeextension-post-opentypeextension?view=graph-rest-1.0 + summary: Create message + description: "Create a draft of a new message in either JSON or MIME format. When using JSON format, you can:\n- Include an attachment to the message.\n- Update the draft later to add content to the body or change other message properties. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- /* Add any attachments and S/MIME properties to the MIME content. By default, this operation saves the draft in the Drafts folder. Send the draft message in a subsequent operation. Alternatively, send a new message in a single operation, or create a draft to forward, reply and reply-all to an existing message." operationId: me_CreateMessages requestBody: description: New navigation property content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.outlookItem' + $ref: '#/components/schemas/microsoft.graph.message' required: true responses: - '201': + 2XX: description: Created navigation property. content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.message' - default: - $ref: '#/components/responses/error' components: schemas: microsoft.graph.message: - allOf: - - $ref: '#/components/schemas/microsoft.graph.outlookItem' - - title: message - type: object - properties: - bccRecipients: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.recipient' - description: 'The Bcc: recipients for the message.' - body: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.itemBody' - - type: object - nullable: true - description: The body of the message. It can be in HTML or text format. Find out about safe HTML in a message body. - bodyPreview: - type: string - description: The first 255 characters of the message body. It is in text format. - nullable: true - ccRecipients: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.recipient' - description: 'The Cc: recipients for the message.' - conversationId: - type: string - description: The ID of the conversation the email belongs to. - nullable: true - conversationIndex: - type: string - description: Indicates the position of the message within the conversation. - format: base64url - nullable: true - flag: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.followupFlag' - - type: object - nullable: true - description: 'The flag value that indicates the status, start date, due date, or completion date for the message.' - from: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.recipient' - - type: object - nullable: true - description: 'The owner of the mailbox from which the message is sent. In most cases, this value is the same as the sender property, except for sharing or delegation scenarios. The value must correspond to the actual mailbox used. Find out more about setting the from and sender properties of a message.' - hasAttachments: - type: boolean - description: 'Indicates whether the message has attachments. This property doesn''t include inline attachments, so if a message contains only inline attachments, this property is false. To verify the existence of inline attachments, parse the body property to look for a src attribute, such as .' - nullable: true - importance: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.importance' - - type: object - nullable: true - description: 'The importance of the message. The possible values are: low, normal, and high.' - inferenceClassification: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.inferenceClassificationType' - - type: object - nullable: true - description: 'The classification of the message for the user, based on inferred relevance or importance, or on an explicit override. The possible values are: focused or other.' - internetMessageHeaders: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.internetMessageHeader' - description: A collection of message headers defined by RFC5322. The set includes message headers indicating the network path taken by a message from the sender to the recipient. It can also contain custom message headers that hold app data for the message. Returned only on applying a $select query option. Read-only. - internetMessageId: - type: string - description: The message ID in the format specified by RFC2822. - nullable: true - isDeliveryReceiptRequested: - type: boolean - description: Indicates whether a read receipt is requested for the message. - nullable: true - isDraft: - type: boolean - description: Indicates whether the message is a draft. A message is a draft if it hasn't been sent yet. - nullable: true - isRead: - type: boolean - description: Indicates whether the message has been read. - nullable: true - isReadReceiptRequested: - type: boolean - description: Indicates whether a read receipt is requested for the message. - nullable: true - parentFolderId: - type: string - description: The unique identifier for the message's parent mailFolder. - nullable: true - receivedDateTime: - pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' - type: string - description: 'The date and time the message was received. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.' - format: date-time - nullable: true - replyTo: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.recipient' - description: The email addresses to use when replying. - sender: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.recipient' - - type: object - nullable: true - description: 'The account that is actually used to generate the message. In most cases, this value is the same as the from property. You can set this property to a different value when sending a message from a shared mailbox, for a shared calendar, or as a delegate. In any case, the value must correspond to the actual mailbox used. Find out more about setting the from and sender properties of a message.' - sentDateTime: - pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' - type: string - description: 'The date and time the message was sent. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.' - format: date-time - nullable: true - subject: - type: string - description: The subject of the message. - nullable: true - toRecipients: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.recipient' - description: 'The To: recipients for the message.' - uniqueBody: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.itemBody' - - type: object - nullable: true - description: The part of the body of the message that is unique to the current message. uniqueBody is not returned by default but can be retrieved for a given message by use of the ?$select=uniqueBody query. It can be in HTML or text format. - webLink: - type: string - description: 'The URL to open the message in Outlook on the web.You can append an ispopout argument to the end of the URL to change how the message is displayed. If ispopout is not present or if it is set to 1, then the message is shown in a popout window. If ispopout is set to 0, the browser shows the message in the Outlook on the web review pane.The message opens in the browser if you are signed in to your mailbox via Outlook on the web. You are prompted to sign in if you are not already signed in with the browser.This URL cannot be accessed from within an iFrame.' - nullable: true - attachments: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.attachment' - description: The fileAttachment and itemAttachment attachments for the message. - extensions: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.extension' - description: The collection of open extensions defined for the message. Nullable. - multiValueExtendedProperties: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty' - description: The collection of multi-value extended properties defined for the message. Nullable. - singleValueExtendedProperties: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty' - description: The collection of single-value extended properties defined for the message. Nullable. - microsoft.graph.outlookItem: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: outlookItem - type: object - properties: - categories: - type: array - items: - type: string - nullable: true - description: The categories associated with the item - changeKey: - type: string - description: 'Identifies the version of the item. Every time the item is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.' - nullable: true - createdDateTime: - pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' - type: string - description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' - format: date-time - nullable: true - lastModifiedDateTime: - pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' - type: string - description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' - format: date-time - nullable: true + title: message + required: + - '@odata.type' + type: object + properties: + id: + type: string + description: The unique identifier for an entity. Read-only. + '@odata.type': + type: string + categories: + type: array + items: + type: string + nullable: true + description: The categories associated with the item + changeKey: + type: string + description: 'Identifies the version of the item. Every time the item is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.' + nullable: true + createdDateTime: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' + type: string + description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + lastModifiedDateTime: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' + type: string + description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + bccRecipients: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.recipient' + description: 'The Bcc: recipients for the message.' + body: + $ref: '#/components/schemas/microsoft.graph.itemBody' + bodyPreview: + type: string + description: The first 255 characters of the message body. It is in text format. + nullable: true + ccRecipients: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.recipient' + description: 'The Cc: recipients for the message.' + conversationId: + type: string + description: The ID of the conversation the email belongs to. + nullable: true + conversationIndex: + type: string + description: Indicates the position of the message within the conversation. + format: base64url + nullable: true + flag: + $ref: '#/components/schemas/microsoft.graph.followupFlag' + from: + $ref: '#/components/schemas/microsoft.graph.recipient' + hasAttachments: + type: boolean + description: 'Indicates whether the message has attachments. This property doesn''t include inline attachments, so if a message contains only inline attachments, this property is false. To verify the existence of inline attachments, parse the body property to look for a src attribute, such as .' + nullable: true + importance: + $ref: '#/components/schemas/microsoft.graph.importance' + inferenceClassification: + $ref: '#/components/schemas/microsoft.graph.inferenceClassificationType' + internetMessageHeaders: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.internetMessageHeader' + description: A collection of message headers defined by RFC5322. The set includes message headers indicating the network path taken by a message from the sender to the recipient. It can also contain custom message headers that hold app data for the message. Returned only on applying a $select query option. Read-only. + internetMessageId: + type: string + description: The message ID in the format specified by RFC2822. + nullable: true + isDeliveryReceiptRequested: + type: boolean + description: Indicates whether a read receipt is requested for the message. + nullable: true + isDraft: + type: boolean + description: Indicates whether the message is a draft. A message is a draft if it hasn't been sent yet. + nullable: true + isRead: + type: boolean + description: Indicates whether the message has been read. + nullable: true + isReadReceiptRequested: + type: boolean + description: Indicates whether a read receipt is requested for the message. + nullable: true + parentFolderId: + type: string + description: The unique identifier for the message's parent mailFolder. + nullable: true + receivedDateTime: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' + type: string + description: 'The date and time the message was received. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.' + format: date-time + nullable: true + replyTo: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.recipient' + description: The email addresses to use when replying. + sender: + $ref: '#/components/schemas/microsoft.graph.recipient' + sentDateTime: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' + type: string + description: 'The date and time the message was sent. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.' + format: date-time + nullable: true + subject: + type: string + description: The subject of the message. + nullable: true + toRecipients: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.recipient' + description: 'The To: recipients for the message.' + uniqueBody: + $ref: '#/components/schemas/microsoft.graph.itemBody' + webLink: + type: string + description: 'The URL to open the message in Outlook on the web.You can append an ispopout argument to the end of the URL to change how the message is displayed. If ispopout is not present or if it is set to 1, then the message is shown in a popout window. If ispopout is set to 0, the browser shows the message in the Outlook on the web review pane.The message opens in the browser if you are signed in to your mailbox via Outlook on the web. You are prompted to sign in if you are not already signed in with the browser.This URL cannot be accessed from within an iFrame.' + nullable: true + attachments: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.attachment' + description: The fileAttachment and itemAttachment attachments for the message. + extensions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.extension' + description: The collection of open extensions defined for the message. Nullable. + multiValueExtendedProperties: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty' + description: The collection of multi-value extended properties defined for the message. Nullable. + singleValueExtendedProperties: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty' + description: The collection of single-value extended properties defined for the message. Nullable. microsoft.graph.recipient: title: recipient + required: + - '@odata.type' type: object properties: emailAddress: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.emailAddress' - - type: object - nullable: true - description: The recipient's email address. + $ref: '#/components/schemas/microsoft.graph.emailAddress' + '@odata.type': + type: string + discriminator: + propertyName: '@odata.type' microsoft.graph.itemBody: title: itemBody + required: + - '@odata.type' type: object properties: content: @@ -401,39 +261,27 @@ components: description: The content of the item. nullable: true contentType: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.bodyType' - - type: object - nullable: true - description: The type of the content. Possible values are text and html. + $ref: '#/components/schemas/microsoft.graph.bodyType' + '@odata.type': + type: string + description: The body of the message. It can be in HTML or text format. Find out about safe HTML in a message body. microsoft.graph.followupFlag: title: followupFlag + required: + - '@odata.type' type: object properties: completedDateTime: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' - - type: object - nullable: true - description: The date and time that the follow-up was finished. + $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' dueDateTime: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' - - type: object - nullable: true - description: 'The date and time that the follow-up is to be finished. Note: To set the due date, you must also specify the startDateTime; otherwise, you get a 400 Bad Request response.' + $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' flagStatus: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.followupFlagStatus' - - type: object - nullable: true - description: 'The status for follow-up for an item. Possible values are notFlagged, complete, and flagged.' + $ref: '#/components/schemas/microsoft.graph.followupFlagStatus' startDateTime: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' - - type: object - nullable: true - description: The date and time that the follow-up is to begin. + $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' + '@odata.type': + type: string + description: 'The flag value that indicates the status, start date, due date, or completion date for the message.' microsoft.graph.importance: title: importance enum: @@ -441,14 +289,18 @@ components: - normal - high type: string + description: 'The importance of the message. The possible values are: low, normal, and high.' microsoft.graph.inferenceClassificationType: title: inferenceClassificationType enum: - focused - other type: string + description: 'The classification of the message for the user, based on inferred relevance or importance, or on an explicit override. The possible values are: focused or other.' microsoft.graph.internetMessageHeader: title: internetMessageHeader + required: + - '@odata.type' type: object properties: name: @@ -459,89 +311,104 @@ components: type: string description: The value in a key-value pair. nullable: true + '@odata.type': + type: string microsoft.graph.attachment: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: attachment - type: object - properties: - contentType: - type: string - description: The MIME type. - nullable: true - isInline: - type: boolean - description: 'true if the attachment is an inline attachment; otherwise, false.' - lastModifiedDateTime: - pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' - type: string - description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' - format: date-time - nullable: true - name: - type: string - description: The attachment's file name. - nullable: true - size: - maximum: 2147483647 - minimum: -2147483648 - type: number - description: The length of the attachment in bytes. - format: int32 + title: attachment + required: + - '@odata.type' + type: object + properties: + id: + type: string + description: The unique identifier for an entity. Read-only. + '@odata.type': + type: string + contentType: + type: string + description: The MIME type. + nullable: true + isInline: + type: boolean + description: 'true if the attachment is an inline attachment; otherwise, false.' + lastModifiedDateTime: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' + type: string + description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + name: + type: string + description: The attachment's file name. + nullable: true + size: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The length of the attachment in bytes. + format: int32 microsoft.graph.extension: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: extension - type: object - microsoft.graph.multiValueLegacyExtendedProperty: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: multiValueLegacyExtendedProperty - type: object - properties: - value: - type: array - items: - type: string - nullable: true - description: A collection of property values. - microsoft.graph.singleValueLegacyExtendedProperty: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: singleValueLegacyExtendedProperty - type: object - properties: - value: - type: string - description: A property value. - nullable: true - microsoft.graph.messageCollectionResponse: - title: Collection of message + title: extension + required: + - '@odata.type' type: object - allOf: - - $ref: '#/components/schemas/BaseCollectionPaginationCountResponse' - - type: object - properties: - value: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.message' - microsoft.graph.ODataErrors.ODataError: + properties: + id: + type: string + description: The unique identifier for an entity. Read-only. + '@odata.type': + type: string + microsoft.graph.multiValueLegacyExtendedProperty: + title: multiValueLegacyExtendedProperty required: - - error + - '@odata.type' type: object properties: - error: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.MainError' - microsoft.graph.entity: - title: entity + id: + type: string + description: The unique identifier for an entity. Read-only. + '@odata.type': + type: string + value: + type: array + items: + type: string + nullable: true + description: A collection of property values. + microsoft.graph.singleValueLegacyExtendedProperty: + title: singleValueLegacyExtendedProperty + required: + - '@odata.type' type: object properties: id: type: string description: The unique identifier for an entity. Read-only. + '@odata.type': + type: string + value: + type: string + description: A property value. + nullable: true + microsoft.graph.messageCollectionResponse: + title: Base collection pagination and count responses + type: object + properties: + '@odata.count': + type: integer + format: int64 + nullable: true + '@odata.nextLink': + type: string + nullable: true + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.message' microsoft.graph.emailAddress: title: emailAddress + required: + - '@odata.type' type: object properties: address: @@ -552,14 +419,20 @@ components: type: string description: The display name of the person or entity. nullable: true + '@odata.type': + type: string + description: The recipient's email address. microsoft.graph.bodyType: title: bodyType enum: - text - html type: string + description: The type of the content. Possible values are text and html. microsoft.graph.dateTimeTimeZone: title: dateTimeTimeZone + required: + - '@odata.type' type: object properties: dateTime: @@ -569,6 +442,9 @@ components: type: string description: 'Represents a time zone, for example, ''Pacific Standard Time''. See below for more possible values.' nullable: true + '@odata.type': + type: string + description: The date and time that the follow-up was finished. microsoft.graph.followupFlagStatus: title: followupFlagStatus enum: @@ -576,49 +452,7 @@ components: - complete - flagged type: string - BaseCollectionPaginationCountResponse: - title: Base collection pagination and count responses - type: object - properties: - '@odata.nextLink': - type: string - nullable: true - microsoft.graph.ODataErrors.MainError: - required: - - code - - message - type: object - properties: - code: - type: string - message: - type: string - x-ms-primary-error-message: true - target: - type: string - nullable: true - details: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.ErrorDetails' - innerError: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.InnerError' - microsoft.graph.ODataErrors.ErrorDetails: - required: - - code - - message - type: object - properties: - code: - type: string - message: - type: string - target: - type: string - nullable: true - microsoft.graph.ODataErrors.InnerError: - type: object - description: The structure of this object is service-specific + description: 'The status for follow-up for an item. Possible values are notFlagged, complete, and flagged.' responses: microsoft.graph.messageCollectionResponse: description: Retrieved collection @@ -626,12 +460,6 @@ components: application/json: schema: $ref: '#/components/schemas/microsoft.graph.messageCollectionResponse' - error: - description: error - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.ODataError' parameters: top: name: $top diff --git a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/CalendarPlugin/calendar-openapi.yml b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/CalendarPlugin/calendar-openapi.yml index 38fd3f979c17..7232189dd51a 100644 --- a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/CalendarPlugin/calendar-openapi.yml +++ b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/CalendarPlugin/calendar-openapi.yml @@ -12,9 +12,6 @@ paths: - me.calendar summary: List events description: "Retrieve a list of events in a calendar. The calendar can be one for a user, or the default calendar of a Microsoft 365 group. The list of events contains single instance meetings and series masters. To get expanded event instances, you can get the calendar view, or\nget the instances of an event." - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/calendar-list-events?view=graph-rest-1.0 operationId: me_calendar_ListEvents parameters: - $ref: '#/components/parameters/top' @@ -31,89 +28,6 @@ paths: uniqueItems: true type: array items: - enum: - - id - - id desc - - categories - - categories desc - - changeKey - - changeKey desc - - createdDateTime - - createdDateTime desc - - lastModifiedDateTime - - lastModifiedDateTime desc - - allowNewTimeProposals - - allowNewTimeProposals desc - - attendees - - attendees desc - - body - - body desc - - bodyPreview - - bodyPreview desc - - end - - end desc - - hasAttachments - - hasAttachments desc - - hideAttendees - - hideAttendees desc - - iCalUId - - iCalUId desc - - importance - - importance desc - - isAllDay - - isAllDay desc - - isCancelled - - isCancelled desc - - isDraft - - isDraft desc - - isOnlineMeeting - - isOnlineMeeting desc - - isOrganizer - - isOrganizer desc - - isReminderOn - - isReminderOn desc - - location - - location desc - - locations - - locations desc - - onlineMeeting - - onlineMeeting desc - - onlineMeetingProvider - - onlineMeetingProvider desc - - onlineMeetingUrl - - onlineMeetingUrl desc - - organizer - - organizer desc - - originalEndTimeZone - - originalEndTimeZone desc - - originalStart - - originalStart desc - - originalStartTimeZone - - originalStartTimeZone desc - - recurrence - - recurrence desc - - reminderMinutesBeforeStart - - reminderMinutesBeforeStart desc - - responseRequested - - responseRequested desc - - responseStatus - - responseStatus desc - - sensitivity - - sensitivity desc - - seriesMasterId - - seriesMasterId desc - - showAs - - showAs desc - - start - - start desc - - subject - - subject desc - - transactionId - - transactionId desc - - type - - type desc - - webLink - - webLink desc type: string - name: $select in: query @@ -124,54 +38,6 @@ paths: uniqueItems: true type: array items: - enum: - - id - - categories - - changeKey - - createdDateTime - - lastModifiedDateTime - - allowNewTimeProposals - - attendees - - body - - bodyPreview - - end - - hasAttachments - - hideAttendees - - iCalUId - - importance - - isAllDay - - isCancelled - - isDraft - - isOnlineMeeting - - isOrganizer - - isReminderOn - - location - - locations - - onlineMeeting - - onlineMeetingProvider - - onlineMeetingUrl - - organizer - - originalEndTimeZone - - originalStart - - originalStartTimeZone - - recurrence - - reminderMinutesBeforeStart - - responseRequested - - responseStatus - - sensitivity - - seriesMasterId - - showAs - - start - - subject - - transactionId - - type - - webLink - - attachments - - calendar - - extensions - - instances - - multiValueExtendedProperties - - singleValueExtendedProperties type: string - name: $expand in: query @@ -182,20 +48,10 @@ paths: uniqueItems: true type: array items: - enum: - - '*' - - attachments - - calendar - - extensions - - instances - - multiValueExtendedProperties - - singleValueExtendedProperties type: string responses: - '200': + 2XX: $ref: '#/components/responses/microsoft.graph.eventCollectionResponse' - default: - $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore @@ -203,312 +59,225 @@ paths: components: schemas: microsoft.graph.eventCollectionResponse: - title: Collection of event - type: object - allOf: - - $ref: '#/components/schemas/BaseCollectionPaginationCountResponse' - - type: object - properties: - value: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.event' - microsoft.graph.ODataErrors.ODataError: - required: - - error - type: object - properties: - error: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.MainError' - BaseCollectionPaginationCountResponse: title: Base collection pagination and count responses type: object properties: + '@odata.count': + type: integer + format: int64 + nullable: true '@odata.nextLink': type: string nullable: true + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.event' microsoft.graph.event: - allOf: - - $ref: '#/components/schemas/microsoft.graph.outlookItem' - - title: event - type: object - properties: - allowNewTimeProposals: - type: boolean - description: 'true if the meeting organizer allows invitees to propose a new time when responding; otherwise, false. Optional. Default is true.' - nullable: true - attendees: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.attendee' - description: The collection of attendees for the event. - body: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.itemBody' - - type: object - nullable: true - description: The body of the message associated with the event. It can be in HTML or text format. - bodyPreview: - type: string - description: The preview of the message associated with the event. It is in text format. - nullable: true - end: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' - - type: object - nullable: true - description: 'The date, time, and time zone that the event ends. By default, the end time is in UTC.' - hasAttachments: - type: boolean - description: Set to true if the event has attachments. - nullable: true - hideAttendees: - type: boolean - description: 'When set to true, each attendee only sees themselves in the meeting request and meeting Tracking list. Default is false.' - nullable: true - iCalUId: - type: string - description: A unique identifier for an event across calendars. This ID is different for each occurrence in a recurring series. Read-only. - nullable: true - importance: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.importance' - - type: object - nullable: true - description: 'The importance of the event. The possible values are: low, normal, high.' - isAllDay: - type: boolean - description: 'Set to true if the event lasts all day. If true, regardless of whether it''s a single-day or multi-day event, start and end time must be set to midnight and be in the same time zone.' - nullable: true - isCancelled: - type: boolean - description: Set to true if the event has been canceled. - nullable: true - isDraft: - type: boolean - description: 'Set to true if the user has updated the meeting in Outlook but has not sent the updates to attendees. Set to false if all changes have been sent, or if the event is an appointment without any attendees.' - nullable: true - isOnlineMeeting: - type: boolean - description: 'True if this event has online meeting information (that is, onlineMeeting points to an onlineMeetingInfo resource), false otherwise. Default is false (onlineMeeting is null). Optional. After you set isOnlineMeeting to true, Microsoft Graph initializes onlineMeeting. Subsequently Outlook ignores any further changes to isOnlineMeeting, and the meeting remains available online.' - nullable: true - isOrganizer: - type: boolean - description: Set to true if the calendar owner (specified by the owner property of the calendar) is the organizer of the event (specified by the organizer property of the event). This also applies if a delegate organized the event on behalf of the owner. - nullable: true - isReminderOn: - type: boolean - description: Set to true if an alert is set to remind the user of the event. - nullable: true - location: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.location' - - type: object - nullable: true - description: The location of the event. - locations: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.location' - description: 'The locations where the event is held or attended from. The location and locations properties always correspond with each other. If you update the location property, any prior locations in the locations collection would be removed and replaced by the new location value.' - onlineMeeting: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.onlineMeetingInfo' - - type: object - nullable: true - description: 'Details for an attendee to join the meeting online. Default is null. Read-only. After you set the isOnlineMeeting and onlineMeetingProvider properties to enable a meeting online, Microsoft Graph initializes onlineMeeting. When set, the meeting remains available online, and you cannot change the isOnlineMeeting, onlineMeetingProvider, and onlneMeeting properties again.' - onlineMeetingProvider: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.onlineMeetingProviderType' - - type: object - nullable: true - description: 'Represents the online meeting service provider. By default, onlineMeetingProvider is unknown. The possible values are unknown, teamsForBusiness, skypeForBusiness, and skypeForConsumer. Optional. After you set onlineMeetingProvider, Microsoft Graph initializes onlineMeeting. Subsequently you cannot change onlineMeetingProvider again, and the meeting remains available online.' - onlineMeetingUrl: - type: string - description: 'A URL for an online meeting. The property is set only when an organizer specifies in Outlook that an event is an online meeting such as Skype. Read-only.To access the URL to join an online meeting, use joinUrl which is exposed via the onlineMeeting property of the event. The onlineMeetingUrl property will be deprecated in the future.' - nullable: true - organizer: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.recipient' - - type: object - nullable: true - description: The organizer of the event. - originalEndTimeZone: - type: string - description: The end time zone that was set when the event was created. A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook. - nullable: true - originalStart: - pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' - type: string - description: 'Represents the start time of an event when it is initially created as an occurrence or exception in a recurring series. This property is not returned for events that are single instances. Its date and time information is expressed in ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' - format: date-time - nullable: true - originalStartTimeZone: - type: string - description: The start time zone that was set when the event was created. A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook. - nullable: true - recurrence: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.patternedRecurrence' - - type: object - nullable: true - description: The recurrence pattern for the event. - reminderMinutesBeforeStart: - maximum: 2147483647 - minimum: -2147483648 - type: number - description: The number of minutes before the event start time that the reminder alert occurs. - format: int32 - nullable: true - responseRequested: - type: boolean - description: 'Default is true, which represents the organizer would like an invitee to send a response to the event.' - nullable: true - responseStatus: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.responseStatus' - - type: object - nullable: true - description: Indicates the type of response sent in response to an event message. - sensitivity: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.sensitivity' - - type: object - nullable: true - description: 'Possible values are: normal, personal, private, confidential.' - seriesMasterId: - type: string - description: 'The ID for the recurring series master item, if this event is part of a recurring series.' - nullable: true - showAs: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.freeBusyStatus' - - type: object - nullable: true - description: 'The status to show. Possible values are: free, tentative, busy, oof, workingElsewhere, unknown.' - start: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' - - type: object - nullable: true - description: 'The start date, time, and time zone of the event. By default, the start time is in UTC.' - subject: - type: string - description: The text of the event's subject line. - nullable: true - transactionId: - type: string - description: 'A custom identifier specified by a client app for the server to avoid redundant POST operations in case of client retries to create the same event. This is useful when low network connectivity causes the client to time out before receiving a response from the server for the client''s prior create-event request. After you set transactionId when creating an event, you cannot change transactionId in a subsequent update. This property is only returned in a response payload if an app has set it. Optional.' - nullable: true - type: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.eventType' - - type: object - nullable: true - description: 'The event type. Possible values are: singleInstance, occurrence, exception, seriesMaster. Read-only' - webLink: - type: string - description: 'The URL to open the event in Outlook on the web.Outlook on the web opens the event in the browser if you are signed in to your mailbox. Otherwise, Outlook on the web prompts you to sign in.This URL cannot be accessed from within an iFrame.' - nullable: true - attachments: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.attachment' - description: 'The collection of FileAttachment, ItemAttachment, and referenceAttachment attachments for the event. Navigation property. Read-only. Nullable.' - calendar: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.calendar' - - type: object - nullable: true - description: The calendar that contains the event. Navigation property. Read-only. - extensions: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.extension' - description: The collection of open extensions defined for the event. Nullable. - instances: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.event' - description: 'The occurrences of a recurring series, if the event is a series master. This property includes occurrences that are part of the recurrence pattern, and exceptions that have been modified, but does not include occurrences that have been cancelled from the series. Navigation property. Read-only. Nullable.' - multiValueExtendedProperties: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty' - description: The collection of multi-value extended properties defined for the event. Read-only. Nullable. - singleValueExtendedProperties: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty' - description: The collection of single-value extended properties defined for the event. Read-only. Nullable. - microsoft.graph.ODataErrors.MainError: + title: event required: - - code - - message + - '@odata.type' type: object properties: - code: + id: type: string - message: + description: The unique identifier for an entity. Read-only. + '@odata.type': + type: string + categories: + type: array + items: + type: string + nullable: true + description: The categories associated with the item + changeKey: type: string - x-ms-primary-error-message: true - target: + description: 'Identifies the version of the item. Every time the item is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.' + nullable: true + createdDateTime: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' type: string + description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time nullable: true - details: + lastModifiedDateTime: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' + type: string + description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + allowNewTimeProposals: + type: boolean + description: 'true if the meeting organizer allows invitees to propose a new time when responding; otherwise, false. Optional. Default is true.' + nullable: true + attendees: type: array items: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.ErrorDetails' - innerError: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.InnerError' - microsoft.graph.outlookItem: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: outlookItem - type: object - properties: - categories: - type: array - items: - type: string - nullable: true - description: The categories associated with the item - changeKey: - type: string - description: 'Identifies the version of the item. Every time the item is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.' - nullable: true - createdDateTime: - pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' - type: string - description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' - format: date-time - nullable: true - lastModifiedDateTime: - pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' - type: string - description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' - format: date-time - nullable: true + $ref: '#/components/schemas/microsoft.graph.attendee' + description: The collection of attendees for the event. + body: + $ref: '#/components/schemas/microsoft.graph.itemBody' + bodyPreview: + type: string + description: The preview of the message associated with the event. It is in text format. + nullable: true + end: + $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' + hasAttachments: + type: boolean + description: Set to true if the event has attachments. + nullable: true + hideAttendees: + type: boolean + description: 'When set to true, each attendee only sees themselves in the meeting request and meeting Tracking list. Default is false.' + nullable: true + iCalUId: + type: string + description: A unique identifier for an event across calendars. This ID is different for each occurrence in a recurring series. Read-only. + nullable: true + importance: + $ref: '#/components/schemas/microsoft.graph.importance' + isAllDay: + type: boolean + description: 'Set to true if the event lasts all day. If true, regardless of whether it''s a single-day or multi-day event, start and end time must be set to midnight and be in the same time zone.' + nullable: true + isCancelled: + type: boolean + description: Set to true if the event has been canceled. + nullable: true + isDraft: + type: boolean + description: 'Set to true if the user has updated the meeting in Outlook but has not sent the updates to attendees. Set to false if all changes have been sent, or if the event is an appointment without any attendees.' + nullable: true + isOnlineMeeting: + type: boolean + description: 'True if this event has online meeting information (that is, onlineMeeting points to an onlineMeetingInfo resource), false otherwise. Default is false (onlineMeeting is null). Optional. After you set isOnlineMeeting to true, Microsoft Graph initializes onlineMeeting. Subsequently Outlook ignores any further changes to isOnlineMeeting, and the meeting remains available online.' + nullable: true + isOrganizer: + type: boolean + description: Set to true if the calendar owner (specified by the owner property of the calendar) is the organizer of the event (specified by the organizer property of the event). This also applies if a delegate organized the event on behalf of the owner. + nullable: true + isReminderOn: + type: boolean + description: Set to true if an alert is set to remind the user of the event. + nullable: true + location: + $ref: '#/components/schemas/microsoft.graph.location' + locations: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.location' + description: 'The locations where the event is held or attended from. The location and locations properties always correspond with each other. If you update the location property, any prior locations in the locations collection would be removed and replaced by the new location value.' + onlineMeeting: + $ref: '#/components/schemas/microsoft.graph.onlineMeetingInfo' + onlineMeetingProvider: + $ref: '#/components/schemas/microsoft.graph.onlineMeetingProviderType' + onlineMeetingUrl: + type: string + description: 'A URL for an online meeting. The property is set only when an organizer specifies in Outlook that an event is an online meeting such as Skype. Read-only.To access the URL to join an online meeting, use joinUrl which is exposed via the onlineMeeting property of the event. The onlineMeetingUrl property will be deprecated in the future.' + nullable: true + organizer: + $ref: '#/components/schemas/microsoft.graph.recipient' + originalEndTimeZone: + type: string + description: The end time zone that was set when the event was created. A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook. + nullable: true + originalStart: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' + type: string + description: 'Represents the start time of an event when it is initially created as an occurrence or exception in a recurring series. This property is not returned for events that are single instances. Its date and time information is expressed in ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + originalStartTimeZone: + type: string + description: The start time zone that was set when the event was created. A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook. + nullable: true + recurrence: + $ref: '#/components/schemas/microsoft.graph.patternedRecurrence' + reminderMinutesBeforeStart: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The number of minutes before the event start time that the reminder alert occurs. + format: int32 + nullable: true + responseRequested: + type: boolean + description: 'Default is true, which represents the organizer would like an invitee to send a response to the event.' + nullable: true + responseStatus: + $ref: '#/components/schemas/microsoft.graph.responseStatus' + sensitivity: + $ref: '#/components/schemas/microsoft.graph.sensitivity' + seriesMasterId: + type: string + description: 'The ID for the recurring series master item, if this event is part of a recurring series.' + nullable: true + showAs: + $ref: '#/components/schemas/microsoft.graph.freeBusyStatus' + start: + $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' + subject: + type: string + description: The text of the event's subject line. + nullable: true + transactionId: + type: string + description: 'A custom identifier specified by a client app for the server to avoid redundant POST operations in case of client retries to create the same event. This is useful when low network connectivity causes the client to time out before receiving a response from the server for the client''s prior create-event request. After you set transactionId when creating an event, you cannot change transactionId in a subsequent update. This property is only returned in a response payload if an app has set it. Optional.' + nullable: true + type: + $ref: '#/components/schemas/microsoft.graph.eventType' + webLink: + type: string + description: 'The URL to open the event in Outlook on the web.Outlook on the web opens the event in the browser if you are signed in to your mailbox. Otherwise, Outlook on the web prompts you to sign in.This URL cannot be accessed from within an iFrame.' + nullable: true + attachments: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.attachment' + description: 'The collection of FileAttachment, ItemAttachment, and referenceAttachment attachments for the event. Navigation property. Read-only. Nullable.' + calendar: + $ref: '#/components/schemas/microsoft.graph.calendar' + extensions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.extension' + description: The collection of open extensions defined for the event. Nullable. + instances: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.event' + description: 'The occurrences of a recurring series, if the event is a series master. This property includes occurrences that are part of the recurrence pattern, and exceptions that have been modified, but does not include occurrences that have been cancelled from the series. Navigation property. Read-only. Nullable.' + multiValueExtendedProperties: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty' + description: The collection of multi-value extended properties defined for the event. Read-only. Nullable. + singleValueExtendedProperties: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty' + description: The collection of single-value extended properties defined for the event. Read-only. Nullable. microsoft.graph.attendee: - allOf: - - $ref: '#/components/schemas/microsoft.graph.attendeeBase' - - title: attendee - type: object - properties: - proposedNewTime: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.timeSlot' - - type: object - nullable: true - description: 'An alternate date/time proposed by the attendee for a meeting request to start and end. If the attendee hasn''t proposed another time, then this property isn''t included in a response of a GET event.' - status: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.responseStatus' - - type: object - nullable: true - description: 'The attendee''s response (none, accepted, declined, etc.) for the event and date-time that the response was sent.' + title: attendee + required: + - '@odata.type' + type: object + properties: + emailAddress: + $ref: '#/components/schemas/microsoft.graph.emailAddress' + '@odata.type': + type: string + type: + $ref: '#/components/schemas/microsoft.graph.attendeeType' + proposedNewTime: + $ref: '#/components/schemas/microsoft.graph.timeSlot' + status: + $ref: '#/components/schemas/microsoft.graph.responseStatus' microsoft.graph.itemBody: title: itemBody + required: + - '@odata.type' type: object properties: content: @@ -516,13 +285,14 @@ components: description: The content of the item. nullable: true contentType: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.bodyType' - - type: object - nullable: true - description: The type of the content. Possible values are text and html. + $ref: '#/components/schemas/microsoft.graph.bodyType' + '@odata.type': + type: string + description: The body of the message associated with the event. It can be in HTML or text format. microsoft.graph.dateTimeTimeZone: title: dateTimeTimeZone + required: + - '@odata.type' type: object properties: dateTime: @@ -532,6 +302,9 @@ components: type: string description: 'Represents a time zone, for example, ''Pacific Standard Time''. See below for more possible values.' nullable: true + '@odata.type': + type: string + description: 'The date, time, and time zone that the event ends. By default, the end time is in UTC.' microsoft.graph.importance: title: importance enum: @@ -539,22 +312,17 @@ components: - normal - high type: string + description: 'The importance of the event. The possible values are: low, normal, high.' microsoft.graph.location: title: location + required: + - '@odata.type' type: object properties: address: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.physicalAddress' - - type: object - nullable: true - description: The street address of the location. + $ref: '#/components/schemas/microsoft.graph.physicalAddress' coordinates: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.outlookGeoCoordinates' - - type: object - nullable: true - description: The geographic coordinates and elevation of the location. + $ref: '#/components/schemas/microsoft.graph.outlookGeoCoordinates' displayName: type: string description: The name associated with the location. @@ -564,11 +332,7 @@ components: description: Optional email address of the location. nullable: true locationType: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.locationType' - - type: object - nullable: true - description: 'The type of location. The possible values are: default, conferenceRoom, homeAddress, businessAddress,geoCoordinates, streetAddress, hotel, restaurant, localBusiness, postalAddress. Read-only.' + $ref: '#/components/schemas/microsoft.graph.locationType' locationUri: type: string description: Optional URI representing the location. @@ -578,13 +342,16 @@ components: description: For internal use only. nullable: true uniqueIdType: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.locationUniqueIdType' - - type: object - nullable: true - description: For internal use only. + $ref: '#/components/schemas/microsoft.graph.locationUniqueIdType' + '@odata.type': + type: string + description: The location of the event. + discriminator: + propertyName: '@odata.type' microsoft.graph.onlineMeetingInfo: title: onlineMeetingInfo + required: + - '@odata.type' type: object properties: conferenceId: @@ -614,6 +381,9 @@ components: type: string description: The toll number that can be used to join the conference. nullable: true + '@odata.type': + type: string + description: 'Details for an attendee to join the meeting online. Default is null. Read-only. After you set the isOnlineMeeting and onlineMeetingProvider properties to enable a meeting online, Microsoft Graph initializes onlineMeeting. When set, the meeting remains available online, and you cannot change the isOnlineMeeting, onlineMeetingProvider, and onlneMeeting properties again.' microsoft.graph.onlineMeetingProviderType: title: onlineMeetingProviderType enum: @@ -622,48 +392,53 @@ components: - skypeForConsumer - teamsForBusiness type: string + description: 'Represents the online meeting service provider. By default, onlineMeetingProvider is unknown. The possible values are unknown, teamsForBusiness, skypeForBusiness, and skypeForConsumer. Optional. After you set onlineMeetingProvider, Microsoft Graph initializes onlineMeeting. Subsequently you cannot change onlineMeetingProvider again, and the meeting remains available online.' microsoft.graph.recipient: title: recipient + required: + - '@odata.type' type: object properties: emailAddress: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.emailAddress' - - type: object - nullable: true - description: The recipient's email address. + $ref: '#/components/schemas/microsoft.graph.emailAddress' + '@odata.type': + type: string + description: The organizer of the event. + discriminator: + propertyName: '@odata.type' + mapping: + '#microsoft.graph.attendeeBase': '#/components/schemas/microsoft.graph.attendeeBase' + '#microsoft.graph.attendee': '#/components/schemas/microsoft.graph.attendee' microsoft.graph.patternedRecurrence: title: patternedRecurrence + required: + - '@odata.type' type: object properties: pattern: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.recurrencePattern' - - type: object - nullable: true - description: 'The frequency of an event. For access reviews: Do not specify this property for a one-time access review. Only interval, dayOfMonth, and type (weekly, absoluteMonthly) properties of recurrencePattern are supported.' + $ref: '#/components/schemas/microsoft.graph.recurrencePattern' range: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.recurrenceRange' - - type: object - nullable: true - description: The duration of an event. + $ref: '#/components/schemas/microsoft.graph.recurrenceRange' + '@odata.type': + type: string + description: The recurrence pattern for the event. microsoft.graph.responseStatus: title: responseStatus + required: + - '@odata.type' type: object properties: response: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.responseType' - - type: object - nullable: true - description: 'The response type. Possible values are: none, organizer, tentativelyAccepted, accepted, declined, notResponded.To differentiate between none and notResponded: none – from organizer''s perspective. This value is used when the status of an attendee/participant is reported to the organizer of a meeting. notResponded – from attendee''s perspective. Indicates the attendee has not responded to the meeting request. Clients can treat notResponded == none. As an example, if attendee Alex hasn''t responded to a meeting request, getting Alex'' response status for that event in Alex'' calendar returns notResponded. Getting Alex'' response from the calendar of any other attendee or the organizer''s returns none. Getting the organizer''s response for the event in anybody''s calendar also returns none.' + $ref: '#/components/schemas/microsoft.graph.responseType' time: pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' type: string description: 'The date and time when the response was returned. It uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' format: date-time nullable: true + '@odata.type': + type: string + description: Indicates the type of response sent in response to an event message. microsoft.graph.sensitivity: title: sensitivity enum: @@ -672,6 +447,7 @@ components: - private - confidential type: string + description: 'Possible values are: normal, personal, private, confidential.' microsoft.graph.freeBusyStatus: title: freeBusyStatus enum: @@ -682,6 +458,7 @@ components: - oof - workingElsewhere type: string + description: 'The status to show. Possible values are: free, tentative, busy, oof, workingElsewhere, unknown.' microsoft.graph.eventType: title: eventType enum: @@ -690,206 +467,135 @@ components: - exception - seriesMaster type: string + description: 'The event type. Possible values are: singleInstance, occurrence, exception, seriesMaster. Read-only' microsoft.graph.attachment: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: attachment - type: object - properties: - contentType: - type: string - description: The MIME type. - nullable: true - isInline: - type: boolean - description: 'true if the attachment is an inline attachment; otherwise, false.' - lastModifiedDateTime: - pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' - type: string - description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' - format: date-time - nullable: true - name: - type: string - description: The attachment's file name. - nullable: true - size: - maximum: 2147483647 - minimum: -2147483648 - type: number - description: The length of the attachment in bytes. - format: int32 + title: attachment + required: + - '@odata.type' + type: object + properties: + id: + type: string + description: The unique identifier for an entity. Read-only. + '@odata.type': + type: string + contentType: + type: string + description: The MIME type. + nullable: true + isInline: + type: boolean + description: 'true if the attachment is an inline attachment; otherwise, false.' + lastModifiedDateTime: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' + type: string + description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + name: + type: string + description: The attachment's file name. + nullable: true + size: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The length of the attachment in bytes. + format: int32 microsoft.graph.calendar: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: calendar - type: object - properties: - allowedOnlineMeetingProviders: - type: array - items: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.onlineMeetingProviderType' - - type: object - nullable: true - description: 'Represent the online meeting service providers that can be used to create online meetings in this calendar. Possible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.' - canEdit: - type: boolean - description: 'true if the user can write to the calendar, false otherwise. This property is true for the user who created the calendar. This property is also true for a user who has been shared a calendar and granted write access.' - nullable: true - canShare: - type: boolean - description: 'true if the user has the permission to share the calendar, false otherwise. Only the user who created the calendar can share it.' - nullable: true - canViewPrivateItems: - type: boolean - description: 'true if the user can read calendar items that have been marked private, false otherwise.' - nullable: true - changeKey: - type: string - description: 'Identifies the version of the calendar object. Every time the calendar is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.' - nullable: true - color: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.calendarColor' - - type: object - nullable: true - description: 'Specifies the color theme to distinguish the calendar from other calendars in a UI. The property values are: auto, lightBlue, lightGreen, lightOrange, lightGray, lightYellow, lightTeal, lightPink, lightBrown, lightRed, maxColor.' - defaultOnlineMeetingProvider: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.onlineMeetingProviderType' - - type: object - nullable: true - description: 'The default online meeting provider for meetings sent from this calendar. Possible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.' - hexColor: - type: string - description: 'The calendar color, expressed in a hex color code of three hexadecimal values, each ranging from 00 to FF and representing the red, green, or blue components of the color in the RGB color space. If the user has never explicitly set a color for the calendar, this property is empty. Read-only.' - nullable: true - isDefaultCalendar: - type: boolean - description: 'true if this is the default calendar where new events are created by default, false otherwise.' - nullable: true - isRemovable: - type: boolean - description: Indicates whether this user calendar can be deleted from the user mailbox. - nullable: true - isTallyingResponses: - type: boolean - description: Indicates whether this user calendar supports tracking of meeting responses. Only meeting invites sent from users' primary calendars support tracking of meeting responses. - nullable: true - name: - type: string - description: The calendar name. - nullable: true - owner: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.emailAddress' - - type: object - nullable: true - description: 'If set, this represents the user who created or added the calendar. For a calendar that the user created or added, the owner property is set to the user. For a calendar shared with the user, the owner property is set to the person who shared that calendar with the user.' - calendarPermissions: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.calendarPermission' - description: The permissions of the users with whom the calendar is shared. - calendarView: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.event' - description: The calendar view for the calendar. Navigation property. Read-only. - events: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.event' - description: The events in the calendar. Navigation property. Read-only. - multiValueExtendedProperties: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty' - description: The collection of multi-value extended properties defined for the calendar. Read-only. Nullable. - singleValueExtendedProperties: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty' - description: The collection of single-value extended properties defined for the calendar. Read-only. Nullable. + description: The calendar that contains the event. Navigation property. Read-only. microsoft.graph.extension: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: extension - type: object + title: extension + required: + - '@odata.type' + type: object + properties: + id: + type: string + description: The unique identifier for an entity. Read-only. + '@odata.type': + type: string microsoft.graph.multiValueLegacyExtendedProperty: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: multiValueLegacyExtendedProperty - type: object - properties: - value: - type: array - items: - type: string - nullable: true - description: A collection of property values. + title: multiValueLegacyExtendedProperty + required: + - '@odata.type' + type: object + properties: + id: + type: string + description: The unique identifier for an entity. Read-only. + '@odata.type': + type: string + value: + type: array + items: + type: string + nullable: true + description: A collection of property values. microsoft.graph.singleValueLegacyExtendedProperty: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: singleValueLegacyExtendedProperty - type: object - properties: - value: - type: string - description: A property value. - nullable: true - microsoft.graph.ODataErrors.ErrorDetails: + title: singleValueLegacyExtendedProperty required: - - code - - message + - '@odata.type' type: object properties: - code: + id: type: string - message: + description: The unique identifier for an entity. Read-only. + '@odata.type': type: string - target: + value: type: string + description: A property value. nullable: true - microsoft.graph.ODataErrors.InnerError: - type: object - description: The structure of this object is service-specific - microsoft.graph.entity: - title: entity + microsoft.graph.emailAddress: + title: emailAddress + required: + - '@odata.type' type: object properties: - id: + address: type: string - description: The unique identifier for an entity. Read-only. - microsoft.graph.attendeeBase: - allOf: - - $ref: '#/components/schemas/microsoft.graph.recipient' - - title: attendeeBase - type: object - properties: - type: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.attendeeType' - - type: object - nullable: true - description: 'The type of attendee. The possible values are: required, optional, resource. Currently if the attendee is a person, findMeetingTimes always considers the person is of the Required type.' + description: The email address of the person or entity. + nullable: true + name: + type: string + description: The display name of the person or entity. + nullable: true + '@odata.type': + type: string + description: The recipient's email address. + microsoft.graph.attendeeType: + title: attendeeType + enum: + - required + - optional + - resource + type: string + description: 'The type of attendee. The possible values are: required, optional, resource. Currently if the attendee is a person, findMeetingTimes always considers the person is of the Required type.' microsoft.graph.timeSlot: title: timeSlot + required: + - '@odata.type' type: object properties: end: $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' start: $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' + '@odata.type': + type: string + description: 'An alternate date/time proposed by the attendee for a meeting request to start and end. If the attendee hasn''t proposed another time, then this property isn''t included in a response of a GET event.' microsoft.graph.bodyType: title: bodyType enum: - text - html type: string + description: The type of the content. Possible values are text and html. microsoft.graph.physicalAddress: title: physicalAddress + required: + - '@odata.type' type: object properties: city: @@ -912,55 +618,43 @@ components: type: string description: The street. nullable: true + '@odata.type': + type: string + description: The street address of the location. microsoft.graph.outlookGeoCoordinates: title: outlookGeoCoordinates + required: + - '@odata.type' type: object properties: accuracy: - oneOf: - - type: number - format: double - nullable: true - - type: string - nullable: true - - $ref: '#/components/schemas/ReferenceNumeric' + type: number description: 'The accuracy of the latitude and longitude. As an example, the accuracy can be measured in meters, such as the latitude and longitude are accurate to within 50 meters.' + format: double + nullable: true altitude: - oneOf: - - type: number - format: double - nullable: true - - type: string - nullable: true - - $ref: '#/components/schemas/ReferenceNumeric' + type: number description: The altitude of the location. + format: double + nullable: true altitudeAccuracy: - oneOf: - - type: number - format: double - nullable: true - - type: string - nullable: true - - $ref: '#/components/schemas/ReferenceNumeric' + type: number description: The accuracy of the altitude. + format: double + nullable: true latitude: - oneOf: - - type: number - format: double - nullable: true - - type: string - nullable: true - - $ref: '#/components/schemas/ReferenceNumeric' + type: number description: The latitude of the location. + format: double + nullable: true longitude: - oneOf: - - type: number - format: double - nullable: true - - type: string - nullable: true - - $ref: '#/components/schemas/ReferenceNumeric' + type: number description: The longitude of the location. + format: double + nullable: true + '@odata.type': + type: string + description: The geographic coordinates and elevation of the location. microsoft.graph.locationType: title: locationType enum: @@ -975,6 +669,7 @@ components: - localBusiness - postalAddress type: string + description: 'The type of location. The possible values are: default, conferenceRoom, homeAddress, businessAddress,geoCoordinates, streetAddress, hotel, restaurant, localBusiness, postalAddress. Read-only.' microsoft.graph.locationUniqueIdType: title: locationUniqueIdType enum: @@ -984,8 +679,11 @@ components: - private - bing type: string + description: For internal use only. microsoft.graph.phone: title: phone + required: + - '@odata.type' type: object properties: language: @@ -999,25 +697,13 @@ components: type: string nullable: true type: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.phoneType' - - type: object - nullable: true - description: 'The type of phone number. The possible values are: home, business, mobile, other, assistant, homeFax, businessFax, otherFax, pager, radio.' - microsoft.graph.emailAddress: - title: emailAddress - type: object - properties: - address: + $ref: '#/components/schemas/microsoft.graph.phoneType' + '@odata.type': type: string - description: The email address of the person or entity. - nullable: true - name: - type: string - description: The display name of the person or entity. - nullable: true microsoft.graph.recurrencePattern: title: recurrencePattern + required: + - '@odata.type' type: object properties: dayOfMonth: @@ -1029,23 +715,12 @@ components: daysOfWeek: type: array items: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.dayOfWeek' - - type: object - nullable: true + $ref: '#/components/schemas/microsoft.graph.dayOfWeek' description: 'A collection of the days of the week on which the event occurs. The possible values are: sunday, monday, tuesday, wednesday, thursday, friday, saturday. If type is relativeMonthly or relativeYearly, and daysOfWeek specifies more than one day, the event falls on the first day that satisfies the pattern. Required if type is weekly, relativeMonthly, or relativeYearly.' firstDayOfWeek: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.dayOfWeek' - - type: object - nullable: true - description: 'The first day of the week. The possible values are: sunday, monday, tuesday, wednesday, thursday, friday, saturday. Default is sunday. Required if type is weekly.' + $ref: '#/components/schemas/microsoft.graph.dayOfWeek' index: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.weekIndex' - - type: object - nullable: true - description: 'Specifies on which instance of the allowed days specified in daysOfWeek the event occurs, counted from the first instance in the month. The possible values are: first, second, third, fourth, last. Default is first. Optional and used if type is relativeMonthly or relativeYearly.' + $ref: '#/components/schemas/microsoft.graph.weekIndex' interval: maximum: 2147483647 minimum: -2147483648 @@ -1059,13 +734,14 @@ components: description: The month in which the event occurs. This is a number from 1 to 12. format: int32 type: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.recurrencePatternType' - - type: object - nullable: true - description: 'The recurrence pattern type: daily, weekly, absoluteMonthly, relativeMonthly, absoluteYearly, relativeYearly. Required. For more information, see values of type property.' + $ref: '#/components/schemas/microsoft.graph.recurrencePatternType' + '@odata.type': + type: string + description: 'The frequency of an event. For access reviews: Do not specify this property for a one-time access review. Only interval, dayOfMonth, and type (weekly, absoluteMonthly) properties of recurrencePattern are supported.' microsoft.graph.recurrenceRange: title: recurrenceRange + required: + - '@odata.type' type: object properties: endDate: @@ -1091,11 +767,10 @@ components: format: date nullable: true type: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.recurrenceRangeType' - - type: object - nullable: true - description: 'The recurrence range. The possible values are: endDate, noEnd, numbered. Required.' + $ref: '#/components/schemas/microsoft.graph.recurrenceRangeType' + '@odata.type': + type: string + description: The duration of an event. microsoft.graph.responseType: title: responseType enum: @@ -1106,69 +781,7 @@ components: - declined - notResponded type: string - microsoft.graph.calendarColor: - title: calendarColor - enum: - - auto - - lightBlue - - lightGreen - - lightOrange - - lightGray - - lightYellow - - lightTeal - - lightPink - - lightBrown - - lightRed - - maxColor - type: string - microsoft.graph.calendarPermission: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: calendarPermission - type: object - properties: - allowedRoles: - type: array - items: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.calendarRoleType' - - type: object - nullable: true - description: 'List of allowed sharing or delegating permission levels for the calendar. Possible values are: none, freeBusyRead, limitedRead, read, write, delegateWithoutPrivateEventAccess, delegateWithPrivateEventAccess, custom.' - emailAddress: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.emailAddress' - - type: object - nullable: true - description: 'Represents a share recipient or delegate who has access to the calendar. For the ''My Organization'' share recipient, the address property is null. Read-only.' - isInsideOrganization: - type: boolean - description: True if the user in context (recipient or delegate) is inside the same organization as the calendar owner. - nullable: true - isRemovable: - type: boolean - description: 'True if the user can be removed from the list of recipients or delegates for the specified calendar, false otherwise. The ''My organization'' user determines the permissions other people within your organization have to the given calendar. You can''t remove ''My organization'' as a share recipient to a calendar.' - nullable: true - role: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.calendarRoleType' - - type: object - nullable: true - description: Current permission level of the calendar share recipient or delegate. - microsoft.graph.attendeeType: - title: attendeeType - enum: - - required - - optional - - resource - type: string - ReferenceNumeric: - enum: - - '-INF' - - INF - - NaN - type: string - nullable: true + description: 'The response type. Possible values are: none, organizer, tentativelyAccepted, accepted, declined, notResponded.To differentiate between none and notResponded: none – from organizer''s perspective. This value is used when the status of an attendee/participant is reported to the organizer of a meeting. notResponded – from attendee''s perspective. Indicates the attendee has not responded to the meeting request. Clients can treat notResponded == none. As an example, if attendee Alex hasn''t responded to a meeting request, getting Alex'' response status for that event in Alex'' calendar returns notResponded. Getting Alex'' response from the calendar of any other attendee or the organizer''s returns none. Getting the organizer''s response for the event in anybody''s calendar also returns none.' microsoft.graph.phoneType: title: phoneType enum: @@ -1183,6 +796,7 @@ components: - pager - radio type: string + description: 'The type of phone number. The possible values are: home, business, mobile, other, assistant, homeFax, businessFax, otherFax, pager, radio.' microsoft.graph.dayOfWeek: title: dayOfWeek enum: @@ -1203,6 +817,7 @@ components: - fourth - last type: string + description: 'Specifies on which instance of the allowed days specified in daysOfWeek the event occurs, counted from the first instance in the month. The possible values are: first, second, third, fourth, last. Default is first. Optional and used if type is relativeMonthly or relativeYearly.' microsoft.graph.recurrencePatternType: title: recurrencePatternType enum: @@ -1213,6 +828,7 @@ components: - absoluteYearly - relativeYearly type: string + description: 'The recurrence pattern type: daily, weekly, absoluteMonthly, relativeMonthly, absoluteYearly, relativeYearly. Required. For more information, see values of type property.' microsoft.graph.recurrenceRangeType: title: recurrenceRangeType enum: @@ -1220,18 +836,7 @@ components: - noEnd - numbered type: string - microsoft.graph.calendarRoleType: - title: calendarRoleType - enum: - - none - - freeBusyRead - - limitedRead - - read - - write - - delegateWithoutPrivateEventAccess - - delegateWithPrivateEventAccess - - custom - type: string + description: 'The recurrence range. The possible values are: endDate, noEnd, numbered. Required.' responses: microsoft.graph.eventCollectionResponse: description: Retrieved collection @@ -1239,12 +844,6 @@ components: application/json: schema: $ref: '#/components/schemas/microsoft.graph.eventCollectionResponse' - error: - description: error - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.ODataError' parameters: top: name: $top diff --git a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/ContactsPlugin/contacts-openapi.yml b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/ContactsPlugin/contacts-openapi.yml index 695a3232015b..579348a21282 100644 --- a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/ContactsPlugin/contacts-openapi.yml +++ b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/ContactsPlugin/contacts-openapi.yml @@ -12,9 +12,6 @@ paths: - me.contact summary: List contacts description: 'Get a contact collection from the default contacts folder of the signed-in user. There are two scenarios where an app can get contacts in another user''s contact folder:' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/user-list-contacts?view=graph-rest-1.0 operationId: me_ListContacts parameters: - $ref: '#/components/parameters/top' @@ -31,83 +28,6 @@ paths: uniqueItems: true type: array items: - enum: - - id - - id desc - - categories - - categories desc - - changeKey - - changeKey desc - - createdDateTime - - createdDateTime desc - - lastModifiedDateTime - - lastModifiedDateTime desc - - assistantName - - assistantName desc - - birthday - - birthday desc - - businessAddress - - businessAddress desc - - businessHomePage - - businessHomePage desc - - businessPhones - - businessPhones desc - - children - - children desc - - companyName - - companyName desc - - department - - department desc - - displayName - - displayName desc - - emailAddresses - - emailAddresses desc - - fileAs - - fileAs desc - - generation - - generation desc - - givenName - - givenName desc - - homeAddress - - homeAddress desc - - homePhones - - homePhones desc - - imAddresses - - imAddresses desc - - initials - - initials desc - - jobTitle - - jobTitle desc - - manager - - manager desc - - middleName - - middleName desc - - mobilePhone - - mobilePhone desc - - nickName - - nickName desc - - officeLocation - - officeLocation desc - - otherAddress - - otherAddress desc - - parentFolderId - - parentFolderId desc - - personalNotes - - personalNotes desc - - profession - - profession desc - - spouseName - - spouseName desc - - surname - - surname desc - - title - - title desc - - yomiCompanyName - - yomiCompanyName desc - - yomiGivenName - - yomiGivenName desc - - yomiSurname - - yomiSurname desc type: string - name: $select in: query @@ -118,49 +38,6 @@ paths: uniqueItems: true type: array items: - enum: - - id - - categories - - changeKey - - createdDateTime - - lastModifiedDateTime - - assistantName - - birthday - - businessAddress - - businessHomePage - - businessPhones - - children - - companyName - - department - - displayName - - emailAddresses - - fileAs - - generation - - givenName - - homeAddress - - homePhones - - imAddresses - - initials - - jobTitle - - manager - - middleName - - mobilePhone - - nickName - - officeLocation - - otherAddress - - parentFolderId - - personalNotes - - profession - - spouseName - - surname - - title - - yomiCompanyName - - yomiGivenName - - yomiSurname - - extensions - - multiValueExtendedProperties - - photo - - singleValueExtendedProperties type: string - name: $expand in: query @@ -171,18 +48,10 @@ paths: uniqueItems: true type: array items: - enum: - - '*' - - extensions - - multiValueExtendedProperties - - photo - - singleValueExtendedProperties type: string responses: - '200': + 2XX: $ref: '#/components/responses/microsoft.graph.contactCollectionResponse' - default: - $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore @@ -190,256 +59,211 @@ paths: components: schemas: microsoft.graph.contactCollectionResponse: - title: Collection of contact - type: object - allOf: - - $ref: '#/components/schemas/BaseCollectionPaginationCountResponse' - - type: object - properties: - value: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.contact' - microsoft.graph.ODataErrors.ODataError: - required: - - error - type: object - properties: - error: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.MainError' - BaseCollectionPaginationCountResponse: title: Base collection pagination and count responses type: object properties: + '@odata.count': + type: integer + format: int64 + nullable: true '@odata.nextLink': type: string nullable: true + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.contact' microsoft.graph.contact: - allOf: - - $ref: '#/components/schemas/microsoft.graph.outlookItem' - - title: contact - type: object - properties: - assistantName: - type: string - description: The name of the contact's assistant. - nullable: true - birthday: - pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' - type: string - description: 'The contact''s birthday. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' - format: date-time - nullable: true - businessAddress: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.physicalAddress' - - type: object - nullable: true - description: The contact's business address. - businessHomePage: - type: string - description: The business home page of the contact. - nullable: true - businessPhones: - type: array - items: - type: string - nullable: true - description: The contact's business phone numbers. - children: - type: array - items: - type: string - nullable: true - description: The names of the contact's children. - companyName: - type: string - description: The name of the contact's company. - nullable: true - department: - type: string - description: The contact's department. - nullable: true - displayName: - type: string - description: 'The contact''s display name. You can specify the display name in a create or update operation. Note that later updates to other properties may cause an automatically generated value to overwrite the displayName value you have specified. To preserve a pre-existing value, always include it as displayName in an update operation.' - nullable: true - emailAddresses: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.emailAddress' - description: The contact's email addresses. - fileAs: - type: string - description: The name the contact is filed under. - nullable: true - generation: - type: string - description: The contact's suffix. - nullable: true - givenName: - type: string - description: The contact's given name. - nullable: true - homeAddress: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.physicalAddress' - - type: object - nullable: true - description: The contact's home address. - homePhones: - type: array - items: - type: string - nullable: true - description: The contact's home phone numbers. - imAddresses: - type: array - items: - type: string - nullable: true - description: The contact's instant messaging (IM) addresses. - initials: - type: string - description: The contact's initials. - nullable: true - jobTitle: - type: string - description: The contact’s job title. - nullable: true - manager: - type: string - description: The name of the contact's manager. - nullable: true - middleName: - type: string - description: The contact's middle name. - nullable: true - mobilePhone: - type: string - description: The contact's mobile phone number. - nullable: true - nickName: - type: string - description: The contact's nickname. - nullable: true - officeLocation: - type: string - description: The location of the contact's office. - nullable: true - otherAddress: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.physicalAddress' - - type: object - nullable: true - description: Other addresses for the contact. - parentFolderId: - type: string - description: The ID of the contact's parent folder. - nullable: true - personalNotes: - type: string - description: The user's notes about the contact. - nullable: true - profession: - type: string - description: The contact's profession. - nullable: true - spouseName: - type: string - description: The name of the contact's spouse/partner. - nullable: true - surname: - type: string - description: The contact's surname. - nullable: true - title: - type: string - description: The contact's title. - nullable: true - yomiCompanyName: - type: string - description: The phonetic Japanese company name of the contact. - nullable: true - yomiGivenName: - type: string - description: The phonetic Japanese given name (first name) of the contact. - nullable: true - yomiSurname: - type: string - description: The phonetic Japanese surname (last name) of the contact. - nullable: true - extensions: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.extension' - description: The collection of open extensions defined for the contact. Read-only. Nullable. - multiValueExtendedProperties: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty' - description: The collection of multi-value extended properties defined for the contact. Read-only. Nullable. - photo: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.profilePhoto' - - type: object - nullable: true - description: Optional contact picture. You can get or set a photo for a contact. - singleValueExtendedProperties: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty' - description: The collection of single-value extended properties defined for the contact. Read-only. Nullable. - microsoft.graph.ODataErrors.MainError: + title: contact required: - - code - - message + - '@odata.type' type: object properties: - code: + id: type: string - message: + description: The unique identifier for an entity. Read-only. + '@odata.type': type: string - x-ms-primary-error-message: true - target: + categories: + type: array + items: + type: string + nullable: true + description: The categories associated with the item + changeKey: + type: string + description: 'Identifies the version of the item. Every time the item is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.' + nullable: true + createdDateTime: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' + type: string + description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + lastModifiedDateTime: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' + type: string + description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + assistantName: + type: string + description: The name of the contact's assistant. + nullable: true + birthday: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' type: string + description: 'The contact''s birthday. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time nullable: true - details: + businessAddress: + $ref: '#/components/schemas/microsoft.graph.physicalAddress' + businessHomePage: + type: string + description: The business home page of the contact. + nullable: true + businessPhones: type: array items: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.ErrorDetails' - innerError: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.InnerError' - microsoft.graph.outlookItem: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: outlookItem - type: object - properties: - categories: - type: array - items: - type: string - nullable: true - description: The categories associated with the item - changeKey: - type: string - description: 'Identifies the version of the item. Every time the item is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.' - nullable: true - createdDateTime: - pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' - type: string - description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' - format: date-time - nullable: true - lastModifiedDateTime: - pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' - type: string - description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' - format: date-time - nullable: true + type: string + nullable: true + description: The contact's business phone numbers. + children: + type: array + items: + type: string + nullable: true + description: The names of the contact's children. + companyName: + type: string + description: The name of the contact's company. + nullable: true + department: + type: string + description: The contact's department. + nullable: true + displayName: + type: string + description: 'The contact''s display name. You can specify the display name in a create or update operation. Note that later updates to other properties may cause an automatically generated value to overwrite the displayName value you have specified. To preserve a pre-existing value, always include it as displayName in an update operation.' + nullable: true + emailAddresses: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.emailAddress' + description: The contact's email addresses. + fileAs: + type: string + description: The name the contact is filed under. + nullable: true + generation: + type: string + description: The contact's suffix. + nullable: true + givenName: + type: string + description: The contact's given name. + nullable: true + homeAddress: + $ref: '#/components/schemas/microsoft.graph.physicalAddress' + homePhones: + type: array + items: + type: string + nullable: true + description: The contact's home phone numbers. + imAddresses: + type: array + items: + type: string + nullable: true + description: The contact's instant messaging (IM) addresses. + initials: + type: string + description: The contact's initials. + nullable: true + jobTitle: + type: string + description: The contact’s job title. + nullable: true + manager: + type: string + description: The name of the contact's manager. + nullable: true + middleName: + type: string + description: The contact's middle name. + nullable: true + mobilePhone: + type: string + description: The contact's mobile phone number. + nullable: true + nickName: + type: string + description: The contact's nickname. + nullable: true + officeLocation: + type: string + description: The location of the contact's office. + nullable: true + otherAddress: + $ref: '#/components/schemas/microsoft.graph.physicalAddress' + parentFolderId: + type: string + description: The ID of the contact's parent folder. + nullable: true + personalNotes: + type: string + description: The user's notes about the contact. + nullable: true + profession: + type: string + description: The contact's profession. + nullable: true + spouseName: + type: string + description: The name of the contact's spouse/partner. + nullable: true + surname: + type: string + description: The contact's surname. + nullable: true + title: + type: string + description: The contact's title. + nullable: true + yomiCompanyName: + type: string + description: The phonetic Japanese company name of the contact. + nullable: true + yomiGivenName: + type: string + description: The phonetic Japanese given name (first name) of the contact. + nullable: true + yomiSurname: + type: string + description: The phonetic Japanese surname (last name) of the contact. + nullable: true + extensions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.extension' + description: The collection of open extensions defined for the contact. Read-only. Nullable. + multiValueExtendedProperties: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty' + description: The collection of multi-value extended properties defined for the contact. Read-only. Nullable. + photo: + $ref: '#/components/schemas/microsoft.graph.profilePhoto' + singleValueExtendedProperties: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty' + description: The collection of single-value extended properties defined for the contact. Read-only. Nullable. microsoft.graph.physicalAddress: title: physicalAddress + required: + - '@odata.type' type: object properties: city: @@ -462,8 +286,13 @@ components: type: string description: The street. nullable: true + '@odata.type': + type: string + description: The contact's business address. microsoft.graph.emailAddress: title: emailAddress + required: + - '@odata.type' type: object properties: address: @@ -474,76 +303,53 @@ components: type: string description: The display name of the person or entity. nullable: true + '@odata.type': + type: string microsoft.graph.extension: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: extension - type: object - microsoft.graph.multiValueLegacyExtendedProperty: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: multiValueLegacyExtendedProperty - type: object - properties: - value: - type: array - items: - type: string - nullable: true - description: A collection of property values. - microsoft.graph.profilePhoto: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: profilePhoto - type: object - properties: - height: - maximum: 2147483647 - minimum: -2147483648 - type: number - description: The height of the photo. Read-only. - format: int32 - nullable: true - width: - maximum: 2147483647 - minimum: -2147483648 - type: number - description: The width of the photo. Read-only. - format: int32 - nullable: true - microsoft.graph.singleValueLegacyExtendedProperty: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: singleValueLegacyExtendedProperty - type: object - properties: - value: - type: string - description: A property value. - nullable: true - microsoft.graph.ODataErrors.ErrorDetails: + title: extension required: - - code - - message + - '@odata.type' type: object properties: - code: - type: string - message: + id: type: string - target: + description: The unique identifier for an entity. Read-only. + '@odata.type': type: string - nullable: true - microsoft.graph.ODataErrors.InnerError: + microsoft.graph.multiValueLegacyExtendedProperty: + title: multiValueLegacyExtendedProperty + required: + - '@odata.type' type: object - description: The structure of this object is service-specific - microsoft.graph.entity: - title: entity + properties: + id: + type: string + description: The unique identifier for an entity. Read-only. + '@odata.type': + type: string + value: + type: array + items: + type: string + nullable: true + description: A collection of property values. + microsoft.graph.profilePhoto: + description: Optional contact picture. You can get or set a photo for a contact. + microsoft.graph.singleValueLegacyExtendedProperty: + title: singleValueLegacyExtendedProperty + required: + - '@odata.type' type: object properties: id: type: string description: The unique identifier for an entity. Read-only. + '@odata.type': + type: string + value: + type: string + description: A property value. + nullable: true responses: microsoft.graph.contactCollectionResponse: description: Retrieved collection @@ -551,12 +357,6 @@ components: application/json: schema: $ref: '#/components/schemas/microsoft.graph.contactCollectionResponse' - error: - description: error - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.ODataError' parameters: top: name: $top diff --git a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/DriveItemPlugin/driveitem-openapi.yml b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/DriveItemPlugin/driveitem-openapi.yml index 9814212c23d5..927ab725e2c7 100644 --- a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/DriveItemPlugin/driveitem-openapi.yml +++ b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/DriveItemPlugin/driveitem-openapi.yml @@ -6,21 +6,14 @@ info: servers: - url: https://graph.microsoft.com/v1.0 paths: - '/drive/root/children/{driveItem-id}/content': + '/drives/{drive-id}/items/{driveItem-id}/content': get: tags: - - drive.driveItem - summary: Get content for the navigation property children from drive + - drives.driveItem + summary: Get content for the navigation property items from drives description: 'The content stream, if the item represents a file.' - operationId: drive_root_GetChildrenContent + operationId: drives_GetItemsContent parameters: - - name: driveItem-id - in: path - description: The unique identifier of driveItem - required: true - style: simple - schema: - type: string - name: $format in: query description: Format of the content @@ -29,64 +22,26 @@ paths: schema: type: string responses: - '200': + 2XX: description: Retrieved media content content: application/octet-stream: schema: type: string format: binary - default: - $ref: '#/components/responses/error' -components: - schemas: - microsoft.graph.ODataErrors.ODataError: - required: - - error - type: object - properties: - error: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.MainError' - microsoft.graph.ODataErrors.MainError: - required: - - code - - message - type: object - properties: - code: - type: string - message: - type: string - x-ms-primary-error-message: true - target: + parameters: + - name: drive-id + in: path + description: The unique identifier of drive + required: true + style: simple + schema: type: string - nullable: true - details: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.ErrorDetails' - innerError: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.InnerError' - microsoft.graph.ODataErrors.ErrorDetails: - required: - - code - - message - type: object - properties: - code: + - name: driveItem-id + in: path + description: The unique identifier of driveItem + required: true + style: simple + schema: type: string - message: - type: string - target: - type: string - nullable: true - microsoft.graph.ODataErrors.InnerError: - type: object - description: The structure of this object is service-specific - responses: - error: - description: error - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.ODataError' \ No newline at end of file +components: { } \ No newline at end of file diff --git a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/MessagesPlugin/messages-apiplugin.json b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/MessagesPlugin/messages-apiplugin.json index ecf9a10c0782..a3fac7f88fb2 100644 --- a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/MessagesPlugin/messages-apiplugin.json +++ b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/MessagesPlugin/messages-apiplugin.json @@ -9,21 +9,21 @@ "capabilities": { "conversation_starters": [ { - "text": "Get open extension" + "text": "List messages" }, { - "text": "Create open extension" + "text": "Create message" } ] }, "functions": [ { "name": "me_CreateMessages", - "description": "Create an open extension (openTypeExtension object) and add custom properties in a new or existing instance of a resource. You can create an open extension in a resource instance and store custom data to it all in the same operation, except for specific resources. The table in the Permissions section lists the resources that support open extensions." + "description": "Create a draft of a new message in either JSON or MIME format. When using JSON format, you can:\n- Include an attachment to the message.\n- Update the draft later to add content to the body or change other message properties. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- /* Add any attachments and S/MIME properties to the MIME content. By default, this operation saves the draft in the Drafts folder. Send the draft message in a subsequent operation. Alternatively, send a new message in a single operation, or create a draft to forward, reply and reply-all to an existing message." }, { "name": "me_ListMessages", - "description": "Get an open extension (openTypeExtension object) identified by name or fully qualified name. The table in the Permissions section lists the resources that support open extensions. The following table lists the three scenarios where you can get an open extension from a supported resource instance." + "description": "Get the messages in the signed-in user\u0026apos;s mailbox (including the Deleted Items and Clutter folders). Depending on the page size and mailbox data, getting messages from a mailbox can incur multiple requests. The default page size is 10 messages. Use $top to customize the page size, within the range of 1 and 1000. To improve the operation response time, use $select to specify the exact properties you need; see example 1 below. Fine-tune the values for $select and $top, especially when you must use a larger page size, as returning a page with hundreds of messages each with a full response payload may trigger the gateway timeout (HTTP 504). To get the next page of messages, simply apply the entire URL returned in @odata.nextLink to the next get-messages request. This URL includes any query parameters you may have specified in the initial request. Do not try to extract the $skip value from the @odata.nextLink URL to manipulate responses. This API uses the $skip value to keep count of all the items it has gone through in the user\u0026apos;s mailbox to return a page of message-type items. It\u0026apos;s therefore possible that even in the initial response, the $skip value is larger than the page size. For more information, see Paging Microsoft Graph data in your app. Currently, this operation returns message bodies in only HTML format. There are two scenarios where an app can get messages in another user\u0026apos;s mail folder:" } ], "runtimes": [ diff --git a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/MessagesPlugin/messages-openapi.yml b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/MessagesPlugin/messages-openapi.yml index f9c7b11e712b..7903450f0c53 100644 --- a/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/MessagesPlugin/messages-openapi.yml +++ b/dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/MessagesPlugin/messages-openapi.yml @@ -10,11 +10,8 @@ paths: get: tags: - me.message - summary: Get open extension - description: Get an open extension (openTypeExtension object) identified by name or fully qualified name. The table in the Permissions section lists the resources that support open extensions. The following table lists the three scenarios where you can get an open extension from a supported resource instance. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/opentypeextension-get?view=graph-rest-1.0 + summary: List messages + description: 'Get the messages in the signed-in user''s mailbox (including the Deleted Items and Clutter folders). Depending on the page size and mailbox data, getting messages from a mailbox can incur multiple requests. The default page size is 10 messages. Use $top to customize the page size, within the range of 1 and 1000. To improve the operation response time, use $select to specify the exact properties you need; see example 1 below. Fine-tune the values for $select and $top, especially when you must use a larger page size, as returning a page with hundreds of messages each with a full response payload may trigger the gateway timeout (HTTP 504). To get the next page of messages, simply apply the entire URL returned in @odata.nextLink to the next get-messages request. This URL includes any query parameters you may have specified in the initial request. Do not try to extract the $skip value from the @odata.nextLink URL to manipulate responses. This API uses the $skip value to keep count of all the items it has gone through in the user''s mailbox to return a page of message-type items. It''s therefore possible that even in the initial response, the $skip value is larger than the page size. For more information, see Paging Microsoft Graph data in your app. Currently, this operation returns message bodies in only HTML format. There are two scenarios where an app can get messages in another user''s mail folder:' operationId: me_ListMessages parameters: - name: includeHiddenMessages @@ -38,69 +35,6 @@ paths: uniqueItems: true type: array items: - enum: - - id - - id desc - - categories - - categories desc - - changeKey - - changeKey desc - - createdDateTime - - createdDateTime desc - - lastModifiedDateTime - - lastModifiedDateTime desc - - bccRecipients - - bccRecipients desc - - body - - body desc - - bodyPreview - - bodyPreview desc - - ccRecipients - - ccRecipients desc - - conversationId - - conversationId desc - - conversationIndex - - conversationIndex desc - - flag - - flag desc - - from - - from desc - - hasAttachments - - hasAttachments desc - - importance - - importance desc - - inferenceClassification - - inferenceClassification desc - - internetMessageHeaders - - internetMessageHeaders desc - - internetMessageId - - internetMessageId desc - - isDeliveryReceiptRequested - - isDeliveryReceiptRequested desc - - isDraft - - isDraft desc - - isRead - - isRead desc - - isReadReceiptRequested - - isReadReceiptRequested desc - - parentFolderId - - parentFolderId desc - - receivedDateTime - - receivedDateTime desc - - replyTo - - replyTo desc - - sender - - sender desc - - sentDateTime - - sentDateTime desc - - subject - - subject desc - - toRecipients - - toRecipients desc - - uniqueBody - - uniqueBody desc - - webLink - - webLink desc type: string - name: $select in: query @@ -111,42 +45,6 @@ paths: uniqueItems: true type: array items: - enum: - - id - - categories - - changeKey - - createdDateTime - - lastModifiedDateTime - - bccRecipients - - body - - bodyPreview - - ccRecipients - - conversationId - - conversationIndex - - flag - - from - - hasAttachments - - importance - - inferenceClassification - - internetMessageHeaders - - internetMessageId - - isDeliveryReceiptRequested - - isDraft - - isRead - - isReadReceiptRequested - - parentFolderId - - receivedDateTime - - replyTo - - sender - - sentDateTime - - subject - - toRecipients - - uniqueBody - - webLink - - attachments - - extensions - - multiValueExtendedProperties - - singleValueExtendedProperties type: string - name: $expand in: query @@ -157,18 +55,10 @@ paths: uniqueItems: true type: array items: - enum: - - '*' - - attachments - - extensions - - multiValueExtendedProperties - - singleValueExtendedProperties type: string responses: - '200': + 2XX: $ref: '#/components/responses/microsoft.graph.messageCollectionResponse' - default: - $ref: '#/components/responses/error' x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore @@ -176,224 +66,194 @@ paths: post: tags: - me.message - summary: Create open extension - description: 'Create an open extension (openTypeExtension object) and add custom properties in a new or existing instance of a resource. You can create an open extension in a resource instance and store custom data to it all in the same operation, except for specific resources. The table in the Permissions section lists the resources that support open extensions.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/opentypeextension-post-opentypeextension?view=graph-rest-1.0 + summary: Create message + description: "Create a draft of a new message in either JSON or MIME format. When using JSON format, you can:\n- Include an attachment to the message.\n- Update the draft later to add content to the body or change other message properties. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- /* Add any attachments and S/MIME properties to the MIME content. By default, this operation saves the draft in the Drafts folder. Send the draft message in a subsequent operation. Alternatively, send a new message in a single operation, or create a draft to forward, reply and reply-all to an existing message." operationId: me_CreateMessages requestBody: description: New navigation property content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.outlookItem' + $ref: '#/components/schemas/microsoft.graph.message' required: true responses: - '201': + 2XX: description: Created navigation property. content: application/json: schema: $ref: '#/components/schemas/microsoft.graph.message' - default: - $ref: '#/components/responses/error' components: schemas: microsoft.graph.message: - allOf: - - $ref: '#/components/schemas/microsoft.graph.outlookItem' - - title: message - type: object - properties: - bccRecipients: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.recipient' - description: 'The Bcc: recipients for the message.' - body: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.itemBody' - - type: object - nullable: true - description: The body of the message. It can be in HTML or text format. Find out about safe HTML in a message body. - bodyPreview: - type: string - description: The first 255 characters of the message body. It is in text format. - nullable: true - ccRecipients: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.recipient' - description: 'The Cc: recipients for the message.' - conversationId: - type: string - description: The ID of the conversation the email belongs to. - nullable: true - conversationIndex: - type: string - description: Indicates the position of the message within the conversation. - format: base64url - nullable: true - flag: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.followupFlag' - - type: object - nullable: true - description: 'The flag value that indicates the status, start date, due date, or completion date for the message.' - from: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.recipient' - - type: object - nullable: true - description: 'The owner of the mailbox from which the message is sent. In most cases, this value is the same as the sender property, except for sharing or delegation scenarios. The value must correspond to the actual mailbox used. Find out more about setting the from and sender properties of a message.' - hasAttachments: - type: boolean - description: 'Indicates whether the message has attachments. This property doesn''t include inline attachments, so if a message contains only inline attachments, this property is false. To verify the existence of inline attachments, parse the body property to look for a src attribute, such as .' - nullable: true - importance: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.importance' - - type: object - nullable: true - description: 'The importance of the message. The possible values are: low, normal, and high.' - inferenceClassification: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.inferenceClassificationType' - - type: object - nullable: true - description: 'The classification of the message for the user, based on inferred relevance or importance, or on an explicit override. The possible values are: focused or other.' - internetMessageHeaders: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.internetMessageHeader' - description: A collection of message headers defined by RFC5322. The set includes message headers indicating the network path taken by a message from the sender to the recipient. It can also contain custom message headers that hold app data for the message. Returned only on applying a $select query option. Read-only. - internetMessageId: - type: string - description: The message ID in the format specified by RFC2822. - nullable: true - isDeliveryReceiptRequested: - type: boolean - description: Indicates whether a read receipt is requested for the message. - nullable: true - isDraft: - type: boolean - description: Indicates whether the message is a draft. A message is a draft if it hasn't been sent yet. - nullable: true - isRead: - type: boolean - description: Indicates whether the message has been read. - nullable: true - isReadReceiptRequested: - type: boolean - description: Indicates whether a read receipt is requested for the message. - nullable: true - parentFolderId: - type: string - description: The unique identifier for the message's parent mailFolder. - nullable: true - receivedDateTime: - pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' - type: string - description: 'The date and time the message was received. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.' - format: date-time - nullable: true - replyTo: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.recipient' - description: The email addresses to use when replying. - sender: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.recipient' - - type: object - nullable: true - description: 'The account that is actually used to generate the message. In most cases, this value is the same as the from property. You can set this property to a different value when sending a message from a shared mailbox, for a shared calendar, or as a delegate. In any case, the value must correspond to the actual mailbox used. Find out more about setting the from and sender properties of a message.' - sentDateTime: - pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' - type: string - description: 'The date and time the message was sent. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.' - format: date-time - nullable: true - subject: - type: string - description: The subject of the message. - nullable: true - toRecipients: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.recipient' - description: 'The To: recipients for the message.' - uniqueBody: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.itemBody' - - type: object - nullable: true - description: The part of the body of the message that is unique to the current message. uniqueBody is not returned by default but can be retrieved for a given message by use of the ?$select=uniqueBody query. It can be in HTML or text format. - webLink: - type: string - description: 'The URL to open the message in Outlook on the web.You can append an ispopout argument to the end of the URL to change how the message is displayed. If ispopout is not present or if it is set to 1, then the message is shown in a popout window. If ispopout is set to 0, the browser shows the message in the Outlook on the web review pane.The message opens in the browser if you are signed in to your mailbox via Outlook on the web. You are prompted to sign in if you are not already signed in with the browser.This URL cannot be accessed from within an iFrame.' - nullable: true - attachments: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.attachment' - description: The fileAttachment and itemAttachment attachments for the message. - extensions: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.extension' - description: The collection of open extensions defined for the message. Nullable. - multiValueExtendedProperties: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty' - description: The collection of multi-value extended properties defined for the message. Nullable. - singleValueExtendedProperties: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty' - description: The collection of single-value extended properties defined for the message. Nullable. - microsoft.graph.outlookItem: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: outlookItem - type: object - properties: - categories: - type: array - items: - type: string - nullable: true - description: The categories associated with the item - changeKey: - type: string - description: 'Identifies the version of the item. Every time the item is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.' - nullable: true - createdDateTime: - pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' - type: string - description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' - format: date-time - nullable: true - lastModifiedDateTime: - pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' - type: string - description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' - format: date-time - nullable: true + title: message + required: + - '@odata.type' + type: object + properties: + id: + type: string + description: The unique identifier for an entity. Read-only. + '@odata.type': + type: string + categories: + type: array + items: + type: string + nullable: true + description: The categories associated with the item + changeKey: + type: string + description: 'Identifies the version of the item. Every time the item is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.' + nullable: true + createdDateTime: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' + type: string + description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + lastModifiedDateTime: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' + type: string + description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + bccRecipients: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.recipient' + description: 'The Bcc: recipients for the message.' + body: + $ref: '#/components/schemas/microsoft.graph.itemBody' + bodyPreview: + type: string + description: The first 255 characters of the message body. It is in text format. + nullable: true + ccRecipients: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.recipient' + description: 'The Cc: recipients for the message.' + conversationId: + type: string + description: The ID of the conversation the email belongs to. + nullable: true + conversationIndex: + type: string + description: Indicates the position of the message within the conversation. + format: base64url + nullable: true + flag: + $ref: '#/components/schemas/microsoft.graph.followupFlag' + from: + $ref: '#/components/schemas/microsoft.graph.recipient' + hasAttachments: + type: boolean + description: 'Indicates whether the message has attachments. This property doesn''t include inline attachments, so if a message contains only inline attachments, this property is false. To verify the existence of inline attachments, parse the body property to look for a src attribute, such as .' + nullable: true + importance: + $ref: '#/components/schemas/microsoft.graph.importance' + inferenceClassification: + $ref: '#/components/schemas/microsoft.graph.inferenceClassificationType' + internetMessageHeaders: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.internetMessageHeader' + description: A collection of message headers defined by RFC5322. The set includes message headers indicating the network path taken by a message from the sender to the recipient. It can also contain custom message headers that hold app data for the message. Returned only on applying a $select query option. Read-only. + internetMessageId: + type: string + description: The message ID in the format specified by RFC2822. + nullable: true + isDeliveryReceiptRequested: + type: boolean + description: Indicates whether a read receipt is requested for the message. + nullable: true + isDraft: + type: boolean + description: Indicates whether the message is a draft. A message is a draft if it hasn't been sent yet. + nullable: true + isRead: + type: boolean + description: Indicates whether the message has been read. + nullable: true + isReadReceiptRequested: + type: boolean + description: Indicates whether a read receipt is requested for the message. + nullable: true + parentFolderId: + type: string + description: The unique identifier for the message's parent mailFolder. + nullable: true + receivedDateTime: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' + type: string + description: 'The date and time the message was received. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.' + format: date-time + nullable: true + replyTo: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.recipient' + description: The email addresses to use when replying. + sender: + $ref: '#/components/schemas/microsoft.graph.recipient' + sentDateTime: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' + type: string + description: 'The date and time the message was sent. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.' + format: date-time + nullable: true + subject: + type: string + description: The subject of the message. + nullable: true + toRecipients: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.recipient' + description: 'The To: recipients for the message.' + uniqueBody: + $ref: '#/components/schemas/microsoft.graph.itemBody' + webLink: + type: string + description: 'The URL to open the message in Outlook on the web.You can append an ispopout argument to the end of the URL to change how the message is displayed. If ispopout is not present or if it is set to 1, then the message is shown in a popout window. If ispopout is set to 0, the browser shows the message in the Outlook on the web review pane.The message opens in the browser if you are signed in to your mailbox via Outlook on the web. You are prompted to sign in if you are not already signed in with the browser.This URL cannot be accessed from within an iFrame.' + nullable: true + attachments: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.attachment' + description: The fileAttachment and itemAttachment attachments for the message. + extensions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.extension' + description: The collection of open extensions defined for the message. Nullable. + multiValueExtendedProperties: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty' + description: The collection of multi-value extended properties defined for the message. Nullable. + singleValueExtendedProperties: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty' + description: The collection of single-value extended properties defined for the message. Nullable. microsoft.graph.recipient: title: recipient + required: + - '@odata.type' type: object properties: emailAddress: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.emailAddress' - - type: object - nullable: true - description: The recipient's email address. + $ref: '#/components/schemas/microsoft.graph.emailAddress' + '@odata.type': + type: string + discriminator: + propertyName: '@odata.type' microsoft.graph.itemBody: title: itemBody + required: + - '@odata.type' type: object properties: content: @@ -401,39 +261,27 @@ components: description: The content of the item. nullable: true contentType: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.bodyType' - - type: object - nullable: true - description: The type of the content. Possible values are text and html. + $ref: '#/components/schemas/microsoft.graph.bodyType' + '@odata.type': + type: string + description: The body of the message. It can be in HTML or text format. Find out about safe HTML in a message body. microsoft.graph.followupFlag: title: followupFlag + required: + - '@odata.type' type: object properties: completedDateTime: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' - - type: object - nullable: true - description: The date and time that the follow-up was finished. + $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' dueDateTime: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' - - type: object - nullable: true - description: 'The date and time that the follow-up is to be finished. Note: To set the due date, you must also specify the startDateTime; otherwise, you get a 400 Bad Request response.' + $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' flagStatus: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.followupFlagStatus' - - type: object - nullable: true - description: 'The status for follow-up for an item. Possible values are notFlagged, complete, and flagged.' + $ref: '#/components/schemas/microsoft.graph.followupFlagStatus' startDateTime: - anyOf: - - $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' - - type: object - nullable: true - description: The date and time that the follow-up is to begin. + $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' + '@odata.type': + type: string + description: 'The flag value that indicates the status, start date, due date, or completion date for the message.' microsoft.graph.importance: title: importance enum: @@ -441,14 +289,18 @@ components: - normal - high type: string + description: 'The importance of the message. The possible values are: low, normal, and high.' microsoft.graph.inferenceClassificationType: title: inferenceClassificationType enum: - focused - other type: string + description: 'The classification of the message for the user, based on inferred relevance or importance, or on an explicit override. The possible values are: focused or other.' microsoft.graph.internetMessageHeader: title: internetMessageHeader + required: + - '@odata.type' type: object properties: name: @@ -459,89 +311,104 @@ components: type: string description: The value in a key-value pair. nullable: true + '@odata.type': + type: string microsoft.graph.attachment: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: attachment - type: object - properties: - contentType: - type: string - description: The MIME type. - nullable: true - isInline: - type: boolean - description: 'true if the attachment is an inline attachment; otherwise, false.' - lastModifiedDateTime: - pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' - type: string - description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' - format: date-time - nullable: true - name: - type: string - description: The attachment's file name. - nullable: true - size: - maximum: 2147483647 - minimum: -2147483648 - type: number - description: The length of the attachment in bytes. - format: int32 + title: attachment + required: + - '@odata.type' + type: object + properties: + id: + type: string + description: The unique identifier for an entity. Read-only. + '@odata.type': + type: string + contentType: + type: string + description: The MIME type. + nullable: true + isInline: + type: boolean + description: 'true if the attachment is an inline attachment; otherwise, false.' + lastModifiedDateTime: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$' + type: string + description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + name: + type: string + description: The attachment's file name. + nullable: true + size: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The length of the attachment in bytes. + format: int32 microsoft.graph.extension: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: extension - type: object - microsoft.graph.multiValueLegacyExtendedProperty: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: multiValueLegacyExtendedProperty - type: object - properties: - value: - type: array - items: - type: string - nullable: true - description: A collection of property values. - microsoft.graph.singleValueLegacyExtendedProperty: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' - - title: singleValueLegacyExtendedProperty - type: object - properties: - value: - type: string - description: A property value. - nullable: true - microsoft.graph.messageCollectionResponse: - title: Collection of message + title: extension + required: + - '@odata.type' type: object - allOf: - - $ref: '#/components/schemas/BaseCollectionPaginationCountResponse' - - type: object - properties: - value: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.message' - microsoft.graph.ODataErrors.ODataError: + properties: + id: + type: string + description: The unique identifier for an entity. Read-only. + '@odata.type': + type: string + microsoft.graph.multiValueLegacyExtendedProperty: + title: multiValueLegacyExtendedProperty required: - - error + - '@odata.type' type: object properties: - error: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.MainError' - microsoft.graph.entity: - title: entity + id: + type: string + description: The unique identifier for an entity. Read-only. + '@odata.type': + type: string + value: + type: array + items: + type: string + nullable: true + description: A collection of property values. + microsoft.graph.singleValueLegacyExtendedProperty: + title: singleValueLegacyExtendedProperty + required: + - '@odata.type' type: object properties: id: type: string description: The unique identifier for an entity. Read-only. + '@odata.type': + type: string + value: + type: string + description: A property value. + nullable: true + microsoft.graph.messageCollectionResponse: + title: Base collection pagination and count responses + type: object + properties: + '@odata.count': + type: integer + format: int64 + nullable: true + '@odata.nextLink': + type: string + nullable: true + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.message' microsoft.graph.emailAddress: title: emailAddress + required: + - '@odata.type' type: object properties: address: @@ -552,14 +419,20 @@ components: type: string description: The display name of the person or entity. nullable: true + '@odata.type': + type: string + description: The recipient's email address. microsoft.graph.bodyType: title: bodyType enum: - text - html type: string + description: The type of the content. Possible values are text and html. microsoft.graph.dateTimeTimeZone: title: dateTimeTimeZone + required: + - '@odata.type' type: object properties: dateTime: @@ -569,6 +442,9 @@ components: type: string description: 'Represents a time zone, for example, ''Pacific Standard Time''. See below for more possible values.' nullable: true + '@odata.type': + type: string + description: The date and time that the follow-up was finished. microsoft.graph.followupFlagStatus: title: followupFlagStatus enum: @@ -576,49 +452,7 @@ components: - complete - flagged type: string - BaseCollectionPaginationCountResponse: - title: Base collection pagination and count responses - type: object - properties: - '@odata.nextLink': - type: string - nullable: true - microsoft.graph.ODataErrors.MainError: - required: - - code - - message - type: object - properties: - code: - type: string - message: - type: string - x-ms-primary-error-message: true - target: - type: string - nullable: true - details: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.ErrorDetails' - innerError: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.InnerError' - microsoft.graph.ODataErrors.ErrorDetails: - required: - - code - - message - type: object - properties: - code: - type: string - message: - type: string - target: - type: string - nullable: true - microsoft.graph.ODataErrors.InnerError: - type: object - description: The structure of this object is service-specific + description: 'The status for follow-up for an item. Possible values are notFlagged, complete, and flagged.' responses: microsoft.graph.messageCollectionResponse: description: Retrieved collection @@ -626,12 +460,6 @@ components: application/json: schema: $ref: '#/components/schemas/microsoft.graph.messageCollectionResponse' - error: - description: error - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.ODataErrors.ODataError' parameters: top: name: $top From 68feea661bb167ee402b39f67d3b70f3223685c0 Mon Sep 17 00:00:00 2001 From: Vincent Biret Date: Thu, 28 Nov 2024 11:11:26 -0500 Subject: [PATCH 6/6] chore: adds typo exclusion Signed-off-by: Vincent Biret --- .github/_typos.toml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/.github/_typos.toml b/.github/_typos.toml index c2394c3dd9e1..56dfd9356552 100644 --- a/.github/_typos.toml +++ b/.github/_typos.toml @@ -23,7 +23,8 @@ extend-exclude = [ "PopulationByCountry.csv", "PopulationByAdmin1.csv", "WomensSuffrage.txt", - "SK-dotnet.sln.DotSettings" + "SK-dotnet.sln.DotSettings", + "dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/README.md" ] [default.extend-words]