# PUT /messaging/v1/email/seed-lists/{id}

## Overview

Update a single seed list for an account. The MID and partner appId are used from authentication. The {id} in the URL path is the globally unique ID assigned by the system at creation.

A seed-list is retained for 60 days. To keep them active, update seed lists every 30 days, even when they're unchanged. Any seed-lists existing before this call are replaced by the ones provided in the JSON payload. An account can have 20 seed-lists, and each seed-list is allowed 500 `seeds`.

## JSON Parameters

| **Name**    | **Type**        |          |          | **Description**                                                   |
| ----------- | --------------- | -------- | -------- | ----------------------------------------------------------------- |
| name        | string          |          |          | The name given at creation or update.                             |
| description | string          |          |          | A description of the seed-list.                                   |
| seeds       | list of objects |          |          | The objects in the list each consist of a single name:value pair. |
|             |                 | **Name** | **Type** |                                                                   |
|             |                 | email    | string   | an email address.                                                 |

## Response

| **Status** | **Name**    | **Type**        |          |          | **Description**                                                                                      |
| ---------- | ----------- | --------------- | -------- | -------- | ---------------------------------------------------------------------------------------------------- |
| 200        |             |                 |          |          | Successful response indicating the request passed validations.                                       |
|            | name        | string          |          |          | The name given at creation or update.                                                                |
|            | description | string          |          |          | A description of the seed-list.                                                                      |
|            | seeds       | list of objects |          |          | The objects in the list each consist of a single name:value pair.                                    |
|            |             |                 | **Name** | **Type** |                                                                                                      |
|            |             |                 | email    | string   | an email address.                                                                                    |
| 200        |             |                 |          |          | Successful response but with an empty object, indicating no active seed-lists for the partner appID. |

### Validation Failure Scenarios

| **HTTP Status** | **Description**                                  |
| --------------- | ------------------------------------------------ |
| 401             | Seed-list doesn't belong to the partner ID.      |
| 429             | API rate limit throttling is preventing success. |

## Usage

### Example Request

```json
PUT /messaging/v1/email/seed-lists/{id}
{
   "name": "{seed-list-name}",
   "description": "some description",
   "seeds":[
       {"email": "address1@example.com"},
       {"email": "address2@example.com"},
       {"email": "address3@example.com"}
   ]
}
```

### Example Responses

```json
200 OK
{
    "id": "fb9a8b12-a088-4999-b9ce-f8cd3fe06386",
}
```

```json
200 OK
{}
```

## Related Items

- [Seed-List in Rest Reference](/docs/marketing/marketing-cloud/guide/routes.md#seed-list)
- [Seed-List Management API](/docs/marketing/marketing-cloud/references/mc_rest_seedlist/messageSeedListManagement.md)