---
canonical_url: "https://docs.composio.dev/toolkits/microsoft_copilot"
markdown_url: "https://docs.composio.dev/toolkits/microsoft_copilot.md"
product: "platform"
version: null
last_updated: null
---

# Microsoft 365 Copilot

Access Microsoft 365 Copilot retrieval, search, conversations, meeting insights, usage reports, interaction history, tenant administration, agent registration, package management, and Copilot Credit cost management through Microsoft Graph.

- **Category:** ai assistants
- **Auth:** OAUTH2, S2S_OAUTH2
- **Composio-managed OAuth available?** No
- **Tools:** 74
- **Triggers:** 0
- **Slug:** `MICROSOFT_COPILOT`
- **Version:** 00000000_00

## Tools

### Export Interactions

**Slug:** `MICROSOFT_COPILOT_EXPORT_INTERACTIONS`

DEFAULT FOR PRODUCTION: export a licensed user's Microsoft 365 Copilot prompts, responses, accessed resources, and interaction metadata through the stable v1.0 contract. Use Preview Export Interactions only to validate the separate beta endpoint or consume beta additions. Requires app-only S2S_OAUTH2 with admin-consented AiEnterpriseInteraction.Read.All; delegated OAuth unsupported.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque continuation cursor returned by a previous call. Pass it back unchanged; omit it for the first page. |
| `filter` | string | No | Optional documented OData filter. Use appClass eq '<value>' (combined with or when needed), where value is one of IPM.SkypeTeams.Message.Copilot.Word, IPM.SkypeTeams.Message.Copilot.Excel, IPM.SkypeTeams.Message.Copilot.Teams, IPM.SkypeTeams.Message.Copilot.BizChat, IPM.SkypeTeams.Message.Copilot.WebChat, or IPM.SkypeTeams.Message.Copilot.CoworkChat; or use a createdDateTime range with both minimum and maximum boundaries, for example createdDateTime gt 2025-11-24T00:00:00Z and createdDateTime lt 2025-11-25T00:00:00Z. |
| `user_id` | string | Yes | Microsoft Entra user ID whose Copilot interaction history to export. The API also supports deleted users. |
| `page_size` | integer | No | Interactions requested on this page. Microsoft recommends 100 for optimal performance and documents no maximum. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Copilot Package

**Slug:** `MICROSOFT_COPILOT_GET_COPILOT_PACKAGE`

DEFAULT FOR PRODUCTION READS: get detailed information through the stable v1.0 contract for one provider-returned Copilot package ID. Use Preview Get Copilot Package when preparing a beta-only package mutation workflow. Requires Microsoft Agent 365, organization administrator access, and the Microsoft global cloud.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | array | No | Package property names to return through Microsoft Graph $select. |
| `package_id` | string | Yes | Provider-returned Copilot package ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Copilot Limited Mode

**Slug:** `MICROSOFT_COPILOT_GET_LIMITED_MODE`

DEFAULT FOR PRODUCTION: get the tenant's Microsoft 365 Copilot limited-mode settings through the stable v1.0 contract. Use Preview Get Copilot Limited Mode only to validate beta behavior. Requires delegated work or school OAuth and at least the Global Reader role. Global cloud only; application permissions are unsupported.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Meeting Insight

**Slug:** `MICROSOFT_COPILOT_GET_MEETING_INSIGHT`

Get detailed notes, action items, and participant mention events for one meeting insight. Supports delegated work or school OAuth and app-only S2S OAuth with OnlineMeetingAiInsight.Read.All. App-only access also requires an application access policy granted to the user ID in the request path. The organizer must have a Microsoft 365 Copilot license, and the supported, non-expired meeting must have ended and been recorded or transcribed; insight processing can take up to four hours.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | array | No | Insight property names to return through OData $select. Omit to return Microsoft's default detail fields. |
| `user_id` | string | Yes | Microsoft Entra ID of the meeting organizer. |
| `ai_insight_id` | string | Yes | Insight ID returned by List Meeting Insights for this meeting. |
| `online_meeting_id` | string | Yes | Provider-returned online meeting ID containing the insight. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Usage User Detail Report

**Slug:** `MICROSOFT_COPILOT_GET_USAGE_USER_DETAIL_REPORT`

Download the stable v2 CSV containing the latest per-user usage for licensed Microsoft 365 Copilot users. Use this for user-level rows; use User Count Summary or Trend for aggregate adoption. WARNING: the file can contain sensitive user identifiers and activity data; do not log its contents. Supports delegated OAuth and app-only S2S OAuth with Reports.Read.All. Delegated callers additionally need a signed-in user holding an accepted Microsoft Entra limited administrator role; this runtime role requirement does not apply to app-only calls.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `period` | string ("D7" | "D28" | "D90" | "D180" | "ALL") | Yes | Reporting window for the fixed v2 report contract. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Count Summary Report

**Slug:** `MICROSOFT_COPILOT_GET_USER_COUNT_SUMMARY_REPORT`

Download the stable v2 CSV summary of enabled and active Microsoft 365 Copilot users by product. Use this for aggregate totals; use User Count Trend for day-by-day adoption and Usage User Detail for per-user rows. Supports delegated OAuth and app-only S2S OAuth with Reports.Read.All. Delegated callers additionally need a signed-in user holding an accepted Microsoft Entra limited administrator role, such as Global Reader, Usage Summary Reports Reader, Reports Reader, or a supported service administrator; this runtime role requirement does not apply to app-only calls.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `period` | string ("D7" | "D28" | "D90" | "D180" | "ALL") | Yes | Reporting window for the fixed v2 report contract. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Count Trend Report

**Slug:** `MICROSOFT_COPILOT_GET_USER_COUNT_TREND_REPORT`

Download the stable v2 CSV of daily enabled and active Microsoft 365 Copilot user trends. Use this for day-by-day adoption; use User Count Summary for aggregate totals and Usage User Detail for per-user rows. Supports delegated OAuth and app-only S2S OAuth with Reports.Read.All. Delegated callers additionally need a signed-in user holding an accepted Microsoft Entra limited administrator role, such as Global Reader, Usage Summary Reports Reader, Reports Reader, or a supported service administrator; this runtime role requirement does not apply to app-only calls.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `period` | string ("D7" | "D28" | "D90" | "D180" | "ALL") | Yes | Reporting window for the fixed v2 report contract. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Copilot Packages

**Slug:** `MICROSOFT_COPILOT_LIST_COPILOT_PACKAGES`

