Informations de référence sur Work IQ Teams (aperçu)

Outils de conversation instantanée

mcp_graph_chat_addChatMember

Extrémité:POST /v1.0/chats/{chat-id}/members

Ajoute un membre à une conversation instantanée à l’aide de user@odata.bind@odata.type et de rôles facultatifs (membre, propriétaire). Retourne un code d’erreur 409 si le membre est déjà présent, un code d’erreur 400 pour les références utilisateur non valides ou un code d’erreur 403 si les stratégies limitent l’ajout.

Paramètres requis : chat-id, @odata.type, user@odata.bind, roles

mcp_graph_chat_createChat

Extrémité:POST /v1.0/chats

Crée un nouveau chat Teams avec chatType (oneOnOne nécessite exactement deux participants, le groupe en nécessite plus de deux) et les membres. Retourne une valeur de 400 si oneOnOne le nombre de membres est incorrect, 409 si les mêmes participants ont déjà une conversation ou 403 si l’appelant n’a pas de droits.

Paramètres requis :chatType membres

mcp_graph_chat_supprimerChat

Extrémité:DELETE /v1.0/chats/{chat-id}

Supprime temporairement un chat. Retourne une valeur 403 si l’autorisation est manquante ou 404 si elle est déjà supprimée et est soumise à des stratégies de rétention de locataire.

Paramètres requis : chat-id

mcp_graph_chat_deleteChatMessage

Extrémité:POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

Supprime de manière réversible un message de chat. Retourne un 403 sans Chat.ReadWrite, un 404 pour les ID non valides et peut conserver le message pour la conformité.

Paramètres requis : user-id, chat-id, chatMessage-id

mcp_graph_chat_obtenirChat

Extrémité:GET /v1.0/chats/{chat-id}

Récupère une conversation par identifiant. Retourne des métadonnées telles que le type et la rubrique. Retourne une valeur 404 si la conversation n’existe pas ou n’est pas visible, ou 403 si les autorisations sont refusées.

Paramètres requis : chat-id

mcp_graph_chat_getChatMessage

Extrémité:GET /v1.0/chats/{chat-id}/messages/{message-id}

Récupère un message de conversation par ID. Retourne une valeur 404 si le message n’existe pas ou est masqué, ou un 403 sans droits appropriés.

Paramètres requis : chat-id, message-id

mcp_graph_chat_listeDesMembresDuChat

Extrémité:GET /v1.0/chats/{chat-id}/members

Répertorie les participants à la conversation instantanée. Retourne des rôles (membre, propriétaire ou invité). Renvoie un 403 sans autorisations de lecture ou un 404 si la conversation est introuvable.

Paramètres requis : chat-id

mcp_graph_chat_listChatMessages

Extrémité:GET /v1.0/chats/{chat-id}/messages

Répertorie les messages dans une conversation avec les éléments optionnels $top, $filter, et $orderby. Retourne les résultats paginés. La conformité peut masquer le contenu. Les erreurs incluent une valeur 400 pour les requêtes incorrectes et une valeur 429 pour la limitation.

Paramètres requis : chat-id

Paramètres facultatifs :$top, $filter, $orderby

mcp_graph_chat_listChats

Extrémité:GET /v1.0/chats

Répertorie les conversations pour l’appelant avec $top, $filter, $expand et $orderby facultatifs. Renvoie uniquement les conversations visibles ; les conversations masquées ou système peuvent être exclues. Retourne une valeur 400 pour les expressions de tri non valides.

Paramètres facultatifs :$top, $orderby, , $expand$filter

mcp_graph_chat_postMessage

Extrémité:POST /v1.0/chats/{chat-id}/messages

Publie un nouveau message en texte brut dans une conversation. Nécessite un chat-id et un contenu non vide de body.content ; seul le texte est pris en charge. Peut retourner un 429 pour la régulation de débit, un 403 si des autorisations sont manquantes, ou un 404 si la conversation n’est pas valide. Pas de idempotent—avoid tentatives à l’aveugle.

Paramètres requis : chat-id, body

mcp_graph_chat_updateChat

Extrémité:PATCH /v1.0/chats/{chat-id}

Met à jour les propriétés d’une conversation, comme le sujet, uniquement pour les conversations de groupe. Renvoie un code d'erreur 400 si utilisé sur une conversation en tête-à-tête, 403 en l’absence de droits, ou 404 si la conversation est introuvable.

Paramètres requis : chat-id, topic

mcp_graph_chat_updateChatMessage

Extrémité:PATCH /v1.0/chats/{chat-id}/messages/{message-id}

Met à jour un message de conversation avec un nouveau contenu en texte brut. Certains messages système ou de conformité bloquent la modification. L’opération retourne une valeur 403 ou 400 si la modification n’est pas autorisée, ou une valeur 409 pour les conflits.

Paramètres requis : chat-id, message-id

Outils pour les canaux et les équipes

mcp_graph_teams_addChannelMember

Extrémité:POST /v1.0/teams/{team-id}/channels/{channel-id}/members

Ajoute un membre à un canal privé ou partagé à l’aide de user@odata.bind, @odata.type et de rôles facultatifs (propriétaire ou vide). Échoue sur les canaux standard. Retourne une valeur 409 si le membre est déjà présent et un 403 s’il n’a pas d’autorisations.

Paramètres requis : identifiant d’équipe, identifiant de canal, displayName, rôles, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

Extrémité:POST /v1.0/teams/{team-id}/channels

Crée un canal dans une équipe avec displayName, une description facultative, membershipType (standard, privé, partagé) et des membres facultatifs. Les canaux privés ou partagés nécessitent des membres explicites. Les doublons ou les appartenances non valides provoquent un 400 ou 409.

