# Update Member Record Points

<mark style="color:green;">`PATCH`</mark> `https://api.sonorancms.com/v2/community/disciplinary/records/11111111-1111-1111-1111-111111111111/points`

> **Rate limit:** `18 requests per minute`\
> Authenticated v2 endpoints are rate limited per credential rather than per IP address.

Update the points on a disciplinary record.

## Route Parameters

| Name       | Type          | Required | Description      |
| ---------- | ------------- | -------- | ---------------- |
| `recordId` | string (uuid) | Yes      | Target recordId. |

## Request Body

| Name     | Type   | Required | Description                        |
| -------- | ------ | -------- | ---------------------------------- |
| `points` | number | Yes      | See example request for the shape. |

## Example Request

{% tabs %}
{% tab title="OpenAPI" %}

```yaml
openapi: "3.0.3"
info:
  title: "Sonoran CMS v2 - Update Member Record Points"
  version: "1.0.0"
  description: "Update the points on a disciplinary record."
servers:
  -
    url: "https://api.sonorancms.com"
paths:
  /v2/community/disciplinary/records/{recordId}/points:
    patch:
      summary: "Update Member Record Points"
      operationId: "updateMemberRecordPoints"
      parameters:
        -
          description: "Target disciplinary record id."
          name: "recordId"
          in: "path"
          schema:
            type: "string"
            format: "uuid"
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: "object"
      security:
        -
          bearerAuth: []
      responses:
        "200":
          description: "Successful response"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                data:
                  -
                    id: "55555555-5555-5555-5555-555555555555"
                    status: true
                    accId: "00000000-0000-0000-0000-000000000000"
                    source: "api"
                    sourceId: "api-request"
                    points: 5
                    reason: "Example disciplinary action"
                    metadata:
                      executionSource: "discord"
                    history:
                      2026-04-15T00:00:00.000Z:
                        action: "init"
                        points: 5
                        reason: "Example disciplinary action"
                        metadata:
                          executionSource: "discord"
                        timestamp: "2026-04-15T00:00:00.000Z"
                        source: "api"
                        sourceId: "api-request"
                    createdAt: "2026-04-15T00:00:00.000Z"
                    updatedAt: null
                    expired: false
                meta:
                  timestamp: "2026-04-15T00:00:00.000Z"
                  path: "/v2/community/disciplinary/records/11111111-1111-1111-1111-111111111111/points"
components:
  securitySchemes:
    bearerAuth:
      type: "http"
      scheme: "bearer"
      bearerFormat: "JWT"
```

{% endtab %}

{% tab title="cURL" %}

```bash
curl --request PATCH \
  --url "https://api.sonorancms.com/v2/community/disciplinary/records/11111111-1111-1111-1111-111111111111/points" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Accept: application/json" \
  --data '{"points":10}'
```

{% endtab %}
{% endtabs %}

## Response

The `data` array contains the updated disciplinary record row(s) returned by the update query. The endpoint is reused for points, reason, and status updates.

```json
{
  "success": true,
  "data": [
    {
      "id": "55555555-5555-5555-5555-555555555555",
      "status": true,
      "accId": "00000000-0000-0000-0000-000000000000",
      "source": "api",
      "sourceId": "api-request",
      "points": 5,
      "reason": "Example disciplinary action",
      "metadata": {
        "executionSource": "discord"
      },
      "history": {
        "2026-04-15T00:00:00.000Z": {
          "action": "init",
          "points": 5,
          "reason": "Example disciplinary action",
          "metadata": {
            "executionSource": "discord"
          },
          "timestamp": "2026-04-15T00:00:00.000Z",
          "source": "api",
          "sourceId": "api-request"
        }
      },
      "createdAt": "2026-04-15T00:00:00.000Z",
      "updatedAt": null,
      "expired": false
    }
  ],
  "meta": {
    "timestamp": "2026-04-15T00:00:00.000Z",
    "path": "/v2/community/disciplinary/records/11111111-1111-1111-1111-111111111111/points"
  }
}
```