DEFAULT FOR PRODUCTION INVENTORY: return one server-managed page of Copilot packages through the stable v1.0 contract. Use Preview List Copilot Packages when preparing or verifying a workflow that uses beta-only package mutations. Requires Microsoft Agent 365, organization administrator access, and the Microsoft global cloud. Use only the documented filter combinations and pass next_cursor back unchanged to continue.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque @odata.nextLink returned as next_cursor. Pass it back unchanged and without filter_expression; Microsoft controls the page size and query options. |
| `filter_expression` | string | No | Documented OData $filter expression. Supported fields are supportedHosts, elementTypes, lastModifiedDateTime, platform, requestStatus, and requestType. Request status supports only eq 'pending'; request type supports one eq with publish, activate, access, or update. Request filters can be joined with and and combined only with ge/le lastModifiedDateTime bounds; do not use or, ne, contains, or combine request fields with supportedHosts, elementTypes, or platform. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Meeting Insights

**Slug:** `MICROSOFT_COPILOT_LIST_MEETING_INSIGHTS`

DEFAULT FOR PRODUCTION: list one page of AI insight records through the stable v1.0 contract for a completed, non-expired supported online meeting. Use the preview list only when continuing to Preview Get Meeting Insight for beta-only fields such as recap_url. Supports delegated work or school OAuth and app-only S2S OAuth with OnlineMeetingAiInsight.Read.All. App-only access also requires an application access policy granted to the user ID in the request path. The meeting organizer needs a Microsoft 365 Copilot license; usage-based payment and evaluation modes are unsupported. The meeting must be recorded or transcribed, insights appear only after it ends and can take up to four hours, channel meetings are unsupported, and the API is available only in the Microsoft global cloud.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque continuation cursor returned by a previous call. Pass it back unchanged; omit it for the first page. |
| `select` | array | No | Insight property names to return through OData $select, such as id, callId, contentCorrelationId, createdDateTime, and endDateTime. |
| `user_id` | string | Yes | Microsoft Entra ID of the meeting organizer. |
| `online_meeting_id` | string | Yes | Provider-returned online meeting ID for a completed, non-expired, recorded or transcribed supported meeting. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Add Assigned Group

**Slug:** `MICROSOFT_COPILOT_PREVIEW_ADD_ASSIGNED_GROUP`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Add an existing Entra group reference to a selected-groups spending policy. Requires the current parent policy ETag and sends an absolute beta Graph @odata.id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `etag` | string | Yes | Current provider-returned policy ETag. Pass the quoted strong or weak value unchanged. |
| `group_id` | string | Yes | Existing Microsoft Entra group ID to add by Graph reference. |
| `policy_id` | string | Yes | Spending policy identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Add Email Threshold Recipient

**Slug:** `MICROSOFT_COPILOT_PREVIEW_ADD_EMAIL_THRESHOLD_RECIPIENT`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Link a tenant user as an email threshold recipient through the documented @odata.id reference endpoint. The current provider-returned policy ETag is required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Spending policy ID returned by Microsoft Graph. |
| `user_id` | string | Yes | Microsoft Entra user ID to link as an email threshold recipient. |
| `if_match` | string | Yes | Current provider-returned ETag of the parent spending policy, for example "abc" or W/"7". Pass the quoted strong or weak value unchanged. Fetch the policy again after a precondition failure. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Batch Record Credit Request Decisions

**Slug:** `MICROSOFT_COPILOT_PREVIEW_BATCH_RECORD_CREDIT_REQUEST_DECISIONS`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Approve or reject 1-100 credit requests independently. This operation is not atomic: HTTP 200 can contain per-item failures, and successful items are not rolled back. Requires the signed-in user to be a Global Administrator, Billing Administrator, or AI Administrator. Available only in the Microsoft Graph global service. Microsoft documents this operation, but it is absent from the current live beta metadata and generated beta OpenAPI; rollout availability is unverified.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `requests` | array | Yes | One to 100 independently processed decisions with unique request IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Block Copilot Package

**Slug:** `MICROSOFT_COPILOT_PREVIEW_BLOCK_COPILOT_PACKAGE`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Block one Copilot package to prevent its use. Requires delegated work or school OAuth, Microsoft Agent 365, organization administrator access, and the global cloud.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `package_id` | string | Yes | Provider-returned Copilot package ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Chat in Conversation

