Microsoft Azure Azure Communication Chat Service — Participants

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Azure Communication Chat Service — Participants
  description: 'Microsoft Azure Azure Communication Chat Service — Participants. 3 operations. Lead operation: Microsoft Azure
    Gets The Participants Of A Thread. Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - Participants
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: azure-communication-chat-service-participants
    baseUri: ''
    description: Microsoft Azure Azure Communication Chat Service — Participants business capability. Self-contained, no shared
      references.
    resources:
    - name: chat-threads-chatThreadId-participants
      path: /chat/threads/{chatThreadId}/participants
      operations:
      - name: microsoftazurechatthreadlistchatparticipants
        method: GET
        description: Microsoft Azure Gets The Participants Of A Thread
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chatThreadId
          in: path
          type: string
          description: Thread id to get participants for.
          required: true
        - name: maxPageSize
          in: query
          type: integer
          description: The maximum number of participants to be returned per page.
        - name: skip
          in: query
          type: integer
          description: Skips participants up to a specified position in response.
    - name: chat-threads-chatThreadId-participants-:add
      path: /chat/threads/{chatThreadId}/participants/:add
      operations:
      - name: microsoftazurechatthreadaddchatparticipants
        method: POST
        description: Microsoft Azure Adds Thread Participants To A Thread If Participants Already Exist, No Change Occurs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chatThreadId
          in: path
          type: string
          description: Id of the thread to add participants to.
          required: true
        - name: addChatParticipantsRequest
          in: body
          type: string
          description: Thread participants to be added to the thread.
          required: true
    - name: chat-threads-chatThreadId-participants-:remove
      path: /chat/threads/{chatThreadId}/participants/:remove
      operations:
      - name: microsoftazurechatthreadremovechatparticipant
        method: POST
        description: Microsoft Azure Remove A Participant From A Thread
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chatThreadId
          in: path
          type: string
          description: Thread id to remove the participant from.
          required: true
        - name: participantCommunicationIdentifier
          in: body
          type: string
          description: Id of the thread participant to remove from the thread.
          required: true
  exposes:
  - type: rest
    namespace: azure-communication-chat-service-participants-rest
    port: 8080
    description: REST adapter for Microsoft Azure Azure Communication Chat Service — Participants. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/chat/threads/{chatthreadid}/participants
      name: chat-threads-chatthreadid-participants
      description: REST surface for chat-threads-chatThreadId-participants.
      operations:
      - method: GET
        name: microsoftazurechatthreadlistchatparticipants
        description: Microsoft Azure Gets The Participants Of A Thread
        call: azure-communication-chat-service-participants.microsoftazurechatthreadlistchatparticipants
        with:
          chatThreadId: rest.chatThreadId
          maxPageSize: rest.maxPageSize
          skip: rest.skip
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/chat/threads/{chatthreadid}/participants/add
      name: chat-threads-chatthreadid-participants-add
      description: REST surface for chat-threads-chatThreadId-participants-:add.
      operations:
      - method: POST
        name: microsoftazurechatthreadaddchatparticipants
        description: Microsoft Azure Adds Thread Participants To A Thread If Participants Already Exist, No Change Occurs
        call: azure-communication-chat-service-participants.microsoftazurechatthreadaddchatparticipants
        with:
          chatThreadId: rest.chatThreadId
          addChatParticipantsRequest: rest.addChatParticipantsRequest
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/chat/threads/{chatthreadid}/participants/remove
      name: chat-threads-chatthreadid-participants-remove
      description: REST surface for chat-threads-chatThreadId-participants-:remove.
      operations:
      - method: POST
        name: microsoftazurechatthreadremovechatparticipant
        description: Microsoft Azure Remove A Participant From A Thread
        call: azure-communication-chat-service-participants.microsoftazurechatthreadremovechatparticipant
        with:
          chatThreadId: rest.chatThreadId
          participantCommunicationIdentifier: rest.participantCommunicationIdentifier
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: azure-communication-chat-service-participants-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Azure Communication Chat Service — Participants. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-gets-participants-thread
      description: Microsoft Azure Gets The Participants Of A Thread
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-communication-chat-service-participants.microsoftazurechatthreadlistchatparticipants
      with:
        chatThreadId: tools.chatThreadId
        maxPageSize: tools.maxPageSize
        skip: tools.skip
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-adds-thread-participants
      description: Microsoft Azure Adds Thread Participants To A Thread If Participants Already Exist, No Change Occurs
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-communication-chat-service-participants.microsoftazurechatthreadaddchatparticipants
      with:
        chatThreadId: tools.chatThreadId
        addChatParticipantsRequest: tools.addChatParticipantsRequest
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-remove-participant-thread
      description: Microsoft Azure Remove A Participant From A Thread
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-communication-chat-service-participants.microsoftazurechatthreadremovechatparticipant
      with:
        chatThreadId: tools.chatThreadId
        participantCommunicationIdentifier: tools.participantCommunicationIdentifier
      outputParameters:
      - type: object
        mapping: $.