> ## Documentation index
> Fetch the complete documentation index at: https://upstash.com/docs/llms.txt
> Ask it with GET https://upstash.com/docs/ask?q=<keywords or question>. Short keywords rank best.
> Use these to discover all available pages before exploring further.
> Feature requests: https://upstash.com/docs/common/help/feature-requests.md lists what users asked for and how to vote for a request or add one.
> Page rating: `GET https://upstash.com/docs/feedback?path=/docs/redis/sdks/ts/commands/string/incrby&helpful=true` (or `false`) records whether this page helped. An optional `comment` (URL-encoded, at most 500 characters) says what was missing or wrong. It is anonymous and needs no key. Comments hold no code, secrets or personal data.

# INCRBY

> Increment the integer value of a key by a given number.

If a key does not exist, it is initialized as 0 before performing the operation. An error is returned if the key contains a value of the wrong type or contains a string that can not be represented as integer.

## Arguments

<ParamField body="key" type="string"required>
The key to decrement.
</ParamField>
<ParamField body="incrementBy" type="integer" required>
The amount to increment by.
</ParamField>

## Response

<ResponseField  type="integer" required>
The value at the key after the incrementing.
</ResponseField>

<RequestExample>
```ts Example
await redis.set("key", 6);
await redis.incrby("key", 4);
// returns 10
```
</RequestExample>