**Slug:** `MICROSOFT_COPILOT_PREVIEW_CHAT_IN_CONVERSATION`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Append an irreversible user turn to an existing Copilot conversation and wait for one synchronous response. Use Preview Start Conversation when no conversation exists yet; use this action for subsequent turns. This requires a licensed work or school user. A failed HTTP response can still record the turn.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message` | string | Yes | User message to append to the conversation. |
| `latitude` | number | No | Optional latitude used as a location hint. |
| `file_uris` | array | No | Microsoft Graph OneDrive or SharePoint file URIs to use as context. |
| `longitude` | number | No | Optional longitude used as a location hint. |
| `time_zone` | string | Yes | IANA time-zone name used to localize the answer, such as America/Los_Angeles or UTC. |
| `web_enabled` | boolean | No | Whether web grounding is enabled for this turn; omit to use Microsoft's default. |
| `conversation_id` | string | Yes | Conversation ID returned by Preview Create Conversation. |
| `country_or_region` | string | No | Optional country or region hint for grounding. |
| `additional_context` | array | No | Additional text snippets to ground this turn. |
| `country_or_region_confidence` | number | No | Optional confidence score associated with the country or region hint. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Create Agent Registration

**Slug:** `MICROSOFT_COPILOT_PREVIEW_CREATE_AGENT_REGISTRATION`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Create a Microsoft 365 Copilot agent registration in the global cloud. Supply at least one owner_id or managed_by_app_id; a2a_reference_id also requires a2a_mode.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `a2a_mode` | string ("none" | "oAuthPluginVault" | "apiKeyPluginVault" | "dynamicClientRegistration" | "connectionVault" | "unknownFutureValue") | No | Optional provider-defined mechanism for invoking the Agent2Agent server. |
| `owner_ids` | array | No | Non-empty owner ID list. Required when managed_by_app_id is omitted. |
| `agent_card` | object | No | Optional agent card manifest preserved as arbitrary JSON. |
| `created_by` | string | Yes | Unique ID of the user or application creating the registration. |
| `description` | string | No | Optional agent description. |
| `display_name` | string | Yes | Display name for the agent instance. |
| `source_agent_id` | string | No | Optional agent identifier in the source system. |
| `a2a_reference_id` | string | No | Optional Microsoft-side configuration reference for the selected A2A mode. This is an identifier, not a secret or account credential. |
| `agent_identity_id` | string | No | Optional Microsoft Entra agent identity identifier. |
| `last_published_by` | string | No | Optional ID of the last person to publish the agent. |
| `managed_by_app_id` | string | No | Application ID responsible for managing the agent. Required when owner_ids is omitted. |
| `originating_store` | string | No | Optional store or source system where the agent originated. |
| `source_created_date_time` | string | Yes | Timezone-aware timestamp when the agent was created in its source system. |
| `agent_identity_blueprint_id` | string | No | Optional agent identity blueprint identifier. |
| `source_last_modified_date_time` | string | Yes | Timezone-aware timestamp when the agent was last modified in its source system. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Create Conversation

**Slug:** `MICROSOFT_COPILOT_PREVIEW_CREATE_CONVERSATION`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Create an empty Microsoft 365 Copilot conversation for later chat turns. Use Preview Start Conversation for the common create-and-send-first-turn workflow; use this action only when an empty conversation ID is independently needed. This requires a licensed work or school user and all seven delegated Chat permissions. Microsoft documents no delete operation for this surface, so the created conversation cannot be cleaned up through this toolkit.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Create Service Setting

**Slug:** `MICROSOFT_COPILOT_PREVIEW_CREATE_SERVICE_SETTING`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Add one governed service setting to a Copilot spending policy. The collection merges by serviceId, and the current provider-returned policy ETag is required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Spending policy ID returned by Microsoft Graph. |
| `state` | string ("enabled" | "disabled" | "unknownFutureValue") | Yes | Initial service state. Use disabled to retain the setting without access. |
| `if_match` | string | Yes | Current provider-returned ETag of the parent spending policy, for example "abc" or W/"7". Pass the quoted strong or weak value unchanged. Fetch the policy again after a precondition failure. |
| `service_id` | string | Yes | Governed Copilot service identifier to add to the spending policy. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Create Spending Policy

**Slug:** `MICROSOFT_COPILOT_PREVIEW_CREATE_SPENDING_POLICY`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Create a disabled all-users or selected-groups Copilot Credit spending policy. Requires a Billing Administrator or Global Administrator; nonempty inline groups also require the assignment-write permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `policy_type` | string ("allUsersSpendingPolicy" | "selectedGroupsSpendingPolicy") | Yes | Immutable audience type for the new policy. |
| `display_name` | string | Yes | Policy name containing only letters, digits, and spaces. |
| `period_limit` | string | Yes | Tenant audience limit for one UTC calendar month. |
| `per_user_limit` | string | Yes | Uniform per-user limit for the same UTC calendar month. |
| `assigned_groups` | array | No | Existing Entra group IDs to link inline. Allowed only for a selected-groups policy; a nonempty list additionally requires Assignment.ReadWrite.All. |
| `billing_methods` | array | No | Funding flags; omit to let Microsoft use notSpecified. |
| `service_settings` | array | Yes | Initial governed service settings; at least one service is required. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Delete Agent Registration

**Slug:** `MICROSOFT_COPILOT_PREVIEW_DELETE_AGENT_REGISTRATION`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Permanently delete a Microsoft 365 Copilot agent registration. This operation is irreversible and cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `agent_registration_id` | string | Yes | Microsoft Graph agent registration ID to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Delete Email Threshold Settings

**Slug:** `MICROSOFT_COPILOT_PREVIEW_DELETE_EMAIL_THRESHOLD_SETTINGS`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Delete a spending policy's email threshold configuration. This disables alerts but retains separately managed recipients. The provider-returned policy ETag is required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Spending policy ID returned by Microsoft Graph. |
| `if_match` | string | Yes | Current provider-returned ETag of the parent spending policy, for example "abc" or W/"7". Pass the quoted strong or weak value unchanged. Fetch the policy again after a precondition failure. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Delete Spending Policy

**Slug:** `MICROSOFT_COPILOT_PREVIEW_DELETE_SPENDING_POLICY`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Delete a Copilot Credit spending policy and stop it governing consumption. Requires the current parent policy ETag.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `etag` | string | Yes | Current provider-returned policy ETag. Pass the quoted strong or weak value unchanged. |
| `policy_id` | string | Yes | Spending policy identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Export Interactions

**Slug:** `MICROSOFT_COPILOT_PREVIEW_EXPORT_INTERACTIONS`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Use only to validate the beta export contract or consume additive beta fields; for production exports use Export Interactions. Export a licensed user's Copilot interaction history. Requires the app-only S2S_OAUTH2 connection with admin-consented AiEnterpriseInteraction.Read.All; delegated OAuth is unsupported.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque continuation cursor returned by a previous call. Pass it back unchanged; omit it for the first page. |
| `filter` | string | No | Optional documented OData filter. Use appClass eq '<value>' (combined with or when needed), where value is one of IPM.SkypeTeams.Message.Copilot.Word, IPM.SkypeTeams.Message.Copilot.Excel, IPM.SkypeTeams.Message.Copilot.Teams, IPM.SkypeTeams.Message.Copilot.BizChat, IPM.SkypeTeams.Message.Copilot.WebChat, or IPM.SkypeTeams.Message.Copilot.CoworkChat; or use a createdDateTime range with both minimum and maximum boundaries. |
| `user_id` | string | Yes | Microsoft Entra user ID whose Copilot interaction history to export. |
| `page_size` | integer | No | Interactions requested on this page. Microsoft recommends 100 and documents no maximum. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get Agent Registration

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_AGENT_REGISTRATION`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Retrieve one Microsoft 365 Copilot agent registration by ID in the global cloud.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | array | No | Optional agent registration property names to return via OData $select. |
| `agent_registration_id` | string | Yes | Microsoft Graph agent registration ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get Copilot Package

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_COPILOT_PACKAGE`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Use when preparing or verifying beta-only package mutations; for production reads use Get Copilot Package. Get detailed information for one provider-returned Copilot package ID. Requires Microsoft Agent 365, organization administrator access, and the global cloud.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | array | No | Package property names to return through Microsoft Graph $select. |
| `package_id` | string | Yes | Provider-returned Copilot package ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get Credit Request

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_CREDIT_REQUEST`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one credit request and its quoted strong ETag for a later decision. Requires the signed-in user to be a Billing Administrator, Global Administrator, AI Administrator, Global Reader, or AI Reader. Available only in the Microsoft Graph global service. Microsoft documents this operation, but it is absent from the current live beta metadata and generated beta OpenAPI; rollout availability is unverified.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Credit request identifier. |
| `select` | array | No | Documented credit-request properties to return in $select. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get Email Threshold Settings

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_EMAIL_THRESHOLD_SETTINGS`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get the notify-only email threshold configuration for one spending policy. Returns itemNotFound when no configuration exists and supports only $select.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Spending policy ID returned by Microsoft Graph. |
| `select` | array | No | Property names to return through OData $select. Values are joined with commas on the wire; omit to use Microsoft's default fields. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get Group Usage Record

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_GROUP_USAGE_RECORD`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one group's Copilot Credit usage for exactly one completed UTC day.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | array | No | Documented fields for $select. |
| `end_date` | string | Yes | Exclusive UTC end date, exactly one day after start_date. |
| `group_id` | string | Yes | Microsoft Entra group identifier. |
| `start_date` | string | Yes | Inclusive UTC start date in YYYY-MM-DD form. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get Copilot Limited Mode

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_LIMITED_MODE`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Use only to validate the beta limited-mode read; for production use Get Copilot Limited Mode. Get the tenant's limited-mode settings. Requires delegated work or school OAuth and at least the Global Reader role. Global cloud only; application permissions are unsupported.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get Meeting Insight

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_MEETING_INSIGHT`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get detailed notes, action items, participant mention events, and the nullable beta recap URL for one eligible meeting insight. Supports delegated OAuth and app-only S2S OAuth with OnlineMeetingAiInsight.Read.All. App-only access also requires an application access policy granted to the user ID in the request path. The organizer needs a Microsoft 365 Copilot license.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | array | No | Optional insight property names to return through the OData $select query. |
| `user_id` | string | Yes | Microsoft Entra ID of the meeting organizer. |
| `ai_insight_id` | string | Yes | Insight ID returned by Preview List Meeting Insights. |
| `online_meeting_id` | string | Yes | Provider-returned online meeting ID containing the insight. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get Copilot Policy Setting

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_POLICY_SETTING`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one tenant-level Microsoft 365 Copilot policy setting by its friendly identifier. Group-scoped settings are unsupported and return 422; global cloud only; application permissions are unsupported.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | array | No | Policy-setting property names to return through OData $select. |
| `setting_id` | string | Yes | Supported friendly Microsoft 365 Copilot policy-setting identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get Service Setting

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_SERVICE_SETTING`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one governed service setting from a Copilot spending policy. Supports only $select and requires delegated work or school OAuth.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Spending policy ID returned by Microsoft Graph. |
| `select` | array | No | Property names to return through OData $select. Values are joined with commas on the wire; omit to use Microsoft's default fields. |
| `service_id` | string | Yes | Governed Copilot service identifier within the spending policy. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get Service Usage Record

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_SERVICE_USAGE_RECORD`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one service's Copilot Credit usage for exactly one completed UTC day.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | array | No | Documented fields for $select. |
| `end_date` | string | Yes | Exclusive UTC end date, exactly one day after start_date. |
| `service_id` | string | Yes | Governed Copilot service identifier. |
| `start_date` | string | Yes | Inclusive UTC start date in YYYY-MM-DD form. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get Spending Policy

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_SPENDING_POLICY`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one polymorphic Copilot Credit spending policy. Child service, alert, recipient, and assigned-group relationships aren't expandable here.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | array | No | Policy property names for OData $select; relationships aren't expandable. |
| `policy_id` | string | Yes | Spending policy identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get Tenant Credit Balance

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_TENANT_CREDIT_BALANCE`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get the tenant-wide Copilot Credit balance snapshot, one row per billing method. Values are credit quantities, not currency, prices, invoices, or forecasts.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get Usage User Detail by Date Report

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_USAGE_USER_DETAIL_BY_DATE_REPORT`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Return sensitive per-user Microsoft 365 Copilot usage JSON for one report date. The date must fall from seven days before the latest reportRefreshDate through reportRefreshDate, inclusive; this window is not based on today's date. The action requests `$format=application/json` because Graph otherwise returns CSV even with an application/json Accept header. Supports delegated OAuth and app-only S2S OAuth with Reports.Read.All. Delegated callers additionally need a signed-in user holding an accepted Microsoft Entra limited administrator role, such as Reports Reader, AI Administrator, or a supported service administrator; this runtime role requirement does not apply to app-only calls. Available only in the global cloud.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | Report date in YYYY-MM-DD format. It must be from seven days before the latest reportRefreshDate through reportRefreshDate, inclusive; the window is not based on the current date. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get Usage User Detail Report

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_USAGE_USER_DETAIL_REPORT`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Return the latest v2 per-user usage JSON for licensed Microsoft 365 Copilot users. Use Preview User Count Summary or Trend for aggregate adoption. The response can expose sensitive user identifiers. Requires delegated OAuth or app-only S2S OAuth with Reports.Read.All. Delegated callers additionally need a signed-in user holding an accepted Microsoft Entra limited administrator role, such as Reports Reader or a supported service administrator; this runtime role requirement does not apply to app-only calls.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `period` | string ("D7" | "D28" | "D90" | "D180" | "ALL") | Yes | Reporting window for the fixed v2 report contract. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get User Balance

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_USER_BALANCE`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one user's computed Copilot consumption balance. The parent userBalances collection is not listable; use a provider user ID. Expanded service balances can be truncated; use the dedicated list action when all rows are required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | array | No | Properties to return, joined as OData $select. |
| `user_id` | string | Yes | Microsoft Entra user identifier. |
| `expand_service_balances` | boolean | No | Whether to inline the serviceBalances relationship. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get User Count Summary Report

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_USER_COUNT_SUMMARY_REPORT`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Return aggregate enabled and active totals by product as v2 JSON. Use Preview User Count Trend for day-by-day adoption or Preview Usage User Detail for per-user rows. Supports delegated OAuth and app-only S2S OAuth with Reports.Read.All. Delegated callers additionally need a signed-in user holding an accepted Microsoft Entra limited administrator role, such as Global Reader, Usage Summary Reports Reader, Reports Reader, or a supported service administrator; this runtime role requirement does not apply to app-only calls.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `period` | string ("D7" | "D28" | "D90" | "D180" | "ALL") | Yes | Reporting window for the fixed v2 report contract. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get User Count Trend Report

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_USER_COUNT_TREND_REPORT`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Return the JSON daily trend of enabled and active Microsoft 365 Copilot users. Use Preview User Count Summary for aggregate totals or Preview Usage User Detail for per-user rows. Supports delegated OAuth and app-only S2S OAuth with Reports.Read.All. Delegated callers additionally need a signed-in user holding an accepted Microsoft Entra limited administrator role, such as Global Reader, Usage Summary Reports Reader, Reports Reader, or a supported service administrator; this runtime role requirement does not apply to app-only calls.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `period` | string ("D7" | "D28" | "D90" | "D180" | "ALL") | Yes | Reporting window for the fixed v2 report contract. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get User Service Balance

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_USER_SERVICE_BALANCE`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one service balance row for one user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | array | No | Properties to return in $select. |
| `user_id` | string | Yes | Microsoft Entra user identifier. |
| `service_id` | string | Yes | Case-sensitive service identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get User Usage Detail

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_USER_USAGE_DETAIL`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one user's raw usage detail for a UTC window of at most 24 hours. Expanded sessions are only the first nested page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expand` | array | No | Relationships to inline. Expanded sessions contain only their first page; use the sessions action and its opaque cursor to continue. |
| `select` | array | No | Parent fields for $select. |
| `user_id` | string | Yes | Microsoft Entra user identifier. |
| `end_date_time` | string | Yes | Exclusive UTC timestamp no more than 24 hours after start_date_time. |
| `start_date_time` | string | Yes | Inclusive UTC ISO 8601 timestamp, with up to seven fractional digits. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Get User Usage Record

