Teams-referanse (forhåndsvisning)

Oversikt

Chatverktøy

mcp_graph_chat_addChatMember

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

Legger til et medlem i en chat ved hjelp user@odata.bindav , @odata.typeog valgfrie roller (medlem, eier). Returnerer en 409-feilkode hvis medlemmet allerede finnes, en 400-feilkode for ugyldige brukerreferanser eller en 403-feilkode hvis policyer begrenser tillegging.

Nødvendige parametere: chat-id, @odata.type, user@odata.bind, roller

mcp_graph_chat_createChat

Endepunkt:POST /v1.0/chats

Oppretter en ny Teams-chat med chatType (oneOnOne krever nøyaktig to deltakere, gruppe krever mer enn to) og medlemmer. Returnerer en 400 hvis oneOnOne har feil medlemsantall, 409 hvis de samme deltakerne allerede har en chat, eller 403 hvis innringeren mangler rettigheter.

Nødvendige parametere:chatType, medlemmer

mcp_graph_chat_deleteChat

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

Myk sletter en chat. Returnerer en 403 hvis tillatelse mangler eller en 404 hvis den allerede er slettet. Policyer for leieroppbevaring styrer denne operasjonen.

Nødvendige parametere: chat-id

mcp_graph_chat_deleteChatMessage

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

Midlertidig sletter en chatmelding. Returnerer en 403 uten Chat.ReadWrite, en 404 for ugyldige IDer, og kan fortsatt beholde meldingen for samsvar.

Nødvendige parametere: bruker-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

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

Henter en chat etter ID. Returnerer metadata som type og emne. Returnerer en 404 hvis chatten ikke finnes eller ikke er synlig, eller en 403 hvis tillatelser nektes.

Nødvendige parametere: chat-id

mcp_graph_chat_getChatMessage

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

Henter en chatmelding med ID. Returnerer en 404 hvis meldingen ikke finnes eller er skjult, eller en 403 uten riktige rettigheter.

Nødvendige parametere: chat-id, message-id

mcp_graf_chat_listChatMedlemmer

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

Viser chatdeltakere. Returnerer roller (medlem, eier eller gjest). Returnerer en 403 uten lesetillatelser eller en 404 hvis chat ikke ble funnet.

Nødvendige parametere: chat-id

mcp_graph_chat_listChatMessages

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

Viser meldinger i en chat med valgfritt $top, $filterog $orderby. Returnerer sidedelte resultater. Samsvar kan skjule innhold. Feil omfatter 400 for ugyldige spørringer og 429 for struping.

Nødvendige parametere: chat-id

Valgfrie parametere:$top, $filter, $orderby

mcp_graph_chat_listSamtaler

Endepunkt:GET /v1.0/chats

Viser chatter for innringeren med valgfri $top, $filter, $expandog $orderby. Returnerer bare synlige chatter. skjulte chatter eller systemchatter kan utelates. Returnerer 400 for ugyldige sorteringsuttrykk.

Valgfrie parametere:$top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

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

Legger inn en ny melding i ren tekst i en chat. Krever chat-id og ikke-tom body.content; kun tekst støttes. Kan returnere en 429 for begrensning, en 403 hvis tillatelser mangler, eller en 404 hvis chat er ugyldig. Ikke idempotent—avoid blinde forsøk på nytt.

Nødvendige parametere: chat-id, body

mcp_graph_chat_updateChat

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

Oppdaterer chategenskaper, for eksempel emnet bare for gruppechatter. Mislykkes med 400 hvis det brukes i en en-til-en-chat, 403 uten rettigheter eller 404 hvis chat ikke blir funnet.

Påkrevde parametere: chat-id, emne

mcp_graph_chat_updateChatMessage

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

Oppdaterer en chatmelding med nytt innhold i ren tekst. Enkelte system- eller samsvarsmeldinger blokkerer redigering. Operasjonen returnerer en 403 eller 400 hvis redigering ikke er tillatt, eller en 409 for konflikter.

Nødvendige parametere: chat-id, message-id

Kanal- og teamverktøy

mcp_graph_teams_addChannelMember

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

Legger til et medlem i en privat eller delt kanal ved hjelp user@odata.bindav , @odata.typeog valgfrie roller (eier eller tom). Mislykkes på standardkanaler. Returnerer en 409 hvis medlemmet allerede finnes, og en 403 hvis mangler tillatelser.

Nødvendige parametere: team-id, channel-id, displayName, roller, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

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

Oppretter en kanal i et team med displayName, valgfri beskrivelse membershipType ( standard, privat, delt) og valgfrie medlemmer. Private eller delte kanaler krever eksplisitte medlemmer. Duplikater eller ugyldig medlemskap forårsaker 400 eller 409.

Nødvendige parametere: team-id, displayName

Valgfrie parametere: beskrivelse, membershipType, medlemmer

mcp_graph_teams_createPrivateChannel

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

