---
search:
  tags:
    - Chat bot
    - PATCH
seo:
  description: >-
    Any subset of fields - {"enabled": false} benches a command without…
    Reference for the PATCH /commands/{commandName} endpoint in the TipPage
    Developer API.
sidebar:
  label: Update a command
  badge: PATCH
title: Update a command
type: openapi-operation
---
Any subset of fields - `{"enabled": false}` benches a command without deleting it, `name` renames it (the old name stops triggering immediately). Requires `commands:manage`.

`PATCH /commands/{commandName}`

**Request body** (`application/json`, required)

- `name` (string)
- `response` (string)
- `description` (string | null)
- `listed` (boolean)
- `ai_memory` (boolean)
- `ai_memory_shared` (boolean)
- `platforms` (string[]) — At least one.
- `permission` (string)
- `cooldown_seconds` (integer)
- `cooldown_type` (string)
- `aliases` (string[])
- `enabled` (boolean)

Request body example:

```json
{
  "name": "string",
  "response": "string",
  "description": "string",
  "listed": true,
  "ai_memory": true,
  "ai_memory_shared": true,
  "platforms": [
    "twitch"
  ],
  "permission": "everyone",
  "cooldown_seconds": 0,
  "cooldown_type": "global",
  "aliases": [
    "string"
  ],
  "enabled": true
}
```

**Responses**

- `200` — Updated.
- `400` — Invalid fields (\`invalid\_command\`).
- `401` — Missing or invalid credential (\`missing\_api\_key\` / \`invalid\_api\_key\`, or \`invalid\_token\` for an expired/revoked OAuth access token).
- `403` — The key lacks the required scope (\`missing\_scope\`).
- `404` — No such resource.
- `409` — The new name is already taken (\`command\_exists\`), or an alias collides with another trigger (\`alias\_in\_use\`).
- `429` — Rate limit exceeded - check the \`RateLimit-\*\` headers.

Response example, 200:

```json
{
  "command": {
    "name": "discord",
    "response": "string",
    "description": "string",
    "listed": true,
    "ai_memory": true,
    "ai_memory_shared": true,
    "platforms": [
      "twitch"
    ],
    "permission": "everyone",
    "cooldown_seconds": 0,
    "cooldown_type": "global",
    "aliases": [
      "string"
    ],
    "enabled": true,
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
}
```
