Update an organization group with the Organization API

Rename an Organization Group or set its per-member monthly spend cap with PATCH https://api.cursor.com/organizations/groups/:groupId. Official reference: Organization API → Update Organization Group. Dashboard context: Organization Groups.

Authenticate with an Organization API key (Basic auth, key as username, empty password). Writes need members:* (or admin:*). Rate limit: 20 requests per minute per organization.

Updates are partial: send at least one field. Omitted fields keep their current value. :groupId must be the Organization API id (g_…).

Rename and set a spend limit

curl -X PATCH https://api.cursor.com/organizations/groups/g_PDSPmvukpYgZEDXsoNirw3CFhy \
  -u YOUR_ORGANIZATION_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Platform Engineering",
    "monthlySpendingLimitDollars": 500
  }'

Field	Rules
name	New unique name among active groups in the organization. Whitespace trimmed
monthlySpendingLimitDollars	Whole dollars from 0 to 2147483647 for each group member
clearMonthlySpendingLimitDollars	true removes the group spend limit. Do not send this with monthlySpendingLimitDollars in the same body

{
  "group": {
    "id": "g_PDSPmvukpYgZEDXsoNirw3CFhy",
    "publicId": "grp_01k2ja2000e0080000000000n2",
    "name": "Platform Engineering",
    "memberCount": 12,
    "monthlySpendingLimitDollars": 500,
    "createdAt": "2026-01-15T10:30:00.000Z",
    "updatedAt": "2026-01-20T14:22:00.000Z"
  }
}

Clear the spend limit

curl -X PATCH https://api.cursor.com/organizations/groups/g_PDSPmvukpYgZEDXsoNirw3CFhy \
  -u YOUR_ORGANIZATION_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "clearMonthlySpendingLimitDollars": true
  }'

Errors

Status	When
400	No update fields, invalid value, name already used by another active group, or both set and clear spend limit in one request
401	Key missing members:* (or admin:*)
404	Unknown g_… id on this organization

Pitfalls

• Sending monthlySpendingLimitDollars and clearMonthlySpendingLimitDollars together
• Passing decimal dollar amounts — only whole dollars are accepted
• Passing publicId (grp_…) as :groupId — PATCH needs id (g_…)
• Confusing this per-member group cap with Billing Group cycle spend on /teams/groups, or with Team directory group caps on /teams/directory-groups