# Patch a value list item

**PATCH /api/lists/items**

**Spaces method and path for this operation:**

<div><span class="operation-verb patch">patch</span>&nbsp;<span class="operation-path">/s/{space_id}/api/lists/items</span></div>

Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.

Update specific fields of an existing value list item using the item `id`.


## Servers
- https://localhost:5601: https://localhost:5601 ()


## Authentication methods
- Api key auth
- Basic auth


## Parameters



### Body: application/json (object)
Value list item's properties
- **_version** (string)
  The version id, normally returned by the API when the document is retrieved. Use it ensure updates are done against the latest version.
- **id** (string(nonempty))
  Value list item's identifier.
- **meta** (object)
  Placeholder for metadata about the value list item.
- **refresh** (string)
  Determines when changes made by the request are made visible to search.
- **value** (string(nonempty))
  The value used to evaluate exceptions.


## Responses
### 200
Successful response

#### Body: application/json (object)
- **_version** (string)
  The version id, normally returned by the API when the document is retrieved. Use it ensure updates are done against the latest version.
- **@timestamp** (string(date-time))

- **created_at** (string(date-time))
  Autogenerated date of object creation.
- **created_by** (string)
  Autogenerated value - user that created object.
- **id** (string(nonempty))
  Value list item's identifier.
- **list_id** (string(nonempty))
  Value list's identifier.
- **meta** (object)
  Placeholder for metadata about the value list item.
- **tie_breaker_id** (string)
  Field used in search to ensure all containers are sorted and returned correctly.
- **type** (string)
  Specifies the Elasticsearch data type of excludes the list container holds. Some common examples:

  - `keyword`: Many ECS fields are Elasticsearch keywords
  - `ip`: IP addresses
  - `ip_range`: Range of IP addresses (supports IPv4, IPv6, and CIDR notation)
- **updated_at** (string(date-time))
  Autogenerated date of last object update.
- **updated_by** (string)
  Autogenerated value - user that last updated object.
- **value** (string(nonempty))
  The value used to evaluate exceptions.

### 400
Invalid input data response

#### Body: application/json (object)
- **error** (string)

- **message** (string)

- **statusCode** (integer)


### 401
Unsuccessful authentication response

#### Body: application/json (object)
- **error** (string)

- **message** (string)

- **statusCode** (integer)


### 403
Not enough privileges response

#### Body: application/json (object)
- **error** (string)

- **message** (string)

- **statusCode** (integer)


### 404
List item not found response

#### Body: application/json (object)
- **message** (string)

- **status_code** (integer)


### 500
Internal server error response

#### Body: application/json (object)
- **message** (string)

- **status_code** (integer)



[Powered by Bump.sh](https://bump.sh)