doc: Add doc for v2 lists

Author: alkihis

doc/v2.md

@@ -47,6 +47,16 @@ For streaming API, see [Streaming part](./streaming.md).
 	* [Mute someone](#Mutesomeone)
 	* [Unmute someone](#Unmutesomeone)
 	* [Get users that are muted by you](#Getusersthataremutedbyyou)
+* [Lists](#Lists)
+	* [Create a list](#Createalist)
+	* [Update list metadata](#Updatelistmetadata)
+	* [Delete list](#Deletelist)
+	* [Add list member](#Addlistmember)
+	* [Remove list member](#Removelistmember)
+	* [Subscribe to a list](#Subscribetoalist)
+	* [Unsubscribe of a list](#Unsubscribeofalist)
+	* [Pin a list](#Pinalist)
+	* [Unpin a list](#Unpinalist)
 * [Spaces](#Spaces)
 	* [Space by ID](#SpacebyID)
 	* [Spaces by ID](#SpacesbyID)
@@ -703,6 +713,177 @@ for await (const mutedUser of mutedPaginator) {
 }
 ```
 
+## <a name='Lists'></a>Lists
+
+### <a name='Createalist'></a>Create a list
+
+**Method**: `.createList()`
+
+**Endpoint**: `lists`
+
+**Right level**: `Read-write`
+
+**Arguments**:
+  - `options: ListCreateV2Params`
+
+**Returns**: `ListCreateV2Result`
+
+**Example**
+```ts
+const myNewList = await client.v2.createList({ name: 'cats', private: true });
+```
+
+### <a name='Updatelistmetadata'></a>Update list metadata
+
+**Method**: `.updateList()`
+
+**Endpoint**: `lists/:id`
+
+**Right level**: `Read-write`
+
+**Arguments**:
+  - `listId: string`
+  - `options: ListUpdateV2Params`
+
+**Returns**: `ListUpdateV2Result`
+
+**Example**
+```ts
+const updatedList = await client.v2.updateList('128492', { private: true });
+```
+
+### <a name='Deletelist'></a>Delete list
+
+**Method**: `.removeList()`
+
+**Endpoint**: `lists/:id`
+
+**Right level**: `Read-write`
+
+**Arguments**:
+  - `listId: string`
+
+**Returns**: `ListDeleteV2Result`
+
+**Example**
+```ts
+await client.v2.removeList('128492');
+```
+
+### <a name='Addlistmember'></a>Add list member
+
+**Method**: `.addListMember()`
+
+**Endpoint**: `users/:id/members`
+
+**Right level**: `Read-write`
+
+**Arguments**:
+  - `listId: string`
+  - `userId: string`
+
+**Returns**: `ListMemberV2Result`
+
+**Example**
+```ts
+await client.v2.addListMember('12', '128492');
+```
+
+### <a name='Removelistmember'></a>Remove list member
+
+**Method**: `.removeListMember()`
+
+**Endpoint**: `users/:id/members/:list_id`
+
+**Right level**: `Read-write`
+
+**Arguments**:
+  - `listId: string`
+  - `userId: string`
+
+**Returns**: `ListMemberV2Result`
+
+**Example**
+```ts
+await client.v2.removeListMember('128492', '12');
+```
+
+### <a name='Subscribetoalist'></a>Subscribe to a list
+
+**Method**: `.subscribeToList()`
+
+**Endpoint**: `users/:id/followed_lists`
+
+**Right level**: `Read-write`
+
+**Arguments**:
+  - `loggedUserId: string`
+  - `listId: string`
+
+**Returns**: `ListFollowV2Result`
+
+**Example**
+```ts
+await client.v2.subscribeToList('12', '128492');
+```
+
+### <a name='Unsubscribeofalist'></a>Unsubscribe of a list
+
+**Method**: `.unsubscribeOfList()`
+
+**Endpoint**: `users/:id/followed_lists/:list_id`
+
+**Right level**: `Read-write`
+
+**Arguments**:
+  - `loggedUserId: string`
+  - `listId: string`
+
+**Returns**: `ListFollowV2Result`
+
+**Example**
+```ts
+await client.v2.unsubscribeOfList('12', '128492');
+```
+
+### <a name='Pinalist'></a>Pin a list
+
+**Method**: `.pinList()`
+
+**Endpoint**: `users/:id/pinned_lists`
+
+**Right level**: `Read-write`
+
+**Arguments**:
+  - `loggedUserId: string`
+  - `listId: string`
+
+**Returns**: `ListPinV2Result`
+
+**Example**
+```ts
+await client.v2.pinList('12', '128492');
+```
+
+### <a name='Unpinalist'></a>Unpin a list
+
+**Method**: `.unpinList()`
+
+**Endpoint**: `users/:id/pinned_lists/:list_id`
+
+**Right level**: `Read-write`
+
+**Arguments**:
+  - `loggedUserId: string`
+  - `listId: string`
+
+**Returns**: `ListPinV2Result`
+
+**Example**
+```ts
+await client.v2.unpinList('12', '128492');
+```
+
 ## <a name='Spaces'></a>Spaces
 
 ### <a name='SpacebyID'></a>Space by ID

src/types/v2/list.v2.types.ts

@@ -1,4 +1,4 @@
-import { DataV2 } from "./shared.v2.types";
+import { DataV2 } from './shared.v2.types';
 
 export interface ListCreateV2Params {
   name: string;