**Slug:** `MICROSOFT_COPILOT_PREVIEW_GET_USER_USAGE_RECORD`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one user's Copilot Credit usage for exactly one completed UTC day.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | array | No | Documented fields for $select. |
| `user_id` | string | Yes | Microsoft Entra user identifier. |
| `end_date` | string | Yes | Exclusive UTC end date, exactly one day after start_date. |
| `start_date` | string | Yes | Inclusive UTC start date in YYYY-MM-DD form. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview List Assigned Groups

**Slug:** `MICROSOFT_COPILOT_PREVIEW_LIST_ASSIGNED_GROUPS`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. List group objects assigned to a selected-groups spending policy through the required selectedGroupsSpendingPolicy cast path. Tenant-wide policies return 404.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `policy_id` | string | Yes | Selected-groups spending policy identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview List Copilot Packages

**Slug:** `MICROSOFT_COPILOT_PREVIEW_LIST_COPILOT_PACKAGES`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Use when preparing or verifying beta-only package update, block, unblock, or reassign workflows; for production read-only inventory use List Copilot Packages. Return one server-managed page of packages available in the tenant. Requires Microsoft Agent 365, organization administrator access, and the Microsoft global cloud. Pass next_cursor back unchanged to continue.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque @odata.nextLink returned as next_cursor. Pass it back unchanged and without filter_expression; Microsoft controls the page size and query options. |
| `filter_expression` | string | No | Documented OData $filter expression. Supported fields are supportedHosts, elementTypes, lastModifiedDateTime, platform, requestStatus, and requestType. Request status supports only eq 'pending'; request type supports one eq with publish, activate, access, or update. Request filters can be joined with and and combined only with ge/le lastModifiedDateTime bounds; do not use or, ne, contains, or combine request fields with supportedHosts, elementTypes, or platform. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview List Credit Requests

