---
source_url: https://www.pubnub.com/docs/admin-api/increment-a-counter
title: Increment a counter
---

# Increment a counter

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

Increments a counter by the specified value (default 1). **Permissions:** `keyset:write` on `keyset`

## Request

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"
    }
  ]
}
```