Paramètres requis : team-id, displayName

Paramètres facultatifs : description, type d'adhésion, membres

mcp_graph_teams_createPrivateChannel

Extrémité:POST /v1.0/teams/{team-id}/channels

Crée un canal privé en définissant membershipType sur private. Vous devez inclure des membres lorsque vous créez le canal, et la liste des membres doit avoir au moins un propriétaire. Retourne une valeur 400 si les membres sont manquants, 409 pour les noms en double ou 403 si l’appelant n’a pas d’autorisations.

Paramètres requis : team-id, displayName, members

mcp_graph_teams_getChannel

Extrémité:GET /v1.0/teams/{team-id}/channels/{channel-id}

Récupère un canal avec les options facultatives $select et $filter. Retourne une valeur 404 si le canal n'est pas trouvé ou si l'appelant n'a pas access, un 403 si les autorisations sont insuffisantes ou 400 pour les filtres non pris en charge.

Paramètres requis : team-id, channel-id

Paramètres facultatifs :$select, $filter

mcp_graph_teams_getTeam

Extrémité:GET /v1.0/teams/{team-id}

Récupère les propriétés de l'équipe avec les options $select et $expand facultatives. Retourne une valeur 403 ou 404 si l’équipe est inaccessible.

Paramètres requis : team-id

Paramètres facultatifs :$select, $expand

mcp_graph_teams_listChannelMembers

Extrémité:GET /v1.0/teams/{team-id}/channels/{channel-id}/members

Répertorie tous les membres d’un canal Microsoft Teams spécifique. Retourne des métadonnées sur chaque membre, telles que l’identité, les rôles et l’état d’appartenance. Ces informations sont utiles pour auditer la participation des canaux, vérifier l’appartenance avant les mises à jour de rôle ou garantir la conformité.

Paramètres requis : team-id, channel-id

Paramètres facultatifs :$top, $expand

mcp_graph_teams_listChannelMessages

Extrémité:GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

Répertorie les messages d’un canal. Utilisez les paramètres facultatifs $top et $expand pour personnaliser les résultats. Par exemple, utilisez cette méthode $expand pour inclure des réponses. La pagination est gérée via @odata.nextLink. Renvoie une valeur 403 sans autorisation de lecture ou 400 pour les options de requête non valides.

Paramètres requis : team-id, channel-id

Paramètres facultatifs :$top, $expand

mcp_graph_teams_listChannels

Extrémité:GET /v1.0/teams/{team-id}/allChannels

Répertorie les canaux d’une équipe. Utilisez les paramètres facultatifs $select ou $filter pour personnaliser les résultats. Renvoie les canaux privés et partagés uniquement si l’appelant en est membre. Échoue avec un 403 si l’appelant n’a pas de droits de lecture ou 400 sur des requêtes OData non valides.

Paramètres requis : team-id

Paramètres facultatifs :$select, $filter

mcp_graph_teams_listTeams

Extrémité:GET /v1.0/users/{user-id}/joinedTeams

Répertorie les équipes auxquelles un utilisateur spécifique a adhéré. Renvoie uniquement les adhésions de cet utilisateur, et non pas toutes les équipes du tenant. Retourne une valeur 403 si l’appelant ne peut pas interroger l’utilisateur ou un 404 si l’ID n’est pas valide.

Paramètres obligatoires : user-id

mcp_graph_teams_postChannelMessage

Extrémité:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

Publie un message en texte brut dans un canal. Nécessite team-id, channel-id et body.content Retourne une valeur 403 sans ChannelMessage.Send, une valeur 404 si le canal est introuvable ou un 400 si le contenu est manquant.

Paramètres requis : team-id, channel-id, body

mcp_graph_teams_replyToChannelMessage

Extrémité:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies

Répond à un message dans un canal à l’aide de body.content. Seul le texte brut est pris en charge. Retourne une valeur 404 si le message parent n’est pas trouvé, un 403 sans droits ou un 400 pour le contenu non valide.

Paramètres requis : team-id, channel-id, message-id, body

mcp_graph_teams_updateChannel

Extrémité:PATCH /teams/{team-id}/channels/{channel-id}

Met à jour un canal avec un nouveau displayName ou une description. Des restrictions peuvent s’appliquer à des chaînes spéciales comme Général. Retourne un 403 sans droits, un 409 sur les noms en double ou un 400 pour une entrée non valide.

Paramètres requis : team-id, channel-id

Paramètres facultatifs : displayName, description

mcp_graph_teams_updateChannelMember

Extrémité:PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}

Met à jour le rôle d’un membre dans un canal privé ou partagé en modifiant ses rôles. Les canaux standard héritent des rôles de l’équipe et rejettent généralement les mises à jour. Retourne une valeur 400 si elle a été tentée sur des canaux standard, une valeur 403 si elle n’est pas autorisée ou 404 si le membre n’est pas trouvé.

Paramètres requis : identifiant équipe (team-id), identifiant canal (channel-id), identifiant adhésion (membership-id), rôles

Opérations prises en charge

• Gestion des conversations (créer, lire, mettre à jour, supprimer)
• Opérations message (envoyer, récupérer, modifier, supprimer)
• Gestion des canaux (créer, configurer, répertorier)
• Gestion des membres (ajouter, mettre à jour, répertorier)
• Opérations d’équipe (récupérer, répertorier)

Fonctionnalités clés

• Opérations de création, de lecture, de mise à jour et de suppression complètes (CRUD) pour les conversations et les canaux
• Prise en charge des canaux privés, partagés et standard
• Fils de messages et réponses
• Gestion des rôles des membres
• Prise en charge des requêtes OData pour le filtrage et la pagination