API v2 · Members

Change a member's quota points

POST/v2/members/{userId}/quota-points

Last updated 1 October 2026

Overview

increment/decrement are clamped to Quota.AwardLimits.API. Quota points never go below zero.

Permission scope: members.quota.write
Community feature: quota
Content type: application/json

Authentication

Send Authorization: Bearer YOUR_API_KEY and X-Clan-Id: COMMUNITY_ID. The community API switch and key must be enabled. The key must have the scope shown above. See authentication and key storage.

Parameters

Name	Location	Type	Required	Constraints and description
`by`	query	`userId \| username`	No	How to interpret the identifier in the path. Prefer `username`: under Roblox's scoped user identifiers an in-experience user id is not a global one.
`userId`	path	`string`	Yes	Roblox user id, or a username when `?by=username` is set.

Request body

A JSON request body is required.

Field	Type	Required	Constraints and description
`op`	`increment \| decrement \| set`	Yes	`increment` and `decrement` are clamped to the community's per-call API award limit; `set` is not.
`amount`	`integer`	Yes	min 0, max 9007199254740991
`reason`	`string`	No	min length 1, max length 256

Error responses

Status	When it is returned
400	The request was malformed or failed validation.
401	The API key is missing, malformed, or not recognised for this community.
403	The key is disabled, lacks the required permission, or the community's subscription or tier does not cover API access or this feature.
404	The requested resource does not exist.
409	The request conflicts with current state.
429	Rate limited.
500	Unexpected server error.

Server-side examples

After HTTP requests are enabled, Roblox Lua uses HttpService:GetSecret() from a server Script, never a LocalScript.

Request

POST

curl --request POST \
  --url 'https://api.clanlabs.co/v2/members/1234567/quota-points?by=userId' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'X-Clan-Id: COMMUNITY_ID' \
  --header 'Content-Type: application/json' \
  --data '{
  "op": "increment",
  "amount": 10
}'

Response

200

The member

{
  "data": {
    "userId": 1234567,
    "username": "PixelComet482",
    "experience": 250,
    "quotaPoints": 3,
    "medals": [
      "Long Service"
    ],
    "qualifications": [
      "Marksman"
    ],
    "currentRank": {
      "uniqueId": 900001,
      "id": 10,
      "name": "Private",
      "experience": 200,
      "locked": false
    },
    "nextRank": {
      "uniqueId": 900001,
      "id": 10,
      "name": "Private",
      "experience": 200,
      "locked": false
    },
    "perks": {
      "boosting": true,
      "primary": true
    },
    "createdAt": 1735689600000,
    "lastUpdatedAt": 1735689600000
  }
}

Change a member's quota points | Clan Labs API

OverviewCopy link to overview

AuthenticationCopy link to authentication

ParametersCopy link to parameters

Request bodyCopy link to request body

Error responsesCopy link to error responses

Rate limitsCopy link to rate limits

Related endpointsCopy link to related endpoints

Response

Overview

Authentication

Parameters

Request body

Error responses

Rate limits

Related endpoints