Microsoft SharePoint

Manage SharePoint lists and files through Microsoft Graph, including uploads and list automation.

Add a new item to a SharePoint list.

Parameters

Parameter	Type	Required	Description
`site_id`	string	Yes	The SharePoint site hostname (e.g., 'contoso.sharepoint.com').
`list_id`	string	Yes	The SharePoint list ID.
`fields`	object	Yes	Object containing field values for the new item. A default generic list only has a 'Title' column; custom columns must be added to the list before they can be used.

Response

{
  "fields": {},
  "id": "item123"
}

Create a new SharePoint list in a site.

Parameters

Parameter	Type	Required	Description
`site_id`	string	Yes	The SharePoint site hostname (e.g., 'contoso.sharepoint.com').
`list_name`	string	Yes	Name for the list.
`description`	string	No	Optional list description.
`template`	string	No	Optional list template (genericList, documentLibrary, etc.).

Response

{
  "displayName": "New List",
  "id": "list123"
}

Delete an item from a SharePoint list.

Parameters

Parameter	Type	Required	Description
`site_id`	string	Yes	The SharePoint site hostname (e.g., 'contoso.sharepoint.com').
`list_id`	string	Yes	The SharePoint list ID.
`item_id`	string	Yes	The item ID to delete.

Response

{
  "deleted": true
}

Get items from a SharePoint list.

Parameters

Parameter	Type	Required	Description
`site_id`	string	Yes	The SharePoint site hostname (e.g., 'contoso.sharepoint.com').
`list_id`	string	Yes	The SharePoint list ID.
`top`	number	No	Optional limit for the number of items to return.
`filter_query`	string	No	Optional OData $filter expression.

Response

{
  "value": [
    {
      "id": "item1"
    }
  ]
}

Update an existing item in a SharePoint list.

Parameters

Parameter	Type	Required	Description
`site_id`	string	Yes	The SharePoint site hostname (e.g., 'contoso.sharepoint.com').
`list_id`	string	Yes	The SharePoint list ID.
`item_id`	string	Yes	The item ID to update.
`fields`	object	Yes	Object containing field values to update. A default generic list only has a 'Title' column; custom columns must exist on the list.

Response

{
  "fields": {},
  "id": "item123"
}

Upload a file to a SharePoint document library.

Parameters

Parameter	Type	Required	Description
`site_id`	string	Yes	The SharePoint site hostname (e.g., 'contoso.sharepoint.com').
`file_path`	string	Yes	Uploaded file reference for the file to upload.
`folder_path`	string	No	Optional folder path inside the site drive.
`conflict_behavior`	string	No	How to handle filename conflicts (rename, replace, or fail).

Response

{
  "id": "file123",
  "name": "file.txt",
  "webUrl": "https://..."
}