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.
/ contracts. v1. Contracts/ UpdateAccountGroupRequest body
application/jsonRequired
Request to rename an account group or replace its members. Fields left out are unchanged.
accountGroupId?stringAccount 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?stringNew name. Omitted leaves the name unchanged.
patch?AccountGroupPatchNullable membership updates. Cannot be supplied together with a non-empty legacy members list.
Show attributes
members?objectOmitted 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?AccountGroupThe account group with the update applied.
Show attributes
createdAt?stringWhen the account group was created.
Format"date-time"
deletedAt?stringWhen the account group was soft-deleted, if it has been.
Format"date-time"
id?stringOpaque 16-byte account group identifier, base64-encoded in JSON.
Format"byte" base64
members?array<string>Steam account names that belong to the group.
name?stringHuman-readable account group name.
updatedAt?stringWhen the account group was last modified.
Format"date-time"
workspaceId?stringWorkspace the account group belongs to.
Format"byte" base64
application/json
The request was malformed, such as a missing required field or an unparseable cursor.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request lacks a valid API key in the Authorization header.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The API key is not allowed to perform this action on this workspace.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The requested resource does not exist in this workspace.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request was rate limited. Slow down and retry later.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
An internal server error occurred.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
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"
]
}'const res = await fetch("https://api.goldmine.to/contracts.v1.Contracts/UpdateAccountGroup", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"accountGroupId": "EBESExQVFhcYGRobHB0eHw==",
"name": "AK-47 Redline buyers (EU)",
"members": [
"redline_trader_eu",
"float_hunter_01",
"float_hunter_02"
]
}),
});
const data = await res.json();body := strings.NewReader(`{
"accountGroupId": "EBESExQVFhcYGRobHB0eHw==",
"name": "AK-47 Redline buyers (EU)",
"members": [
"redline_trader_eu",
"float_hunter_01",
"float_hunter_02"
]
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/contracts.v1.Contracts/UpdateAccountGroup", body)
if err != nil {
return err
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("CSTRADER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)import os, requests
res = requests.post(
"https://api.goldmine.to/contracts.v1.Contracts/UpdateAccountGroup",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"accountGroupId": "EBESExQVFhcYGRobHB0eHw==",
"name": "AK-47 Redline buyers (EU)",
"members": [
"redline_trader_eu",
"float_hunter_01",
"float_hunter_02"
]
},
)
data = res.json(){
"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"
}
}{
"code": "invalid_argument",
"message": "The request was malformed, such as a missing required field or an unparseable cursor."
}{
"code": "unauthenticated",
"message": "The request lacks a valid API key in the Authorization header."
}{
"code": "permission_denied",
"message": "The API key is not allowed to perform this action on this workspace."
}{
"code": "not_found",
"message": "The requested resource does not exist in this workspace."
}{
"code": "resource_exhausted",
"message": "The request was rate limited. Slow down and retry later."
}{
"code": "internal",
"message": "An internal server error occurred."
}