teamworkSectionItem: mover

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Mover um item de uma seção definida pelo usuário para outra seção definida pelo usuário no trabalho em equipe de um usuário. Cada item pode pertencer a apenas uma seção por vez. Essa ação remove o item de sua seção atual e o adiciona à seção de destino. Use essa ação em vez de adicionar quando o item já estiver em uma seção definida pelo usuário.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) TeamworkSection.ReadWrite Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application TeamworkSection.ReadWrite.All Teamwork.Migrate.All

Solicitação HTTP

POST /users/{user-id}/teamwork/sections/{teamworkSection-id}/items/{teamworkSectionItem-id}/move

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.
If-Match O valor da anotação @microsoft.graph.sectionsVersion retornado quando você lista seções ou o valor @odata.etag de qualquer seção recuperada anteriormente. Necessário para controle de simultaneidade otimista.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON dos parâmetros.

A tabela a seguir lista os parâmetros necessários quando você chama essa ação.

Parâmetro Tipo Descrição
targetSectionId Cadeia de caracteres A ID da seção para a qual mover o item. Obrigatório.

Resposta

Se for bem-sucedida, essa ação retornará um código de 200 OK resposta e um teamworkSectionItem no corpo da resposta que representa o item na seção de destino.

Observação

A resposta inclui um valor @odata.etag atualizado. Use esse valor como o If-Match cabeçalho para todas as operações de mutação subsequentes.

Os erros a seguir são possíveis.

Código da resposta Mensagem
400 Bad Request A propriedade 'targetSectionId' é obrigatória e não deve estar vazia.
400 Bad Request As seções de origem e destino devem ser diferentes.
403 Forbidden Esta seção é gerada pelo sistema e não pode ser modificada. Os itens não podem ser movidos para dentro ou para fora das seções definidas pelo sistema usando esta ação.
404 Not Found A seção especificada não foi encontrada ou o item especificado não foi encontrado nesta seção.
412 Precondition Failed O If-Match valor do cabeçalho não corresponde à versão atual da hierarquia de seção. Liste as seções novamente para recuperar a anotação atual @microsoft.graph.sectionsVersion e tente novamente.
428 Precondition Required O If-Match cabeçalho é necessário para esta operação.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação para mover um chat da seção "Favoritos" para a seção "Projeto Alpha".

POST https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items/19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2/move
Content-type: application/json
If-Match: "1742515200"

{
  "targetSectionId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.type": "#microsoft.graph.teamworkSectionItem",
  "@odata.etag": "\"1742515210\"",
  "id": "19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2",
  "itemType": "chat",
  "createdDateTime": "2026-03-08T10:30:00Z",
  "lastModifiedDateTime": null
}