Work IQ Teams-Referenz (Vorschau)

Chattools

mcp_graph_chat_addChatMember

Endpunkt:POST /v1.0/chats/{chat-id}/members

Fügt einem Chat ein Mitglied unter Verwendung von user@odata.bind, @odata.type und optionalen Rollen (Mitglied, Besitzer) hinzu. Gibt einen Fehlercode 409 zurück, wenn das Element bereits vorhanden ist, einen Fehlercode von 400 für ungültige Benutzerverweise oder einen 403-Fehlercode, wenn Richtlinien das Hinzufügen einschränken.

Erforderliche Parameter: chat-id, @odata.type, user@odata.bind, roles

mcp_graph_chat_createChat

Endpunkt:POST /v1.0/chats

Erstellt einen neuen Teams-Chat mit chatType (oneOnOne erfordert genau zwei Teilnehmer, Gruppe braucht mehr als zwei) und Mitgliedern. Gibt einen Wert von 400 zurück, wenn oneOnOne die falsche Anzahl von Mitgliedern hat, 409, wenn die gleichen Teilnehmer bereits einen Chat haben, oder 403, wenn der Anrufer keine Berechtigung hat.

Erforderliche Parameter:chatType, Mitglieder

mcp_graph_chat_deleteChat

Endpunkt:DELETE /v1.0/chats/{chat-id}

Löscht einen Chat vorläufig. Gibt 403 zurück, wenn die Berechtigung fehlt, 404, wenn sie bereits gelöscht wurde und den Aufbewahrungsrichtlinien des Mandanten unterliegt.

Erforderliche Parameter: chat-id

mcp_graph_chat_deleteChatMessage

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

Löscht eine Chatnachricht vorübergehend. Gibt 403 ohne Chat.ReadWrite, 404 bei ungültigen IDs zurück und behält die Nachricht ggf. weiterhin für Compliance bei.

Erforderliche Parameter: user_id, chat_id, chatMessage_id

mcp_graph_chat_getChat

Endpunkt:GET /v1.0/chats/{chat-id}

Ruft einen Chat anhand der ID ab. Gibt Metadaten wie Typ und Thema zurück. Gibt einen Wert vom Typ 404 zurück, wenn der Chat nicht vorhanden ist oder nicht sichtbar ist, oder 403, wenn Berechtigungen verweigert werden.

Erforderliche Parameter: chat-id

mcp_graph_chat_getChatMessage

Endpunkt:GET /v1.0/chats/{chat-id}/messages/{message-id}

Ruft eine Chatnachricht anhand der ID ab. Gibt einen 404 zurück, wenn die Nachricht nicht vorhanden oder versteckt ist, oder einen 403, wenn keine ausreichenden Rechte vorliegen.

Erforderliche Parameter: Chat-ID, Message-ID

mcp_graph_chat_listChatMembers

Endpunkt:GET /v1.0/chats/{chat-id}/members

Listet die Chat-Teilnehmenden auf. Gibt Rollen (Mitglied, Besitzer oder Gast) zurück. Gibt einen Wert vom Typ 403 ohne Leseberechtigungen oder 404 zurück, wenn der Chat nicht gefunden wurde.

Erforderliche Parameter: chat-id

mcp_graph_chat_listChatMessages

Endpunkt:GET /v1.0/chats/{chat-id}/messages

Listet Nachrichten in einem Chat mit optionalem $top, $filter, und $orderby auf. Gibt Ergebnisseiten zurück. Die Compliance kann Inhalte ausblenden. Fehler umfassen 400 bei fehlerhaften Abfragen und 429 bei Drosselung.

Erforderliche Parameter: chat-id

Optionale Parameter:$top, , $filter$orderby

mcp_graph_chat_listChats

Endpunkt:GET /v1.0/chats

Listet Chats für den Aufrufenden mit optionalem $top, $filter, $expand, und $orderby auf. Gibt nur sichtbare Chats zurück; ausgeblendete Chats oder Systemchats können ausgeschlossen werden. Gibt einen Wert vom Typ 400 für ungültige Sortierausdrücke zurück.

Optionale Parameter:$top, $orderby, $expand$filter

mcp_graph_chat_postMessage

Endpunkt:POST /v1.0/chats/{chat-id}/messages

