Microsoft Copilot

Microsoft Copilot is an AI-powered assistant that helps users with productivity tasks, content generation, and information retrieval across Microsoft 365 applications and services.

5 APIs 8 Features

AgentsAI AssistantArtificial IntelligenceChatbotCopilotExtensibilityGenerative AIMicrosoft 365Productivity

APIs

Microsoft Copilot API

API for integrating Microsoft Copilot capabilities into applications.

Microsoft Graph API (Copilot Integration)

Microsoft Graph API endpoints for accessing Copilot features within Microsoft 365, including the Copilot namespace with retrieval, chat, search, and meeting insights capabilities.

Microsoft 365 Copilot APIs

REST APIs under the Microsoft Graph /copilot/ namespace that enable secure access to Microsoft 365 Copilot capabilities including retrieval, chat, and search, for use in custom ...

Microsoft 365 Copilot Connectors API

API for building custom connectors that bring external data into Microsoft Graph to enhance Microsoft 365 Copilot experiences including search and retrieval augmented generation.

Microsoft Copilot Studio API

APIs for building, publishing, and integrating custom agents and copilots using Microsoft Copilot Studio, including Direct Line API for connecting web and custom applications.

Collections

Microsoft Copilot Microsoft 365 Copilot APIs

OPEN

Pricing Plans

Microsoft Copilot Plans Pricing

7 plans

PLANS

Rate Limits

Microsoft Copilot Rate Limits

5 limits

RATE LIMITS

FinOps

Microsoft Copilot Finops

FINOPS

Features

Retrieval API

Retrieve relevant enterprise content from Microsoft 365 using AI-powered retrieval augmented generation with permissions and sensitivity label awareness.

Search API

Perform semantic search across Microsoft 365 content including SharePoint, OneDrive, and Exchange with AI-enhanced ranking.

Chat API

Programmatically start and continue conversations with Microsoft 365 Copilot grounded in enterprise and web search data.

Interaction Export

Export and audit Copilot interaction history across the organization for compliance and governance purposes.

Change Notifications

Subscribe to real-time notifications for Copilot interactions and events across Microsoft 365.

Copilot Studio

Low-code platform for building custom agents, copilots, and conversational AI experiences.

Connectors

Bring external data into Microsoft Graph to enhance Copilot search and retrieval capabilities.

Extensibility

Extend Copilot with custom plugins, agents, and API integrations using declarative or code-first approaches.

Use Cases

Enterprise Knowledge Retrieval

Build applications that retrieve relevant enterprise content from Microsoft 365 while respecting permissions and compliance controls.

AI-Assisted Productivity

Integrate Copilot capabilities into line-of-business applications for document summarization, drafting, and data analysis.

Custom Agent Development

Create domain-specific AI agents using Copilot Studio that automate workflows and answer questions from custom data sources.

Compliance and Governance

Monitor and audit Copilot usage across the organization with interaction history export and change notifications.

Integrations

Microsoft 365

Deep integration with Word, Excel, PowerPoint, Outlook, Teams, and other Microsoft 365 applications.

Microsoft Graph

Access organizational data through the Microsoft Graph API for retrieval, search, and chat capabilities.

Azure Active Directory

Enterprise authentication and authorization using Azure AD with OAuth 2.0 and OIDC.

Power Platform

Connect Copilot with Power Automate, Power Apps, and Power BI for end-to-end workflow automation.

Semantic Vocabularies

Microsoft Copilot Context

0 classes · 0 properties

JSON-LD

API Governance Rules

Microsoft Copilot API Rules

7 rules · 7 errors

SPECTRAL

JSON Structure

Microsoft Copilot Ai Interaction Attachment Structure

5 properties

JSON STRUCTURE

Microsoft Copilot Ai Interaction Collection Response Structure

3 properties

JSON STRUCTURE

Microsoft Copilot Ai Interaction Context Structure

3 properties

JSON STRUCTURE

Microsoft Copilot Ai Interaction Link Structure

3 properties

JSON STRUCTURE

Microsoft Copilot Ai Interaction Mention Structure

3 properties

JSON STRUCTURE

Microsoft Copilot Ai Interaction Structure

13 properties

JSON STRUCTURE

Microsoft Copilot Chat Conversation Request Structure

3 properties

JSON STRUCTURE

Microsoft Copilot Chat Conversation Response Structure

1 properties

JSON STRUCTURE

Microsoft Copilot Chat Message Request Structure

2 properties

JSON STRUCTURE

Microsoft Copilot Chat Message Response Structure

0 properties

JSON STRUCTURE

Microsoft Copilot Chat Message Structure

