Microsoft Skype

Microsoft Skype Participants API

The Participants API from Microsoft Skype — 3 operation(s) for participants.

GitHub OpenAPI

Operations 3

GET /chat/threads/{chatThreadId}/participants Gets the participants of a thread #
POST /chat/threads/{chatThreadId}/participants/:remove Remove a participant from a thread #
POST /chat/threads/{chatThreadId}/participants/:add Adds thread participants to a thread. #

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/azure/communication-services/
📖
RateLimits
https://learn.microsoft.com/en-us/azure/communication-services/concepts/service-limits

Specifications

⚙
OpenAPI
https://artifacts.apis.io/microsoft-skype/openapi/microsoft-skype-participants-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/microsoft-skype:microsoft-skype-participants-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

microsoft-skype-participants-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Microsoft Skype Participants API
  version: '2025-03-15'
  description: 'Operations tagged Participants across 2 of this provider''s published API definitions: acs-chat-2025-03-15.json, microsoft-skype-chat-openapi.yml. Each path carries the servers of the definition it was published in.'
security:
- Authorization: []
tags:
- name: Participants
paths:
  /chat/threads/{chatThreadId}/participants:
    get:
      tags:
      - Participants
      summary: Gets the participants of a thread
      operationId: ChatThread_ListChatParticipants
      parameters:
      - in: path
        name: chatThreadId
        description: Thread id to get participants for.
        required: true
        schema:
          type: string
      - in: query
        name: maxPageSize
        description: The maximum number of participants to be returned per page.
        schema:
          type: integer
          format: int32
      - in: query
        name: skip
        description: Skips participants up to a specified position in response.
        schema:
          type: integer
          format: int32
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '200':
          description: Request successful. The action returns the participants of a thread.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChatParticipantsCollection'
        '401':
          description: Unauthorized.
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunicationErrorResponse'
        '403':
          description: Forbidden.
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunicationErrorResponse'
        '429':
          description: Too many requests.
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunicationErrorResponse'
        '503':
          description: Service unavailable.
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunicationErrorResponse'
      x-ms-examples:
        Get participants with pagination (max page size):
          $ref: ./examples/Participants_ListChatParticipantsWithPageSize.json
      x-ms-pageable:
        nextLinkName: nextLink
        itemName: value
  /chat/threads/{chatThreadId}/participants/:remove:
    post:
      tags:
      - Participants
      summary: Remove a participant from a thread
      operationId: ChatThread_RemoveChatParticipant
      parameters:
      - in: path
        name: chatThreadId
        description: Thread id to remove the participant from.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '204':
          description: Request successful.
        '401':
          description: Unauthorized.
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunicationErrorResponse'
        '403':
          description: Forbidden.
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunicationErrorResponse'
        '429':
          description: Too many requests.
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunicationErrorResponse'
        '503':
          description: Service unavailable.
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunicationErrorResponse'
      x-ms-examples:
        Remove participant:
          $ref: ./examples/Participants_RemoveChatParticipant.json
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CommunicationIdentifierModel'
          application/merge-patch+json:
            schema:
              $ref: '#/components/schemas/CommunicationIdentifierModel'
        description: Id of the thread participant to remove from the thread.
        required: true
  /chat/threads/{chatThreadId}/participants/:add:
    post:
      tags:
      - Participants
      summary: Adds thread participants to a thread.
      operationId: ChatThread_AddChatParticipants
      parameters:
      - in: path
        name: chatThreadId
        description: Id of the thread to add participants to.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '201':
          description: The participants were successfully added.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddChatParticipantsResult'
        '401':
          description: Unauthorized.
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunicationErrorResponse'
        '403':
          description: Forbidden.
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunicationErrorResponse'
        '429':
          description: Too many requests.
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunicationErrorResponse'
        '503':
          description: Service unavailable.
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunicationErrorResponse'
      x-ms-examples:
        Add participants:
          $ref: ./examples/Participants_AddChatParticipants.json
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddChatParticipantsRequest'
        description: Thread participants to be added to the thread.
        required: true
components:
  schemas:
    AddChatParticipantsRequest:
      description: Participants to be added to the thread.
      required:
      - participants
      type: object
      properties:
        participants:
          description: Participants to add to a chat thread.
          type: array
          items:
            $ref: '#/components/schemas/ChatParticipant'
    ChatParticipant:
      description: A participant of the chat thread.
      required:
      - communicationIdentifier
      type: object
      properties:
        communicationIdentifier:
          $ref: '#/components/schemas/CommunicationIdentifierModel'
        displayName:
          description: Display name for the chat participant.
          type: string
          example: Bob
        shareHistoryTime:
          format: date-time
          description: 'Time from which the chat history is shared with the participant. The timestamp is in RFC3339 format: `yyyy-MM-ddTHH:mm:ssZ`.'
          type: string
          example: '2020-10-30T10:50:50Z'
        metadata:
          description: Contextual metadata for the chat participant. The metadata consists of name/value pairs. The total size of all metadata pairs can be up to 1KB in size.
          type: object
          additionalProperties:
            type: string
    AddChatParticipantsResult:
      description: Result of the add chat participants operation.
      type: object
      properties:
        invalidParticipants:
          description: The participants that failed to be added to the chat thread.
          type: array
          items:
            $ref: '#/components/schemas/CommunicationError'
          readOnly: true
    CommunicationError:
      $ref: ../../../Common/stable/2023-11-15/common.json#/definitions/CommunicationError
    ChatParticipantsCollection:
      description: Collection of participants belong to a particular thread.
      required:
      - value
      type: object
      properties:
        value:
          description: Chat participants.
          type: array
          items:
            $ref: '#/components/schemas/ChatParticipant'
        nextLink:
          description: If there are more chat participants that can be retrieved, the next link will be populated.
          type: string
          readOnly: true
    CommunicationIdentifierModel:
      $ref: ../../../Common/stable/2025-06-30/common.json#/definitions/CommunicationIdentifierModel
    CommunicationErrorResponse:
      $ref: ../../../Common/stable/2023-11-15/common.json#/definitions/CommunicationErrorResponse
  parameters:
    ApiVersionParameter:
      in: query
      name: api-version
      description: Version of API to invoke.
      required: true
      x-ms-parameter-location: method
      schema:
        type: string
  securitySchemes:
    Authorization:
      type: apiKey
      name: Authorization
      in: header
      description: An ACS (Azure Communication Services) user access token.
x-refined-from:
- acs-chat-2025-03-15.json
- microsoft-skype-chat-openapi.yml
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/components/parameters/Endpoint'