Criar um novo item em uma lista

Artigo
04/08/2023

Criar um novo listItem em uma lista.

Permissões

Uma das permissões a seguir é necessária para chamar essa API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	Sites.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	Sites.ReadWrite.All

Solicitação HTTP

POST /sites/{site-id}/lists/{list-id}/items

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do recurso listItem a criar.

Exemplo

Aqui está um exemplo de como criar um novo item de lista genérica.

POST /sites/{site-id}/lists/{list-id}/items
Content-Type: application/json

{
  "fields": {
    "Title": "Widget",
    "Color": "Purple",
    "Weight": 32
  }
}

Resposta

Se for bem-sucedido, esse método retornará um listItem no corpo da resposta da lista criada.

HTTP/1.1 201 Created
Content-type: application/json

{
  "id": "20",
  "createdDateTime": "2016-08-30T08:26:00Z",
  "createdBy": {
    "user": {
      "displayName": "Ryan Gregg",
      "id": "8606e4d5-d582-4f5f-aeba-7d7c18b20cfd"
    }
  },
  "lastModifiedDateTime": "2016-08-30T08:26:00Z",
  "lastModifiedBy": {
    "user": {
      "displayName": "Ryan Gregg",
      "id": "8606e4d5-d582-4f5f-aeba-7d7c18b20cfd"
    }
  }
}

Observação: O objeto Response será truncado para mais clareza. As propriedades padrão serão retornadas da chamada real.

Compartilhar via