**Slug:** `MICROSOFT_COPILOT_PREVIEW_LIST_CREDIT_REQUESTS`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. List tenant credit requests in Microsoft's fixed newest-first order. Requires the signed-in user to be a Billing Administrator, Global Administrator, AI Administrator, Global Reader, or AI Reader. Available only in the Microsoft Graph global service. Microsoft documents this operation, but it is absent from the current live beta metadata and generated beta OpenAPI; rollout availability is unverified.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Rows on this page; Microsoft defaults to 50. |
| `count` | boolean | No | Whether to include @odata.count. |
| `state` | string ("pending" | "approved" | "rejected" | "cancelled" | "unknownFutureValue") | No | Exact state filter. |
| `cursor` | string | No | Opaque continuation cursor from a previous call; pass it unchanged. |
| `select` | array | No | Documented credit-request properties to return in $select. |
| `service_id` | string | No | Exact serviceId filter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview List Email Threshold Recipients

**Slug:** `MICROSOFT_COPILOT_PREVIEW_LIST_EMAIL_THRESHOLD_RECIPIENTS`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. List user objects configured to receive one spending policy's threshold emails. This operation supports no OData query parameters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Spending policy ID returned by Microsoft Graph. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview List Funding Usage Records

**Slug:** `MICROSOFT_COPILOT_PREVIEW_LIST_FUNDING_USAGE_RECORDS`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. List Copilot Credit consumption by funding class for one YYYY-MM month.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `count` | boolean | No | Whether to return the funding row count. |
| `month` | string | Yes | UTC funding month in YYYY-MM form. |
| `order` | string ("asc" | "desc") | No | Sort consumedQuantity ascending or descending. |
| `select` | array | No | Documented fields for $select. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview List Group Usage Records

**Slug:** `MICROSOFT_COPILOT_PREVIEW_LIST_GROUP_USAGE_RECORDS`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Rank per-group Copilot Credit usage for exactly one completed UTC day.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Records on this page; Microsoft defaults to 10. |
| `count` | boolean | No | Whether to return the total matching record count. |
| `order` | string ("asc" | "desc") | No | Sort consumedQuantity ascending or descending. |
| `cursor` | string | No | Opaque continuation cursor from the preceding page; pass it unchanged. |
| `select` | array | No | Documented group usage fields for $select. |
| `end_date` | string | Yes | Exclusive UTC end date, exactly one day after start_date. |
| `group_id` | string | No | Exact groupId to match. |
| `start_date` | string | Yes | Inclusive UTC start date in YYYY-MM-DD form. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview List Meeting Insights

**Slug:** `MICROSOFT_COPILOT_PREVIEW_LIST_MEETING_INSIGHTS`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Use when the returned insight ID will be passed to Preview Get Meeting Insight for beta-only fields such as recap_url; otherwise use List Meeting Insights. List AI insight records for one completed, non-expired supported meeting. Supports delegated OAuth and app-only S2S OAuth with OnlineMeetingAiInsight.Read.All. App-only access also requires an application access policy granted to the user ID in the request path. The organizer needs a Microsoft 365 Copilot license; recording or transcription is required, insights are available only after the meeting ends and can take up to four hours, and pay-as-you-go and evaluation modes are unsupported. Private scheduled meetings, town halls, webinars, and Meet Now are supported; channel meetings are not. Available only in the global cloud.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque continuation cursor returned by a previous call. Pass it back unchanged; omit it for the first page. |
| `select` | array | No | Optional insight property names to return through the OData $select query. |
| `user_id` | string | Yes | Microsoft Entra ID of the meeting organizer. |
| `online_meeting_id` | string | Yes | Provider-returned online meeting ID for the completed meeting. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview List Service Settings

