Skip to content

API Reference / Steam account groups

Update an account group

Renames an account group or replaces its full membership. A non-empty members list replaces the group's accounts. An omitted or empty list leaves the membership unchanged.

POST/contracts.v1.Contracts/UpdateAccountGroup

Request body

application/jsonRequired

Request to rename an account group or replace its members. Fields left out are unchanged.

accountGroupId?string

Account group identifier.

Format"byte" base64

members?array<string>

When non-empty, replaces the full membership. Empty or omitted leaves membership unchanged. Use patch.members to explicitly empty the group.

name?string

New name. Omitted leaves the name unchanged.

patch?AccountGroupPatch

Nullable membership updates. Cannot be supplied together with a non-empty legacy members list.

Show attributes
members?object

Omitted leaves membership unchanged. JSON null or an empty list clears it. A list of Steam account names replaces it. Cannot be supplied together with a non-empty legacy members list. An empty group selects no accounts.

Response body

application/json

Success

accountGroup?AccountGroup

The account group with the update applied.

Show attributes
createdAt?string

When the account group was created.

Format"date-time"

deletedAt?string

When the account group was soft-deleted, if it has been.

Format"date-time"

id?string

Opaque 16-byte account group identifier, base64-encoded in JSON.

Format"byte" base64

members?array<string>

Steam account names that belong to the group.

name?string

Human-readable account group name.

updatedAt?string

When the account group was last modified.

Format"date-time"

workspaceId?string

Workspace the account group belongs to.

Format"byte" base64

curl -X POST "https://api.goldmine.to/contracts.v1.Contracts/UpdateAccountGroup" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountGroupId": "EBESExQVFhcYGRobHB0eHw==",
    "name": "AK-47 Redline buyers (EU)",
    "members": [
      "redline_trader_eu",
      "float_hunter_01",
      "float_hunter_02"
    ]
  }'
{
  "accountGroup": {
    "id": "EBESExQVFhcYGRobHB0eHw==",
    "workspaceId": "AAECAwQFBgcICQoLDA0ODw==",
    "name": "AK-47 Redline buyers (EU)",
    "members": [
      "redline_trader_eu",
      "float_hunter_01",
      "float_hunter_02"
    ],
    "createdAt": "2026-03-12T08:30:00Z",
    "updatedAt": "2026-06-29T11:00:00Z"
  }
}