4 properties

JSON STRUCTURE

Microsoft Copilot Copilot Search Data Sources Configuration Structure

1 properties

JSON STRUCTURE

Microsoft Copilot Data Source Configuration Structure

1 properties

JSON STRUCTURE

Microsoft Copilot Identity Set Structure

3 properties

JSON STRUCTURE

Microsoft Copilot Item Body Structure

2 properties

JSON STRUCTURE

Microsoft Copilot O Data Error Structure

1 properties

JSON STRUCTURE

Microsoft Copilot Retrieval Extract Structure

2 properties

JSON STRUCTURE

Microsoft Copilot Retrieval Hit Structure

4 properties

JSON STRUCTURE

Microsoft Copilot Retrieval Request Structure

5 properties

JSON STRUCTURE

Microsoft Copilot Retrieval Response Structure

1 properties

JSON STRUCTURE

Microsoft Copilot Search Hit Structure

4 properties

JSON STRUCTURE

Microsoft Copilot Search Request Structure

2 properties

JSON STRUCTURE

Microsoft Copilot Search Response Structure

3 properties

JSON STRUCTURE

Microsoft Copilot Sensitivity Label Structure

5 properties

JSON STRUCTURE

Microsoft Copilot Structure

0 properties

JSON STRUCTURE

Microsoft Copilot Subscription Request Structure

5 properties

JSON STRUCTURE

Microsoft Copilot Subscription Structure

6 properties

JSON STRUCTURE

Example Payloads

Microsoft Copilot Ai Interaction Attachment Example

5 fields

EXAMPLE

Microsoft Copilot Ai Interaction Collection Response Example

3 fields

EXAMPLE

Microsoft Copilot Ai Interaction Context Example

3 fields

EXAMPLE

Microsoft Copilot Ai Interaction Example

13 fields

EXAMPLE

Microsoft Copilot Ai Interaction Link Example

3 fields

EXAMPLE

Microsoft Copilot Ai Interaction Mention Example

3 fields

EXAMPLE

Microsoft Copilot Chat Conversation Request Example

3 fields

EXAMPLE

Microsoft Copilot Chat Conversation Response Example

1 fields

EXAMPLE

Microsoft Copilot Chat Message Example

4 fields

EXAMPLE

Microsoft Copilot Chat Message Request Example

2 fields

EXAMPLE

Microsoft Copilot Chat Message Response Example

EXAMPLE

Microsoft Copilot Copilot Search Data Sources Configuration Example

1 fields

EXAMPLE

Microsoft Copilot Copilotchangenotificationscreatesubscription Example

6 fields

EXAMPLE

Microsoft Copilot Copilotchatcontinueconversation Example

6 fields

EXAMPLE

Microsoft Copilot Copilotchatstartconversation Example

6 fields

EXAMPLE

Microsoft Copilot Copilotinteractionhistorygetallenterpriseinteractions Example

6 fields

EXAMPLE

Microsoft Copilot Copilotretrieval Example

6 fields

EXAMPLE

Microsoft Copilot Copilotsearch Example

6 fields

EXAMPLE

Microsoft Copilot Data Source Configuration Example

1 fields

EXAMPLE

Microsoft Copilot Identity Set Example

3 fields

EXAMPLE

Microsoft Copilot Item Body Example

2 fields

EXAMPLE

Microsoft Copilot O Data Error Example

1 fields

EXAMPLE

Microsoft Copilot Retrieval Extract Example

2 fields

EXAMPLE

Microsoft Copilot Retrieval Hit Example

4 fields

EXAMPLE

Microsoft Copilot Retrieval Request Example

5 fields

EXAMPLE

Microsoft Copilot Retrieval Response Example

1 fields

EXAMPLE

Microsoft Copilot Search Hit Example

4 fields

EXAMPLE

Microsoft Copilot Search Request Example

2 fields

EXAMPLE

Microsoft Copilot Search Response Example

3 fields

EXAMPLE

Microsoft Copilot Sensitivity Label Example

5 fields

EXAMPLE

Microsoft Copilot Subscription Example

6 fields

EXAMPLE

Microsoft Copilot Subscription Request Example

5 fields

EXAMPLE

Resources

Sources

opencollection: 1.0.0
info:
  name: Microsoft Copilot Microsoft 365 Copilot APIs
  version: 1.0.0
request:
  auth:
    type: oauth2
    flow: authorization_code
    authorizationUrl: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
    accessTokenUrl: https://login.microsoftonline.com/common/oauth2/v2.0/token
    credentials:
      clientId: '{{clientId}}'
      clientSecret: '{{clientSecret}}'
