spacer
Skip to content

@pnp/graph/lists

More information can be found in the official Graph documentation:

IList, ILists, IListAddResult

Selective Imports Banner

Get Lists

import { graphfi } from "@pnp/graph";
import "@pnp/graph/lists";

const graph = graphfi(...);

const siteLists = await graph.site.getById("{site identifier}").lists();

Get List by Id

import { graphfi } from "@pnp/graph";
import "@pnp/graph/lists";

const graph = graphfi(...);

const listInfo = await graph.sites.getById("{site identifier}").lists.getById("{list identifier}")();

Add a List

import { graphfi } from "@pnp/graph";
import "@pnp/graph/lists";

const graph = graphfi(...);

const sampleList: List = {
    displayName: "PnPGraphTestList",
    list: { "template": "genericList" },
};

const list = await graph.sites.getById("{site identifier}").lists.add(listTemplate);

Update a List

import { graphfi } from "@pnp/graph";
import "@pnp/graph/lists";

const graph = graphfi(...);

const list = await graph.sites.getById("{site identifier}").lists.getById("{list identifier}").update({ displayName: "MyNewListName" });

Delete a List

import { graphfi } from "@pnp/graph";
import "@pnp/graph/lists";

const graph = graphfi(...);

await graph.sites.getById("{site identifier}").lists.getById("{list identifier}").delete();

Get List Columns

For more information about working please see documentation on columns

import { graphfi } from "@pnp/graph";
import "@pnp/graph/lists";
import "@pnp/graph/columns";

const graph = graphfi(...);

await graph.sites.getById("{site identifier}").lists.getById("{list identifier}").columns();

Get List Items

Currently, recieving list items via @pnpjs/graph API is not possible.

This can currently be done with a call by path as documented under @pnpjs/graph/items