---
source_url: https://www.pubnub.com/docs/admin-api/create-or-update-a-string-entry
title: Create or update a string entry
---

# Create or update a string entry

> For AI agents: documentation index at https://www.pubnub.com/llms-full.txt

Inserts or updates a string key-value entry with an optional TTL. **Permissions:** `keyset:write` on `keyset`

## Request

Example

```
{
  "data": {
    "key": "user:preferences:12345",
    "value": "dark-mode",
    "ttlSeconds": 3600
  },
  "meta": {
    "timestamp": "2026-03-10T12:00:00.000Z",
    "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "errors": []
}
```

Example

```
{
  "meta": {
    "timestamp": "2026-03-10T12:00:00.000Z",
    "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "errors": [
    {
      "code": "FAAS-404",
      "message": "Entity not found"
    }
  ]
}
```

Example

```
{
  "meta": {
    "timestamp": "2026-03-10T12:00:00.000Z",
    "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "errors": [
    {
      "code": "FAAS-404",
      "message": "Entity not found"
    }
  ]
}
```

Example

```
{
  "meta": {
    "timestamp": "2026-03-10T12:00:00.000Z",
    "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "errors": [
    {
      "code": "FAAS-404",
      "message": "Entity not found"
    }
  ]
}
```

Example

```
{
  "meta": {
    "timestamp": "2026-03-10T12:00:00.000Z",
    "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "errors": [
    {
      "code": "FAAS-404",
      "message": "Entity not found"
    }
  ]
}
```

Example

```
{
  "meta": {
    "timestamp": "2026-03-10T12:00:00.000Z",
    "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "errors": [
    {
      "code": "FAAS-404",
      "message": "Entity not found"
    }
  ]
}
```