**Slug:** `MICROSOFT_COPILOT_PREVIEW_LIST_SERVICE_SETTINGS`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. List every service setting attached to one Copilot spending policy. Supports only $select and requires delegated work or school OAuth.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Spending policy ID returned by Microsoft Graph. |
| `select` | array | No | Property names to return through OData $select. Values are joined with commas on the wire; omit to use Microsoft's default fields. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview List Service Usage Records

**Slug:** `MICROSOFT_COPILOT_PREVIEW_LIST_SERVICE_USAGE_RECORDS`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Rank per-service Copilot Credit usage for exactly one completed UTC day.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Records on this page; Microsoft defaults to 10. |
| `count` | boolean | No | Whether to return the total matching record count. |
| `order` | string ("asc" | "desc") | No | Sort consumedQuantity ascending or descending. |
| `cursor` | string | No | Opaque continuation cursor from the preceding page; pass it unchanged. |
| `select` | array | No | Documented service usage fields for $select. |
| `end_date` | string | Yes | Exclusive UTC end date, exactly one day after start_date. |
| `service_id` | string | No | Exact serviceId to match. |
| `start_date` | string | Yes | Inclusive UTC start date in YYYY-MM-DD form. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview List Spending Policies

**Slug:** `MICROSOFT_COPILOT_PREVIEW_LIST_SPENDING_POLICIES`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Return one page of polymorphic Copilot Credit spending policies. Supports only the documented policy-list OData projection, paging, filter, count, and ordering options.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Positive OData $top page size. |
| `count` | boolean | No | Whether Microsoft should include @odata.count. |
| `cursor` | string | No | Opaque continuation cursor from the preceding policy page. |
| `filter` | string | No | OData filter using only status, displayName, or createdDateTime with eq/ne and and/or. Other operators and null comparisons are rejected. |
| `select` | array | No | Policy property names for OData $select; relationships aren't expandable. |
| `order_by` | array | No | OData ordering limited to displayName and createdDateTime. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview List User Service Balances

**Slug:** `MICROSOFT_COPILOT_PREVIEW_LIST_USER_SERVICE_BALANCES`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. List one user's per-service Copilot balances using only Microsoft's supported serviceId and consumption-decision query profile.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Upper bound on rows returned on this page. |
| `count` | boolean | No | Whether Microsoft should include @odata.count. |
| `order` | string ("asc" | "desc") | No | Optional serviceId sort direction for $orderby. |
| `cursor` | string | No | Opaque continuation cursor from a previous call; pass it unchanged. |
| `select` | array | No | Properties to return in $select. |
| `user_id` | string | Yes | Microsoft Entra user identifier. |
| `service_ids` | array | No | Case-sensitive service IDs to match using eq or in. |
| `is_consumption_allowed` | boolean | No | Filter to balances whose consumption decision matches this value. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview List User Usage Records

**Slug:** `MICROSOFT_COPILOT_PREVIEW_LIST_USER_USAGE_RECORDS`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Rank per-user Copilot Credit usage for exactly one completed UTC day.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Records on this page; Microsoft defaults to 10. |
| `count` | boolean | No | Whether to return the total matching record count. |
| `order` | string ("asc" | "desc") | No | Sort consumedQuantity ascending or descending. |
| `cursor` | string | No | Opaque continuation cursor from the preceding page; pass it unchanged. |
| `select` | array | No | Documented user usage fields for $select. |
| `user_id` | string | No | Exact userId to match. |
| `end_date` | string | Yes | Exclusive UTC end date, exactly one day after start_date. |
| `start_date` | string | Yes | Inclusive UTC start date in YYYY-MM-DD form. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview List User Usage Service Details

**Slug:** `MICROSOFT_COPILOT_PREVIEW_LIST_USER_USAGE_SERVICE_DETAILS`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. List one user's per-service raw usage for a UTC window of at most 24 hours.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | array | No | Documented fields for $select. |
| `user_id` | string | Yes | Microsoft Entra user identifier. |
| `end_date_time` | string | Yes | Exclusive UTC timestamp no more than 24 hours after start_date_time. |
| `start_date_time` | string | Yes | Inclusive UTC ISO 8601 timestamp, with up to seven fractional digits. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview List User Usage Session Details

**Slug:** `MICROSOFT_COPILOT_PREVIEW_LIST_USER_USAGE_SESSION_DETAILS`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Return one page of one user's raw session usage for a UTC window of at most 24 hours.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Rows on this page; Microsoft defaults to 20. |
| `cursor` | string | No | Opaque continuation cursor from the preceding page; pass it unchanged. |
| `select` | array | No | Documented fields for $select. |
| `user_id` | string | Yes | Microsoft Entra user identifier. |
| `end_date_time` | string | Yes | Exclusive UTC timestamp no more than 24 hours after start_date_time. |
| `start_date_time` | string | Yes | Inclusive UTC ISO 8601 timestamp, with up to seven fractional digits. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Reassign Copilot Package

**Slug:** `MICROSOFT_COPILOT_PREVIEW_REASSIGN_COPILOT_PACKAGE`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Reassign one Copilot package to a new owner by Microsoft Entra user ID. Requires delegated work or school OAuth, Microsoft Agent 365, organization administrator access, and the global cloud.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | Microsoft Entra user ID of the package's new owner. |
| `package_id` | string | Yes | Provider-returned Copilot package ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Remove Assigned Group

**Slug:** `MICROSOFT_COPILOT_PREVIEW_REMOVE_ASSIGNED_GROUP`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Remove an Entra group reference through the selectedGroupsSpendingPolicy cast path. Requires the current parent policy ETag and refuses removal of the last group.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `etag` | string | Yes | Current provider-returned policy ETag. Pass the quoted strong or weak value unchanged. |
| `group_id` | string | Yes | Assigned Microsoft Entra group ID to remove. |
| `policy_id` | string | Yes | Spending policy identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Remove Email Threshold Recipient

**Slug:** `MICROSOFT_COPILOT_PREVIEW_REMOVE_EMAIL_THRESHOLD_RECIPIENT`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Unlink one user from a spending policy's email threshold recipients. Microsoft refuses removal of the last recipient while alerting is enabled. The parent policy provider-returned policy ETag is required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Spending policy ID returned by Microsoft Graph. |
| `user_id` | string | Yes | Microsoft Entra user ID to unlink from threshold notifications. |
| `if_match` | string | Yes | Current provider-returned ETag of the parent spending policy, for example "abc" or W/"7". Pass the quoted strong or weak value unchanged. Fetch the policy again after a precondition failure. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Retrieve Content

