# removeReferencesFromList (https://developer.godaddy.com/en/docs/references/rest/catalog/reference/mutations/removeReferencesFromList)

***

title: removeReferencesFromList
description: "Remove references from an existing List."
full: true
----------

mutation

Requires `commerce.product:write`.

Remove references from an existing List.

## Required headers

| Header       | Required | Description                                                                                                                     |
| ------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `x-store-id` | Yes      | ID of the store the operation targets. Omitting it returns HTTP 200 with a GraphQL error: `extensions.code: "UNAUTHENTICATED"`. |

Go to [Authentication](https://developer.godaddy.com/docs/api-users/auth) for credential setup.

## Arguments

* `id` `String!` **required**
* `input` `MutationRemoveReferencesFromListInput!` **required**
  * `referenceIds` `[String!]!` **required**

## Possible returns

* `List` `List` — A list is a group of SKU groups that are generally organized by similar characteristics.

- `createdAt` `DateTime!` **non-null** — The date and time of when the List was created.
- `description` `String` **nullable** — A single-line textual description of the List.
- `htmlDescription` `String` **nullable** — HTML description for the List. Will be used to display rich text content to customers.
- `id` `ID!` **non-null** — The globally-unique ID of the List.
- `label` `String` **nullable** — The display label of the List.
- `mediaObjects` `ListMediaObjectsConnection` **nullable** — Media can be images, videos, or files
- `metafields` `ListMetafieldsConnection` **nullable**
- `name` `String!` **non-null** — A unique name for the List.
- `references` `ListReferencesConnection` **nullable** — A reference to the resource in an external service. This can be useful for integrating the resource to any external service.
- `skuGroups` `ListSkuGroupsConnection` **nullable** — A SKU Group is a grouping of related SKUs. It provides information about all of the SKUs that are sold together on storefronts or devices.
- `status` `String` **nullable** — The status of the list, one of `ACTIVE`, `DRAFT`, `ARCHIVED`.
- `updatedAt` `DateTime!` **non-null** — The date and time of when the List was updated.
- `HTMLDescription` `String` **nullable** deprecated — HTML description for the List. Will be used to display rich text content to customers. Deprecated: Use htmlDescription instead.
- `SKUGroups` `ListSKUGroupsConnection` **nullable** deprecated — A SKU Group is a grouping of related SKUs. It provides information about all of the SKUs that are sold together on storefronts or devices. Deprecated: Use skuGroups instead.