items:
- info:
    name: Retrieval
    type: folder
  items:
  - info:
      name: Microsoft Copilot Retrieve Grounding Data
      type: http
    http:
      method: POST
      url: https://graph.microsoft.com/v1.0/copilot/retrieval
      headers:
      - name: Authorization
        value: ''
      body:
        type: json
        data: '{}'
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
        accessTokenUrl: https://login.microsoftonline.com/common/oauth2/v2.0/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: Retrieve relevant text extracts from SharePoint, OneDrive, and Copilot connectors content that the calling user
      has access to, while respecting defined access controls within the tenant. Use this endpoint to ground generative AI
      solutions with Microsoft 365 data while optimizing for context recall. Results include text snippets with relevance
      scores, sensitivity labels, and optional resource metadata.
- info:
    name: Search
    type: folder
  items:
  - info:
      name: Microsoft Copilot Perform Hybrid Search
      type: http
    http:
      method: POST
      url: https://graph.microsoft.com/v1.0/copilot/search
      headers:
      - name: Authorization
        value: ''
      body:
        type: json
        data: '{}'
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
        accessTokenUrl: https://login.microsoftonline.com/common/oauth2/v2.0/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: Perform hybrid search (semantic and lexical) across OneDrive for work or school content using natural language queries
      with contextual understanding and intelligent results. Discover relevant documents and files while respecting defined
      access controls within the organization. This API is currently in preview.
- info:
    name: Chat
    type: folder
  items:
  - info:
      name: Microsoft Copilot Start a Chat Conversation
      type: http
    http:
      method: POST
      url: https://graph.microsoft.com/v1.0/copilot/chat/conversations
      headers:
      - name: Authorization
        value: ''
      body:
        type: json
        data: '{}'
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
        accessTokenUrl: https://login.microsoftonline.com/common/oauth2/v2.0/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: Start a new multi-turn conversation with Microsoft 365 Copilot. The Chat API allows you to programmatically engage
      in conversations using enterprise search grounding and web search grounding. Responses are grounded in Microsoft 365
      data and web content while respecting all existing permissions and compliance controls. This API is currently in preview.
  - info:
      name: Microsoft Copilot Continue a Chat Conversation
      type: http
    http:
      method: POST
      url: https://graph.microsoft.com/v1.0/copilot/chat/conversations/:conversationId/messages
      headers:
      - name: Authorization
        value: ''
      params:
      - name: conversationId
        value: '500123'
        type: path
        description: The unique identifier of the conversation to continue.
      body:
        type: json
        data: '{}'
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
        accessTokenUrl: https://login.microsoftonline.com/common/oauth2/v2.0/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: Send a follow-up message in an existing multi-turn conversation with Microsoft 365 Copilot. Uses the conversation
      context from prior turns to provide more relevant and contextual responses.
- info:
    name: Interaction Export
    type: folder
  items:
  - info:
      name: Microsoft Copilot List All Enterprise Copilot Interactions
      type: http
    http:
      method: GET
      url: https://graph.microsoft.com/v1.0/copilot/interactionHistory/getAllEnterpriseInteractions
      headers:
      - name: Authorization
        value: ''
      params:
      - name: $filter
        value: createdDateTime ge 2025-01-01T00:00:00Z and createdDateTime le 2025-03-31T23:59:59Z
        type: query
        description: OData filter expression to filter interactions by date range, user, or application.
      - name: $top
        value: '10'
        type: query
        description: Maximum number of interactions to return per page.
      - name: $skipToken
        value: example_value
        type: query
        description: Pagination token for retrieving the next page of results.
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
        accessTokenUrl: https://login.microsoftonline.com/common/oauth2/v2.0/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: Retrieve all Copilot interactions across the organization for compliance and auditing purposes. Returns aiInteraction
      objects representing user prompts and Copilot responses across Microsoft 365 applications. Requires compliance administrator
      permissions.
- info:
    name: Change Notifications
    type: folder
  items:
  - info:
      name: Microsoft Copilot Create Subscription for Copilot Interaction Notifications
      type: http
    http:
      method: POST
      url: https://graph.microsoft.com/v1.0/subscriptions
      headers:
      - name: Authorization
        value: ''
      body:
        type: json
        data: '{}'
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
        accessTokenUrl: https://login.microsoftonline.com/common/oauth2/v2.0/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: Create a change notification subscription to monitor Copilot interactions across Microsoft 365 in real time. Enables
      proactive compliance checks, anomaly detection, and auditing of AI interactions. The resource path for Copilot interactions
      is /copilot/interactionHistory/getAllEnterpriseInteractions.
bundled: true