Skip to content

API Reference / Memberships

Change a member's role

Makes a membership in the caller's workspace a member or an administrator. Only the owner can call it. The owner's own role is changed only by transferring ownership. The membership's policies are cleared, because an administrator holds every operational permission by role and a demoted administrator starts as a read-only member. Demoting an administrator also revokes the API keys they hold in the workspace, because a key never exceeds its holder's access.

POST/accounts.v1.Accounts/UpdateMembershipRole

Request body

application/jsonRequired

Request by the owner to make an accepted or invited membership in the caller's workspace a member or an administrator. Ownership moves only through TransferWorkspaceOwnership.

membershipId?string

Opaque 16-byte identifier of the membership to change, base64-encoded in JSON. The owner's own membership is refused.

Format"byte" base64

role?string

The new role: MEMBERSHIP_ROLE_MEMBER or MEMBERSHIP_ROLE_ADMINISTRATOR. Owner is refused.

Value in"MEMBERSHIP_ROLE_OWNER""MEMBERSHIP_ROLE_MEMBER""MEMBERSHIP_ROLE_ADMINISTRATOR"

Response body

application/json

Success

membership?Membership

The membership with its new role. Its policies are cleared either way: an administrator holds every operational permission by role, and a demoted administrator starts as a read-only member.

Show attributes
createdAt?string

When the membership was created, which for a member is when they were invited.

Format"date-time"

expiresAt?string

When a pending invitation stops being acceptable. Unset once accepted and for an owner.

Format"date-time"

id?string

Opaque 16-byte identifier of the membership, assigned when the invitation is created. Base64-encoded in JSON.

Format"byte" base64

invitedBy?string

Opaque 16-byte identifier of the user who sent the invitation. Unset for the workspace owner and for invitations sent before the inviter was recorded.

Format"byte" base64

lastActiveAt?string

When the member last used the workspace while signed in, to the minute. Unset for a member who has not used it since activity was recorded.

Format"date-time"

policies?array<string>

Names of the policies a member holds: any of "trading", "steam", "proxies", "analytics" and "csfloat". Empty means a read-only member. Not used for an owner or an administrator, who hold every operational permission by role.

role?string

Owner for the one person who holds the workspace (its creator until ownership is transferred), administrator for someone who runs it with the owner but cannot delete it, hand it over or change roles, or member for everyone else.

Value in"MEMBERSHIP_ROLE_OWNER""MEMBERSHIP_ROLE_MEMBER""MEMBERSHIP_ROLE_ADMINISTRATOR"

status?string

Invited until the invited user accepts, then accepted.

Value in"MEMBERSHIP_STATUS_INVITED""MEMBERSHIP_STATUS_ACCEPTED"

updatedAt?string

When the membership was last changed, such as accepted or given new policies.

Format"date-time"

userId?string

Opaque 16-byte identifier of the member user, base64-encoded in JSON.

Format"byte" base64

workspaceId?string

Opaque 16-byte identifier of the workspace, base64-encoded in JSON.

Format"byte" base64

curl -X POST "https://api.goldmine.to/accounts.v1.Accounts/UpdateMembershipRole" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "membershipId": "ICEiIyQlJicoKSorLC0uLw==",
    "role": "MEMBERSHIP_ROLE_ADMINISTRATOR"
  }'
{
  "membership": {
    "id": "ICEiIyQlJicoKSorLC0uLw==",
    "userId": "q83vq83vEjRWeBI0VniQqg==",
    "workspaceId": "AAECAwQFBgcICQoLDA0ODw==",
    "role": "MEMBERSHIP_ROLE_ADMINISTRATOR",
    "status": "MEMBERSHIP_STATUS_ACCEPTED",
    "createdAt": "2026-06-29T12:00:00Z",
    "updatedAt": "2026-06-29T12:20:00Z"
  }
}