> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# /users/xuid(xuid)/lists/PINS/{listname}

> /users/xuid(xuid)/lists/PINS/{listname}

Accesses items in a list.
The domain for these URIs is `eplists.xboxlive.com`.

* [URI parameters](#ID4EV)

## URI parameters

| Parameter | Type | Description |
| - | - | - |
| xuid | string | XBOX User ID (XUID). |
| listtype | string | Type of the list (how it is used and how it acts). Always "PINS" for these related methods. |
| listname | string | Name of the list (which list of a given listtype to act on). Always "XBLPins" for items in Pins. |

## Valid methods

[DELETE](https://docs.xbox.com/reference/live/rest/uri/lists/uri-usersxuidlistspinslistnamedelete.md)

  Removes items from a list.

[GET](https://docs.xbox.com/reference/live/rest/uri/lists/uri-usersxuidlistspinslistnameget.md)

  Returns the contents of a list.

[POST](https://docs.xbox.com/reference/live/rest/uri/lists/uri-usersxuidlistspinslistnamepost.md)

  Inserts items into the list at the index based on the query string parameter **insertIndex**.

[PUT](https://docs.xbox.com/reference/live/rest/uri/lists/uri-usersxuidlistspinslistnameput.md)

  Updates the items in a list according to the indexes specified for each item in the request body.

## See also

##### Parent

[Universal Resource Identifier (URI) Reference](https://docs.xbox.com/reference/live/rest/uri/atoc-xboxlivews-reference-uris.md)


## Related topics

- [DELETE (/users/xuid(xuid)/lists/PINS/{listname})](https://docs.xbox.com/reference/live/rest/uri/lists/uri-usersxuidlistspinslistnamedelete.md)
- [GET (/users/xuid(xuid)/lists/PINS/{listname})](https://docs.xbox.com/reference/live/rest/uri/lists/uri-usersxuidlistspinslistnameget.md)
- [POST (/users/xuid(xuid)/lists/PINS/{listname})](https://docs.xbox.com/reference/live/rest/uri/lists/uri-usersxuidlistspinslistnamepost.md)
- [PUT (/users/xuid(xuid)/lists/PINS/{listname})](https://docs.xbox.com/reference/live/rest/uri/lists/uri-usersxuidlistspinslistnameput.md)
- [/users/xuid(xuid)/lists/PINS/{listname}/ContainsItems](https://docs.xbox.com/reference/live/rest/uri/lists/uri-usersxuidlistspinslistnamecontainsitems.md)