**Slug:** `MICROSOFT_COPILOT_PREVIEW_RETRIEVE_CONTENT`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Retrieve grounding extracts with beta-only page numbers and optional thumbnails; the same Copilot licensing or eligible pay-as-you-go prerequisites apply.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | Natural-language description of the information to retrieve. |
| `data_source` | string ("sharePoint" | "oneDriveBusiness" | "externalItem") | Yes | The single Microsoft content source to search. |
| `connection_ids` | array | No | Optional Copilot connector connection IDs to search. Omit for externalItem to search all authorized connectors; omit for other data sources. |
| `maximum_results` | integer | No | Maximum retrieval hits to return in this bounded response. |
| `filter_expression` | string | No | Optional KQL filter. Invalid KQL can be ignored by Microsoft, so use only validated expressions. |
| `resource_metadata` | array | No | Metadata field names to include for each matching resource. |
| `include_thumbnails` | boolean | No | Whether to include available base64 page thumbnails and page-number metadata. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Search Copilot Content

**Slug:** `MICROSOFT_COPILOT_PREVIEW_SEARCH`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Search OneDrive for work or school content for a licensed Microsoft 365 Copilot user. Official beta metadata marks this operation deprecated with a 2025-09-15 removal date, while Microsoft Learn still documents it; treat availability as unverified and do not rely on it for production. Global cloud only; limited to 200 requests per user per hour.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | Search query for the first page of Microsoft 365 Copilot content. |
| `cursor` | string | No | Opaque continuation token returned by a previous call. Pass it back unchanged and without query or other first-page fields. |
| `page_size` | integer | No | Search hits requested on this page (1-100). |
| `filter_expression` | string | No | Optional OneDrive for work or school KQL filter. The current preview supports only path expressions. |
| `resource_metadata_names` | array | No | OneDrive resource metadata fields to include in each search hit. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Start Conversation

**Slug:** `MICROSOFT_COPILOT_PREVIEW_START_CONVERSATION`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Create a Copilot conversation and send its first synchronous user turn in one tool call. Both effects are irreversible: Microsoft exposes no conversation delete API, and a failed chat can still leave the empty conversation or record the turn. Use Preview Chat in Conversation for later turns.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message` | string | Yes | First user message to send in the new conversation. |
| `latitude` | number | No | Optional latitude for location grounding. |
| `file_uris` | array | No | Microsoft Graph file URIs to ground the first turn. |
| `longitude` | number | No | Optional longitude for location grounding. |
| `time_zone` | string | Yes | IANA time-zone name used to localize the answer, such as UTC. |
| `web_enabled` | boolean | No | Whether web grounding is enabled for the first turn. |
| `country_or_region` | string | No | Optional country or region hint for grounding. |
| `additional_context` | array | No | Additional text snippets to ground the first turn. |
| `country_or_region_confidence` | number | No | Confidence score for the country or region hint. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Stream Chat in Conversation

**Slug:** `MICROSOFT_COPILOT_PREVIEW_STREAM_CHAT_IN_CONVERSATION`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Append an irreversible turn and collect server-sent Copilot conversation updates plus raw SSE diagnostics until the response closes. Use synchronous Chat in Conversation when only the final answer is needed. Requires a licensed work or school user; a 200 stream can contain a license-denial conversation, surfaced as semantic_status=possible_license_denial without retrying the turn.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message` | string | Yes | User message to append to the conversation. |
| `latitude` | number | No | Optional latitude used as a location hint. |
| `file_uris` | array | No | Microsoft Graph file URIs to use as contextual resources. |
| `longitude` | number | No | Optional longitude used as a location hint. |
| `time_zone` | string | Yes | IANA time-zone name used to localize the answer, such as America/Los_Angeles or UTC. |
| `web_enabled` | boolean | No | Whether web grounding is enabled for this turn; omit to use Microsoft's default. |
| `conversation_id` | string | Yes | Conversation ID returned by Preview Create Conversation. |
| `country_or_region` | string | No | Optional country or region hint for grounding. |
| `additional_context` | array | No | Additional text snippets to ground this turn. |
| `country_or_region_confidence` | number | No | Optional confidence score associated with the country or region hint. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Unblock Copilot Package

**Slug:** `MICROSOFT_COPILOT_PREVIEW_UNBLOCK_COPILOT_PACKAGE`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Unblock one Copilot package to allow its use. Requires delegated work or school OAuth, Microsoft Agent 365, organization administrator access, and the global cloud.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `package_id` | string | Yes | Provider-returned Copilot package ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Update Agent Registration

**Slug:** `MICROSOFT_COPILOT_PREVIEW_UPDATE_AGENT_REGISTRATION`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Update at least one property of a Microsoft 365 Copilot agent registration. Omitted fields are retained, explicit null clears nullable fields, and a2a_reference_id requires a2a_mode.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `a2a_mode` | string ("none" | "oAuthPluginVault" | "apiKeyPluginVault" | "dynamicClientRegistration" | "connectionVault" | "unknownFutureValue") | No | Replacement provider-defined mechanism for invoking the Agent2Agent server. |
| `owner_ids` | array | No | Replacement list of agent registration owner IDs. |
| `agent_card` | object | No | Replacement agent card manifest preserved as arbitrary JSON. |
| `description` | string | No | Replacement agent description. |
| `display_name` | string | No | Replacement display name. |
| `source_agent_id` | string | No | Replacement source-system agent ID. |
| `a2a_reference_id` | string | No | Replacement Microsoft-side configuration reference for the selected A2A mode. This is an identifier, not a secret or account credential. |
| `agent_identity_id` | string | No | Replacement Microsoft Entra agent identity identifier. |
| `last_published_by` | string | No | Replacement ID of the last publisher. |
| `managed_by_app_id` | string | No | Replacement managing application ID. |
| `originating_store` | string | No | Replacement originating store or source system. |
| `agent_registration_id` | string | Yes | Microsoft Graph agent registration ID to update. |
| `agent_identity_blueprint_id` | string | No | Replacement agent identity blueprint identifier. |
| `source_last_modified_date_time` | string | No | Replacement timezone-aware source last-modified timestamp. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Update Copilot Package

**Slug:** `MICROSOFT_COPILOT_PREVIEW_UPDATE_COPILOT_PACKAGE`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Update a package's availability or deployment assignments. Microsoft Learn's operation page controls the request contract: it documents allowedFor* and acquiredFor* wire values, which conflict with current Graph metadata's none/some/all values. This action intentionally exposes only the Learn values. Supply at least one update field; assignment lists require their matching available_to or deployed_to status. Requires delegated work or school OAuth, Microsoft Agent 365, organization administrator access, and the global cloud.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `package_id` | string | Yes | Provider-returned Copilot package ID to update. |
| `deployed_to` | string ("acquiredForNone" | "acquiredForSome" | "acquiredForAll") | No | Deployment status. Microsoft Learn documents these wire values; current Graph metadata instead says none/some/all, so this preview action follows the operation page and does not expose the conflicting metadata values. |
| `available_to` | string ("allowedForNone" | "allowedForSome" | "allowedForAll") | No | Availability status. Microsoft Learn documents these wire values; current Graph metadata instead says none/some/all, so this preview action follows the operation page and does not expose the conflicting metadata values. |
| `acquire_users_and_groups` | array | No | Complete deployment assignment. Requires deployed_to when supplied. |
| `allowed_users_and_groups` | array | No | Complete availability assignment. Requires available_to when supplied. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Update Credit Request

