---
title: "Update Key Value Pair"
url: https://docs.catalyst.zoho.com/en/api/code-reference/cloud-scale/cache/update-key-value/
description: "This API enables you to update a key-value pair in a cache segment."
last_updated: 2026-08-17T12:16:04Z
service: Cloud Scale
type: api
---

# Update a Key-Value Pair

### Description

This API enables you to update a key-value pair in a [cache segment](https://docs.catalyst.zoho.com/en/cloud-scale/help/cache/introduction/). The segment is referred by its unique ID. The key represents the attribute and the value is the data of the cache item.

You can update the key, value, or the time of expiry of the cache item. The default and maximum validity of a cache item is two days.

### Request Details

#### Request URL

`PUT` {api-domain}/baas/v1/project/{project_id}/segment/{segment_id}/cache

- **api-domain** (URL): The DC-specific domain to access Catalyst API

- **project_id** (Numerical): The [unique ID](https://docs.catalyst.zoho.com/en/getting-started/set-up-a-catalyst-project/general-settings/) of the project

- **segment_id** (Numerical): The [unique ID](https://docs.catalyst.zoho.com/en/cloud-scale/help/cache/implementation/#create-a-segment) of the cache segment 

#### Request Headers
 **Authorization:** Zoho-oauthtoken {oauth_token}

**Optional Headers** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### Scope

ZohoCatalyst.cache.CREATE

#### Request JSON Properties

- **cache_name** (string, mandatory):  Key name of the cache segment 
 Max Size: 50 characters   

- **cache_value** (string, mandatory):  Data value the key represents 
 Max Size: 16000 characters  

- **expiry_in_hours** (long, optional):  Duration of expiry in hours 
 Max Size: 48   

### Response Details

The response will return the details of the updated cache item such as the `cache_name`, `cache_value` and `expires_in`, along with the details of its segment.

**Sample Request**

```bash
curl -X PUT \
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/segment/3376000000425030/cache \
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \
-H "Content-Type:application/json" \
-d ‘{
"cache_name":"counter",
"cache_value":"1472"
      }’

```

**Sample Response**

```json

    {
    "status": "success",
    "data": {
        "cache_name": "counter",
        "cache_value": "1472",
        "project_details": {
            "id": 4000000006007,
            "project_name": "ShipmentTracking",
            "project_type": "Live"
        },
        "segment_details": {
            "id": 3376000000425030,
            "segment_name": "CounterValues"
        },
        "expires_in": "Mar 28, 2019 02:03 AM",
        "expiry_in_hours": 7,
        "ttl_in_milliseconds": 172800000
    }
}
```

### SDK Documentation

[Update Key-Value Pair- Java SDK](https://docs.catalyst.zoho.com/en/sdk/java/v1/cloud-scale/cache/update-data-in-cache)</br></br>
[Update Key-Value Pair- Node.js SDK](https://docs.catalyst.zoho.com/en/sdk/nodejs/v2/cloud-scale/cache/update-data-in-cache)</br></br>
[Update Key-Value Pair- Python SDK](https://docs.catalyst.zoho.com/en/sdk/python/v1/cloud-scale/cache/update-data-in-cache)</br></br>