Veröffentlicht eine neue Nur-Text-Nachricht in einem Chat. Benötigt chat-id und nicht leeren body.content, nur Text wird unterstützt. Gibt möglicherweise eine 429 für Drosselung, eine 403 zurück, wenn Berechtigungen fehlen, oder 404, wenn der Chat ungültig ist. Nicht idempotent—avoid blinde Wiederholungen.

Erforderliche Parameter: chat-id, body

mcp_graph_chat_updateChat

Endpunkt:PATCH /v1.0/chats/{chat-id}

Aktualisiert Chateigenschaften, wie beispielsweise das Thema, jedoch nur für Gruppenchats. Schlägt mit 400 bei Benutzung in einem 1:1-Chat fehl, oder 403 ohne Berechtigung, oder 404, wenn der Chat nicht gefunden wird.

Erforderliche Parameter: chat-id, topic

mcp_graph_chat_updateChatMessage

Endpunkt:PATCH /v1.0/chats/{chat-id}/messages/{message-id}

Aktualisiert eine Chatnachricht mit neuen Nur-Text-Inhalten. Einige System- oder Compliancenachrichten blockieren die Bearbeitung. Der Vorgang gibt eine 403 oder 400 zurück, wenn die Bearbeitung nicht zulässig ist, oder eine 409 für Konflikte.

Erforderliche Parameter: Chat-ID, Message-ID

Kanal- und Teamtools

mcp_graph_teams_addChannelMember

Endpunkt:POST /v1.0/teams/{team-id}/channels/{channel-id}/members

Fügt einem privaten oder freigegebenen Kanal ein Mitglied mit user@odata.bind, @odata.type und optionalen Rollen (Besitzer oder leer) hinzu. Schlägt auf Standardkanälen fehl. Gibt eine 409 zurück, wenn das Mitglied bereits vorhanden ist, und eine 403, wenn Berechtigungen fehlen.

Erforderliche Parameter: team-id, channel-id, displayName, Rollen, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

Endpunkt:POST /v1.0/teams/{team-id}/channels

Erstellt einen Kanal in einem Team mit displayName, einer optionalen Beschreibung, membershipType (Standard, Privat, freigegeben) und optionalen Mitgliedern. Private oder freigegebene Kanäle erfordern explizite Mitglieder. Duplikate oder ungültige Mitgliedschaften verursachen einen 400- oder 409-Fehler.

Erforderliche Parameter: team-id, displayName

Optionale Parameter: description, membershipType, members

mcp_graph_teams_createPrivateChannel

Endpunkt:POST /v1.0/teams/{team-id}/channels

Erstellt einen privaten Kanal durch Festlegen membershipType auf private. Sie müssen Mitglieder einschließen, wenn Sie den Kanal erstellen, und die Mitgliederliste muss mindestens einen Besitzer haben. Gibt einen Wert von 400 zurück, wenn die Member fehlen, ein 409 für doppelte Namen oder ein 403, wenn der Aufrufer nicht über Berechtigungen verfügt.

Erforderliche Parameter: team-id, displayName, members

mcp_graph_teams_getChannel

Endpunkt:GET /v1.0/teams/{team-id}/channels/{channel-id}

Ruft einen bestimmten Kanal mit den optionalen Parametern $select und $filter ab. Gibt einen 404 zurück, wenn der Kanal nicht gefunden wird oder der Anrufer keinen Zugriff hat, einen 403, wenn Berechtigungen nicht ausreichend sind, oder einen 400 für nicht unterstützte Filter.

Erforderliche Parameter: team-id, channel-id

Optionale Parameter:$select, $filter

mcp_graph_teams_getTeam

Endpunkt:GET /v1.0/teams/{team-id}

Ruft Teameigenschaften mit optionalen Komponenten $select und $expand ab. Gibt einen HTTP-Statuscode 403 oder 404 zurück, wenn das Team nicht zugänglich ist.

Erforderliche Parameter: team-id

Optionale Parameter:$select, $expand

mcp_graph_teams_listChannelMembers

Endpunkt:GET /v1.0/teams/{team-id}/channels/{channel-id}/members

Listet alle Mitglieder eines bestimmten Microsoft Teams Kanals auf. Gibt Metadaten zu jedem Mitglied zurück, z. B. Identitäts-, Rollen- und Mitgliedschaftsstatus. Diese Informationen sind nützlich für die Überwachung der Kanalteilnahme, das Überprüfen der Mitgliedschaft vor Rollenupdates oder die Sicherstellung der Compliance.

Erforderliche Parameter: team-id, channel-id

