---
updatedAt: 2025-06-05T20:02:08.000Z
agentTools:
  projectIndex: https://dev.streamlabs.com/llms.txt
---

# /points/subtract

Subtract user's loyalty points

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "donations",
    "version": "2.0"
  },
  "servers": [
    {
      "url": "https://streamlabs.com/api/v2.0"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "x-default": "<access_token>",
        "x-bearer-format": "bearer"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/points/subtract": {
      "post": {
        "summary": "/points/subtract",
        "description": "Subtract user's loyalty points",
        "operationId": "pointssubtract",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "username",
                  "channel",
                  "points"
                ],
                "properties": {
                  "username": {
                    "type": "string",
                    "description": "username of the user"
                  },
                  "channel": {
                    "type": "string",
                    "description": "channel name e.g. iddqd"
                  },
                  "points": {
                    "type": "integer",
                    "description": "the points you want to subtract from the user",
                    "format": "int32"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n\t\"id\":1,\n\t\"platform\":\"twitch\",\n\t\"channel\":\"sunnyding602\",\n\t\"username\":\"sunnyding602\",\n\t\"exp\":0,\n\t\"points\":470,\n\t\"ta_id\":null,\n\t\"status\":\"vip\",\n\t\"time_watched\":0,\n\t\"created_at\":null,\n\t\"updated_at\":\"2017-09-20 20:16:26\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "integer",
                      "example": 1,
                      "default": 0
                    },
                    "platform": {
                      "type": "string",
                      "example": "twitch"
                    },
                    "channel": {
                      "type": "string",
                      "example": "sunnyding602"
                    },
                    "username": {
                      "type": "string",
                      "example": "sunnyding602"
                    },
                    "exp": {
                      "type": "integer",
                      "example": 0,
                      "default": 0
                    },
                    "points": {
                      "type": "integer",
                      "example": 470,
                      "default": 0
                    },
                    "ta_id": {},
                    "status": {
                      "type": "string",
                      "example": "vip"
                    },
                    "time_watched": {
                      "type": "integer",
                      "example": 0,
                      "default": 0
                    },
                    "created_at": {},
                    "updated_at": {
                      "type": "string",
                      "example": "2017-09-20 20:16:26"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\"message\":\"User does not have enough points\"}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "User does not have enough points"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "404",
            "content": {
              "text/plain": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"error\":true,\n  \"message\":\"User not found\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "boolean",
                      "example": true,
                      "default": true
                    },
                    "message": {
                      "type": "string",
                      "example": "User not found"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false,
        "x-readme": {
          "code-samples": [
            {
              "language": "curl",
              "code": "curl --request POST \\\n     --url https://streamlabs.com/api/v2.0/points/subtract \\\n     -d 'username=sunnyding602&channel=sunnyding602&points=10'"
            }
          ],
          "samples-languages": [
            "curl"
          ]
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": false
  },
  "x-readme-fauxas": true
}
```