Loading...

Update a Key-Value Pair

Description

This API enables you to update a key-value pair in a cache segment. 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

copy

api-domain
URL
The DC-specific domain to access Catalyst API

project_id
Numerical
The unique ID of the project

segment_id
Numerical
The unique ID 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
copy

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
copy
{
"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
}

}