Optionale Parameter:$top, $expand

mcp_graph_teams_listChannelMessages

Endpunkt:GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

Listet Nachrichten in einem Kanal auf. Verwenden Sie die optionalen $top Und $expand Parameter, um die Ergebnisse anzupassen. Verwenden Sie z. B. $expand, um Antworten einzuschließen. Die Paginierung erfolgt über @odata.nextLink. Gibt eine 403 ohne Leseberechtigung oder 400 für ungültige Abfrageoptionen zurück.

Erforderliche Parameter: team-id, channel-id

Optionale Parameter:$top, $expand

mcp_graph_teams_listChannels

Endpunkt:GET /v1.0/teams/{team-id}/allChannels

Listet Kanäle in einem Team auf. Verwenden Sie die optionalen $select Parameter, $filter um die Ergebnisse anzupassen. Gibt private und freigegebene Kanäle nur zurück, wenn der Aufrufende Mitglied ist. Schlägt mit 403 fehl, wenn der Aufrufende keine Leserechte hat, oder mit 400 bei ungültigen OData-Abfragen.

Erforderliche Parameter: team-id

Optionale Parameter:$select, $filter

mcp_graph_teams_listTeams

Endpunkt:GET /v1.0/users/{user-id}/joinedTeams

Listet die verbundenen Teams eines bestimmten Benutzers auf. Gibt nur Mitgliedschaften dieses Benutzers zurück, nicht alle Mandantenteams. Gibt einen 403 zurück, wenn der Aufrufer den Benutzer nicht abfragen kann, oder einen 404, wenn die ID ungültig ist.

Erforderliche Parameter: user-id

mcp_graph_teams_postChannelMessage

Endpunkt:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

Sendet eine Nur-Text-Nachricht an einen Kanal. Erfordert team-id, channel-id und body.content. Gibt eine 403 ohne ChannelMessage.Send, einen 404 zurück, wenn der Kanal nicht gefunden wurde, oder einen 400, wenn Inhalt fehlt.

Erforderliche Parameter: team-id, channel-id, body

mcp_graph_teams_replyToChannelMessage

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

Antwortet auf eine Nachricht in einem Kanal mithilfe von body.content. Es wird nur reiner Text unterstützt. Gibt einen Wert vom Typ 404 zurück, wenn die übergeordnete Nachricht nicht gefunden wird, eine 403 ohne Rechte oder eine 400 für ungültige Inhalte.

Erforderliche Parameter: team-id, channel-id, message-id, body

mcp_graph_teams_updateChannel

Endpunkt:PATCH /teams/{team-id}/channels/{channel-id}

Aktualisiert einen Kanal mit einer neuen displayName oder Beschreibung. Einschränkungen könnten für spezielle Kanäle wie General gelten. Gibt einen Wert vom Typ 403 ohne Rechte, einen Wert von 409 für doppelte Namen oder 400 für ungültige Eingaben zurück.

Erforderliche Parameter: team-id, channel-id

Optionale Parameter: displayName, description

mcp_graph_teams_updateChannelMember

Endpunkt:PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}

Aktualisiert die Rolle eines Mitglieds in einem privaten oder freigegebenen Kanal durch Ändern von Rollen. Standardkanäle erben Rollen vom Team und lehnen Aktualisierungen in der Regel ab. Gibt einen 400 zurück, wenn der Zugriff auf Standard-Kanäle erfolgt, einen 403, wenn keine Berechtigung vorliegt, oder einen 404, wenn das Mitglied nicht gefunden wird.

Erforderliche Parameter: team-id, channel-id, membership-id, roles

Unterstützte Operationen

• Chatverwaltung (Erstellen, Lesen, Aktualisieren, Löschen)
• Nachrichtenvorgänge (Senden, Abrufen, Bearbeiten, Löschen)
• Kanalverwaltung (Erstellen, Konfigurieren, Auflisten)
• Mitgliederverwaltung (Hinzufügen, Aktualisieren, Auflisten)
• Teamvorgänge (Abrufen, Auflisten)

Schlüsselfunktionen

• Vollständige Erstellungs-, Lese-, Aktualisierungs- und Löschvorgänge (CRUD) für Chats und Kanäle
• Unterstützung für private, freigegebene und Standardkanäle
• Nachrichten-Threading und -Antworten
• Mitgliederrollenverwaltung
• OData-Abfrageunterstützung für Filterung und Paginierung