**Slug:** `MICROSOFT_COPILOT_PREVIEW_UPDATE_CREDIT_REQUEST`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Approve or reject one pending credit request using its latest quoted strong ETag. The decision can change state even if a later response is lost. Requires the signed-in user to be a Global Administrator, Billing Administrator, or AI Administrator. Available only in the Microsoft Graph global service. Microsoft documents this operation, but it is absent from the current live beta metadata and generated beta OpenAPI; rollout availability is unverified.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Credit request identifier. |
| `etag` | string | Yes | Latest quoted strong ETag. Weak ETags and * are rejected. |
| `state` | string ("approved" | "rejected") | Yes | Decision to record: approved or rejected. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Update Email Threshold Settings

**Slug:** `MICROSOFT_COPILOT_PREVIEW_UPDATE_EMAIL_THRESHOLD_SETTINGS`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Create or merge-update notify-only email thresholds for one spending policy. Omitted fields retain state, null is rejected, [] clears thresholds, and recipients must be managed separately. An empty update intentionally creates default settings when absent and is a no-op when they already exist. The current provider-returned policy ETag is required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Spending policy ID returned by Microsoft Graph. |
| `if_match` | string | Yes | Current provider-returned ETag of the parent spending policy, for example "abc" or W/"7". Pass the quoted strong or weak value unchanged. Fetch the policy again after a precondition failure. |
| `is_enabled` | boolean | No | Enable or disable notifications. Omit to retain the current value. |
| `thresholds` | array | No | Replacement threshold list. Use [] to clear thresholds, or omit to retain them. Percentage values are integers 1-100; absolute values are positive Copilot Credit quantities. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Update Copilot Limited Mode

**Slug:** `MICROSOFT_COPILOT_PREVIEW_UPDATE_LIMITED_MODE`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Use only to validate the beta limited-mode mutation; for production use Update Copilot Limited Mode. Update the tenant's limited-mode settings. Requires delegated work or school OAuth and the Global Administrator role. Global cloud only; application permissions are unsupported. Supply at least one field; group_id is required when enabling the setting.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | string | No | Microsoft Entra group ID to enable for limited mode, or null to clear it. |
| `is_enabled_for_group` | boolean | No | Set true to enable limited mode for group_id, or false to disable it. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Update Copilot Policy Setting

**Slug:** `MICROSOFT_COPILOT_PREVIEW_UPDATE_POLICY_SETTING`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Update one tenant-level Microsoft 365 Copilot policy setting by its friendly identifier. Group-scoped settings are unsupported and return 422; global cloud only; application permissions are unsupported.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `value` | string | Yes | Setting-specific digit, URL, XML, or JSON string to store. |
| `policy_id` | string | No | Optional tenant-level policy ID. Omit to let Microsoft resolve the first matching tenant policy. |
| `setting_id` | string | Yes | Supported friendly Microsoft 365 Copilot policy-setting identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Update Service Setting

**Slug:** `MICROSOFT_COPILOT_PREVIEW_UPDATE_SERVICE_SETTING`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Change one service setting's state. Setting state to disabled is the documented removal semantic; the current provider-returned policy ETag is required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Spending policy ID returned by Microsoft Graph. |
| `state` | string ("enabled" | "disabled" | "unknownFutureValue") | Yes | New service state. Set disabled to remove access; Microsoft retains the setting because this collection has no DELETE operation. |
| `if_match` | string | Yes | Current provider-returned ETag of the parent spending policy, for example "abc" or W/"7". Pass the quoted strong or weak value unchanged. Fetch the policy again after a precondition failure. |
| `service_id` | string | Yes | Governed Copilot service identifier to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Update Spending Policy

**Slug:** `MICROSOFT_COPILOT_PREVIEW_UPDATE_SPENDING_POLICY`

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Update only a policy's display name, monthly limits, or billing-method flags. Supply at least one of those fields. Requires the current parent policy ETag and never writes lifecycle or audit fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `etag` | string | Yes | Current provider-returned policy ETag. Pass the quoted strong or weak value unchanged. |
| `policy_id` | string | Yes | Spending policy identifier. |
| `display_name` | string | No | Replacement display name containing only letters, digits, and spaces. |
| `period_limit` | string | No | Replacement monthly audience limit. |
| `per_user_limit` | string | No | Replacement monthly per-user limit. |
| `billing_methods` | array | No | Replacement funding-method flags. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve Content

**Slug:** `MICROSOFT_COPILOT_RETRIEVE_CONTENT`

Retrieve unordered grounding extracts from one SharePoint, OneDrive for Business, or Copilot connector source. Requires delegated work or school OAuth and a Microsoft 365 Copilot license or eligible pay-as-you-go retrieval configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | One natural-language sentence describing the information to retrieve. |
| `data_source` | string ("sharePoint" | "oneDriveBusiness" | "externalItem") | Yes | The single Microsoft content source to search. |
| `connection_ids` | array | No | Optional Copilot connector connection IDs to search. Omit for externalItem to search all authorized connectors; omit for other data sources. |
| `maximum_results` | integer | No | Maximum retrieval hits to return in this bounded response (1-25). |
| `filter_expression` | string | No | Optional KQL filter. Microsoft can ignore invalid KQL, so use only a validated expression. |
| `resource_metadata` | array | No | Metadata field names to include for each matching resource. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Copilot Limited Mode

**Slug:** `MICROSOFT_COPILOT_UPDATE_LIMITED_MODE`

DEFAULT FOR PRODUCTION: update the tenant's Microsoft 365 Copilot limited-mode settings through the stable v1.0 contract. Use Preview Update Copilot Limited Mode only for beta contract validation. Requires delegated work or school OAuth and the Global Administrator role. Global cloud only; application permissions are unsupported. Supply at least one field; group_id is required when enabling the setting.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | string | No | Microsoft Entra group ID to enable for limited mode, or null to clear it. |
| `is_enabled_for_group` | boolean | No | Set true to enable limited mode for group_id, or false to disable it. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
