Teams-referens (förhandsvisning)

Overview

Chattverktyg

mcp_graph_chat_addChatMember

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

Lägger till en medlem i en chatt med hjälp av user@odata.bind, @odata.type och valfria roller (medlem, ägare). Returnerar en 409-felkod om medlemmen redan finns, en 400-felkod för ogiltiga användarreferenser eller en 403-felkod om principer begränsar tillägg.

Obligatoriska parametrar: chat-id, @odata.type, user@odata.bind, roller

mcp_graph_chat_createChat

Slutpunkt:POST /v1.0/chats

Skapar en ny Teams-chatt med chatType (oneOnOne kräver exakt två deltagare, gruppen kräver mer än två) och medlemmar. Returnerar 400 om oneOnOne har fel medlemsantal, 409 om samma deltagare redan har en chatt eller 403 om anroparen saknar rättigheter.

Obligatoriska parametrar:chatType, medlemmar

mcp_graph_chat_deleteChat

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

Mjuk tar bort en chatt. Returnerar en 403 om behörighet saknas eller en 404 om den redan har tagits bort. Klientorganisationens kvarhållningsprinciper styr denna åtgärd.

Obligatoriska parametrar: chatt-id

mcp_graph_chat_deleteChatMessage

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

Mjukraderar ett chattmeddelande. Returnerar en 403 utan Chat.ReadWrite, en 404 för ogiltiga ID:er och kan fortfarande behålla meddelandet för efterlevnad.

Obligatoriska parametrar: user-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

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

Hämtar en chatt med ID. Returnerar metadata som typ och ämne. Returnerar en 404 om chatten inte finns eller inte är synlig, eller 403 om behörigheter nekas.

Obligatoriska parametrar: chatt-id

mcp_graph_chat_getChatMessage

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

Hämtar ett chattmeddelande via ID. Returnerar en 404 om meddelandet inte finns eller är dolt, eller en 403 utan rätt rättigheter.

Obligatoriska parametrar: chatt-id, meddelande-ID

mcp_graf_chatt_listaChattMedlemmar

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

Visar en lista över chattdeltagare. Returnerar roller (medlem, ägare eller gäst). Returnerar en 403 utan läsbehörighet eller 404 om chatten inte hittas.

Obligatoriska parametrar: chatt-id

mcp_graph_chat_listChatMessages

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

Visar en lista med meddelanden i en chatt med valfria $top, $filteroch $orderby. Returnerar sidsidiga resultat. Efterlevnad kan dölja innehåll. Fel inkluderar ett 400-fel för felaktiga frågor och ett 429-fel för begränsning av begäranden.

Obligatoriska parametrar: chatt-id

Valfria parametrar:$top, $filter, $orderby

mcp_graph_chat_listChats

Slutpunkt:GET /v1.0/chats

Visar en lista över chattar för anroparen med valfria $top, $filter, $expandoch $orderby. Returnerar endast synliga chattar. dolda chattar eller systemchatter kan uteslutas. Returnerar 400 för ogiltiga sorteringsuttryck.

Valfria parametrar:$top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

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

Publicerar ett nytt oformaterad textmeddelande i en chatt. Kräver chatt-id och icke-tomt body.content; endast text stöds. Kan returnera 429 för hastighetsbegränsning, 403 om behörighet saknas eller 404 om chatten är ogiltig. Inte idempotent—avoid blinda omförsök.

Obligatoriska parametrar: chatt-id, meddelandekropp

mcp_graph_chat_updateChat

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

Uppdaterar chattegenskaper, till exempel endast ämnet för gruppchatter. Misslyckas med 400 om det används i en en-mot-en-chatt, 403 utan rättigheter eller 404 om chatten inte hittas.

Obligatoriska parametrar: chatt-id, ämne

mcp_graph_chat_updateChatMessage

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

Uppdaterar ett chattmeddelande med nytt oformaterad textinnehåll. Vissa system- eller efterlevnadsmeddelanden blockerar redigering. Åtgärden returnerar 403 eller 400 om redigering inte tillåts eller en 409 för konflikter.

Obligatoriska parametrar: chatt-id, meddelande-ID

Kanal- och teamverktyg

mcp_graph_teams_addChannelMember

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

Lägger till en medlem i en privat eller delad kanal med hjälp av user@odata.bind, @odata.type och valfria roller (ägare eller ingen). Misslyckas i standardkanaler. Returnerar en 409 om medlemmen redan finns och en 403 om den saknar behörighet.

Obligatoriska parametrar: team-id, channel-id, displayName, roles, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

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

Skapar en kanal i ett team med displayName, valfri beskrivning, (standard, membershipType privat, delad) och valfria medlemmar. Privata eller delade kanaler kräver explicita medlemmar. Dubbletter eller ogiltigt medlemskap orsakar 400 eller 409.

Obligatoriska parametrar: team-id, displayName

Valfria parametrar: beskrivning, membershipType, medlemmar