Oppretter en privat kanal ved å angi membershipType til private. Du må inkludere medlemmer når du oppretter kanalen, og medlemslisten må ha minst én eier. Returnerer en 400 hvis medlemmene mangler, en 409 for dupliserte navn, eller en 403 hvis innringeren ikke har tillatelser.

Nødvendige parametere: team-id, displayName, medlemmer

mcp_graph_teams_getChannel

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

Henter en kanal med valgfritt $select og $filter. Returnerer en 404 hvis kanalen ikke blir funnet eller innringeren mangler tilgang, en 403 hvis tillatelser er utilstrekkelige, eller en 400 for filtre som ikke støttes.

Nødvendige parametere: team-id, channel-id

Valgfrie parametere:$select$filter

mcp_graph_teams_getTeam

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

Henter gruppeegenskaper med valgfritt $select og $expand. Returnerer en 403 eller 404 hvis teamet er utilgjengelig.

Nødvendige parametere: team-id

Valgfrie parametere:$select$expand

mcp_graph_teams_listChannelMembers

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

Viser alle medlemmer av en bestemt Microsoft Teams kanal. Returnerer metadata om hvert medlem, for eksempel identitet, roller og medlemskapsstatus. Denne informasjonen er nyttig for å overvåke kanaldeltakelse, bekrefte medlemskap før rolleoppdateringer eller sikre samsvar.

Nødvendige parametere: team-id, channel-id

Valgfrie parametere:$top$expand

mcp_graph_teams_listChannelMessages

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

Viser meldinger i en kanal. Bruk valgfrie $top parametere og $expand parametere til å tilpasse resultatene. Bruk $expand for eksempel til å inkludere svar. Paginering håndteres gjennom @odata.nextLink. Returnerer en 403 uten lesetillatelse eller 400 for ugyldige spørringsalternativer.

Nødvendige parametere: team-id, channel-id

Valgfrie parametere:$top$expand

mcp_graph_teams_listChannels

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

Viser kanaler i et team. Bruk valgfrie $select parametere eller $filter parametere til å tilpasse resultatene. Returnerer bare private og delte kanaler hvis innringeren er medlem. Mislykkes med en 403 hvis innringeren mangler leserettigheter eller 400 på ugyldige OData-spørringer.

Nødvendige parametere: team-id

Valgfrie parametere:$select, $filter

mcp_graph_teams_listTeams

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

Viser de sammenføyde teamene til en bestemt bruker. Returnerer bare medlemskap for denne brukeren, ikke alle leierteam. Returnerer en 403 hvis innringeren ikke kan spørre brukeren eller en 404 hvis ID-en er ugyldig.

Nødvendige parametere: bruker-ID

mcp_graph_teams_postChannelMessage

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

Legger inn en melding i ren tekst i en kanal. Krever team-ID, kanal-ID og body.content. Returnerer en 403 uten ChannelMessage.Send, en 404 hvis kanalen ikke ble funnet, eller en 400 hvis innholdet mangler.

Nødvendige parametere: team-id, channel-id, body

mcp_graph_teams_replyToChannelMessage

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

Svarer på en melding i en kanal ved hjelp av body.content. Bare ren tekst støttes. Returnerer en 404 hvis den overordnede meldingen ikke blir funnet, en 403 uten rettigheter, eller en 400 for ugyldig innhold.

Nødvendige parametere: team-id, channel-id, message-id, body

mcp_graph_teams_updateChannel

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

Oppdaterer en kanal med en ny displayName eller beskrivelse. Begrensninger kan gjelde for spesielle kanaler som Generelt. Returnerer en 403 uten rettigheter, en 409 på dupliserte navn, eller en 400 for ugyldige inndata.

Nødvendige parametere: team-id, channel-id

Valgfrie parametere: displayName, beskrivelse

mcp_graph_teams_updateChannelMember

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

Oppdaterer et medlems rolle i en privat eller delt kanal ved å endre roller. Standardkanaler arver roller fra teamet og avviser vanligvis oppdateringer. Returnerer en 400 hvis forsøkt på standardkanaler, en 403 hvis uautorisert, eller en 404 hvis medlemmet ikke finner.

Nødvendige parametere: team-id, channel-id, membership-id, roller

Støttede operasjoner

• Chatbehandling (opprette, lese, oppdatere, slette)
• Meldingsoperasjoner (send, hent, rediger, slett)
• Kanalbehandling (opprett, konfigurer, liste)
• Medlemsadministrasjon (legg til, oppdater, liste)
• Gruppeoperasjoner (hente, liste)

Viktige funksjoner

• Fullstendige operasjoner for oppretting, lesing, oppdatering og sletting (CRUD) for chatter og kanaler.
• Støtte for private, delte og standardkanaler.
• Meldingstråder og svar.
• Administrasjon av medlemsroller.
• OData-spørringsstøtte for filtrering og paginering.