mcp_graph_teams_createPrivateChannel

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

Skapar en privat kanal genom att ange membershipType till private. Du måste inkludera medlemmar när du skapar kanalen och medlemslistan måste ha minst en ägare. Returnerar 400 om medlemmarna saknas, 409 för dubblettnamn eller 403 om anroparen inte har behörighet.

Obligatoriska parametrar: team-id, displayName, medlemmar

mcp_graph_teams_getChannel

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

Hämtar en kanal med valfritt $select och $filter. Returnerar en 404 om kanalen inte hittas eller anroparen saknar åtkomst, 403 om behörigheterna är otillräckliga eller 400 för filter som inte stöds.

Obligatoriska parametrar: team-id, kanal-id

Valfria parametrar:$select, $filter

mcp_graph_teams_getTeam

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

Hämtar teamegenskaper med valfritt $select och $expand. Returnerar 403 eller 404 om teamet inte är tillgängligt.

Obligatoriska parametrar: team-id

Valfria parametrar:$select, $expand

mcp_graph_teams_listChannelMembers

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

Visar en lista över alla medlemmar i en specifik Microsoft Teams kanal. Returnerar metadata om varje medlem, till exempel identitet, roller och medlemskapsstatus. Den här informationen är användbar för granskning av kanalinflytande, verifiering av medlemskap före rolluppdateringar eller för att säkerställa efterlevnad.

Obligatoriska parametrar: team-id, kanal-id

Valfria parametrar:$top, $expand

mcp_graph_teams_listChannelMessages

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

Visar en lista med meddelanden i en kanal. Använd de valfria $top parametrarna och $expand för att anpassa resultatet. Använd till exempel $expand för att inkludera svar. Sidnumrering hanteras via @odata.nextLink. Returnerar en 403 utan läsbehörighet eller 400 för ogiltiga frågealternativ.

Obligatoriska parametrar: team-id, kanal-id

Valfria parametrar:$top, $expand

mcp_graph_teams_listChannels

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

Visar kanaler i ett team. Använd valfria $select parametrar eller $filter parametrar för att anpassa resultatet. Returnerar endast privata och delade kanaler om anroparen är medlem. Misslyckas med en 403 om anroparen saknar läsbehörighet eller 400 på ogiltiga OData-frågor.

Obligatoriska parametrar: team-id

Valfria parametrar:$select, $filter

mcp_graph_teams_listTeams

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

Visar en lista över de anslutna teamen för en specifik användare. Returnerar endast medlemskap för den användaren, inte alla klientteam. Returnerar en 403 om anroparen inte kan fråga användaren eller 404 om ID:t är ogiltigt.

Obligatoriska parametrar: användar-ID

mcp_graph_teams_postChannelMessage

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

Skickar ett oformaterad textmeddelande till en kanal. Kräver team-id, kanal-id och body.content. Returnerar en 403 utan ChannelMessage.Send, en 404 om kanalen inte hittas eller en 400 om innehållet saknas.

Obligatoriska parametrar: team-id, kanal-id, brödtext

mcp_graph_teams_replyToChannelMessage

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

Svarar på ett meddelande i en kanal med hjälp av body.content. Endast oformaterad text stöds. Returnerar en 404 om det överordnade meddelandet inte hittas, en 403 utan rättigheter eller 400 för ogiltigt innehåll.

Obligatoriska parametrar: team-id, kanal-id, meddelande-id, brödtext

mcp_graph_teams_uppdateraKanal

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

Uppdaterar en kanal med en ny displayName eller en beskrivning. Begränsningar kan gälla för särskilda kanaler som Allmänt. Returnerar en 403 utan rättigheter, en 409 på dubblettnamn eller en 400 för ogiltiga indata.

Obligatoriska parametrar: team-id, kanal-id

Valfria parametrar: displayName, beskrivning

mcp_graph_teams_updateChannelMember

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

Uppdaterar en medlems roll i en privat eller delad kanal genom att ändra roller. Standardkanaler ärver roller från teamet och avvisar vanligtvis uppdateringar. Returnerar en 400 om det görs ett försök på standardkanaler, en 403 om den är obehörig eller en 404 om medlemmen inte hittas.

Obligatoriska parametrar: team-id, kanal-id, medlemskaps-ID, roller

Åtgärder som stöds

• Chatthantering (skapa, läsa, uppdatera, ta bort)
• Meddelandeåtgärder (skicka, hämta, redigera, ta bort)
• Kanalhantering (skapa, konfigurera, lista)
• Medlemshantering (lägg till, uppdatera, lista)
• Teamåtgärder (hämta, lista)

Centrala egenskaper

• Fullständigt stöd för att skapa, läsa, uppdatera och radera (CRUD) chattar och kanaler.
• Stöd för privata, delade och standardkanaler.
• Meddelandetrådar och svar.
• Rollhantering för medlemmar.
• OData-frågestöd för filtrering och sidnumrering.