Skip to content

API Reference / Steam accounts

Update a Steam account

Change the stored credentials, scraping toggle, or capability membership for an existing Steam account. Only the fields you supply are updated. Scraping and nonempty trading capabilities are mutually exclusive. Set both fields together when switching modes.

POST/steam.v1.Steam/UpdateAccount

Request body

application/jsonRequired

Request to change an existing Steam account's stored credentials, scraping toggle or trading capabilities. Only the fields supplied are changed.

accountNamestring

Steam account name to update.

apiKey?string

New account-tier Steam Web API key. Omit to leave unchanged.

capabilities?AccountCapabilities

Omit to leave capabilities unchanged. A present wrapper replaces the membership list and an empty wrapper clears it. Nonempty capabilities require scraping disabled.

Show attributes
values?array<string>

Supported trading capabilities. Empty clears the list. Repeated known members are accepted without reordering or deduplication.

Value in"ACCOUNT_CAPABILITY_CSFLOAT_BUY_ORDER""ACCOUNT_CAPABILITY_CSFLOAT_OFFER""ACCOUNT_CAPABILITY_CSFLOAT_SELL""ACCOUNT_CAPABILITY_CSFLOAT_AUCTION_BID"

identitySecret?string

New mobile confirmation identity secret, base64 encoded. Omit to leave unchanged. An empty string removes it.

isScraping?boolean

Omit to leave the scraping toggle unchanged. False explicitly disables it. Scraping requires an empty capability list.

password?string

New nonempty login password, preserved exactly including surrounding whitespace. Omit to leave unchanged.

patch?AccountPatch

Nullable account updates. Do not supply a field in both the legacy request and this patch.

Show attributes
apiKey?object

Omitted leaves the API key unchanged. JSON null removes it. A string sets it. Cannot be supplied together with the legacy api_key field.

sharedSecret?string

New Steam Guard mobile authenticator shared secret, base64 encoded. Omit to leave unchanged.

Response body

application/json

Success

account?Account

The updated Steam account.

Show attributes
accountName?string

Unique Steam account name within the workspace.

apiKeyConfigured?boolean

Whether the account has its own account-tier Steam Web API key configured. Never the key itself.

apiKeySaved?AccountSecretSaved

When the account's own Steam Web API key was last saved and by whom. Unset when none is saved, and for a key saved before the platform recorded it.

Show attributes
savedAt?string

When the secret was saved.

Format"date-time"

savedBy?string

The member who saved it. Absent when it was saved by the platform rather than a member, such as a staff import.

Format"byte" base64

avatarUrl?string

Full-size Steam profile picture of the account, from its most recently observed persona. Unset until Steam has provided the account's avatar.

banSeverity?string

What the account's bans mean for trading, derived from the ban fields: stops trading for an economy ban, trade lock or community ban, a warning for a VAC ban, game ban or economy probation, otherwise none.

Value in"ACCOUNT_BAN_SEVERITY_NONE""ACCOUNT_BAN_SEVERITY_WARNING""ACCOUNT_BAN_SEVERITY_STOPS_TRADING"

capabilities?array<string>

Opt-in per-market trading actions this account may perform. Always empty when is_scraping is true.

Value in"ACCOUNT_CAPABILITY_CSFLOAT_BUY_ORDER""ACCOUNT_CAPABILITY_CSFLOAT_OFFER""ACCOUNT_CAPABILITY_CSFLOAT_SELL""ACCOUNT_CAPABILITY_CSFLOAT_AUCTION_BID"

communityBanned?boolean

Whether the Steam account is community banned.

createdAt?string

When the account was added to the workspace. Unset for accounts added before the platform recorded it.

Format"date-time"

deletedAt?string

When the account was soft deleted. Unset for an active account.

Format"date-time"

economyBan?string

Steam economy ban state: none, probation, or banned.

generation?string

Persistent account lifecycle generation. Changes on creation or restoration, remains stable across sessions and ordinary updates. Zero means the producer does not provide an authoritative generation.

Format"int64"

identitySecretConfigured?boolean

Whether a mobile authenticator identity secret is saved for the account, so trade and market confirmations can be accepted. Never the secret itself.

identitySecretSaved?AccountSecretSaved

When the confirmation (identity) secret was last saved and by whom. Unset when none is saved, and for a secret saved before the platform recorded it.

Show attributes
savedAt?string

When the secret was saved.

Format"date-time"

savedBy?string

The member who saved it. Absent when it was saved by the platform rather than a member, such as a staff import.

Format"byte" base64

inventoryCheckedAt?string

When the account's community inventory was last successfully fetched. Unset when the inventory has never been fetched.

Format"date-time"

inventoryPrivateSince?string

When the account's community inventory was first observed as private. Unset when the inventory is readable.

Format"date-time"

isLimited?boolean

Whether Steam reports the account as limited, meaning it has not spent the minimum on Steam and cannot use some community and trading features.

isScraping?boolean

Cross-market scraping toggle. A scraping account may only be used for read-only operations on any market, never to hold buying balance, place a buy order or offer, bid an auction, or list inventory for sale.

lastSessionError?string

Steam EResult name of the most recent session error. Not cleared on recovery, so it stays the last-error breadcrumb until overwritten by the next error.

locked?boolean

Whether the Steam account is trade and market locked.

loginRetryAt?string

When a login-throttle cooldown ends and the next sign-in may be attempted. Unset when the account is not cooling down.

Format"date-time"

loginStatus?string

What the account's Steam session means for the operator, derived by the server from session_status and session_error_reason.

Value in"LOGIN_STATUS_LOGGED_IN""LOGIN_STATUS_RETRYING""LOGIN_STATUS_FAILED""LOGIN_STATUS_LOGGED_OUT"

numberOfGameBans?integer

Number of game bans on the Steam account.

Format"int32"

passwordSaved?AccountSecretSaved

When the password was last saved and by whom. Unset for a password saved before the platform recorded it.

Show attributes
savedAt?string

When the secret was saved.

Format"date-time"

savedBy?string

The member who saved it. Absent when it was saved by the platform rather than a member, such as a staff import.

Format"byte" base64

personaName?string

Most recently observed self-persona display name. Unset until Steam explicitly provides the account's name. Separate from its login username.

personaObservedAt?string

When Steam explicitly provided the self-persona state. Name-only and avatar-only updates do not refresh this state observation clock.

Format"date-time"

personaState?string

Most recently explicitly observed self-persona state. Zero is observed Offline. Unset means unknown. Last-known presence is separate from current connection status.

Value in"PERSONA_STATE_OFFLINE""PERSONA_STATE_ONLINE""PERSONA_STATE_BUSY""PERSONA_STATE_AWAY""PERSONA_STATE_SNOOZE""PERSONA_STATE_LOOKING_TO_TRADE""PERSONA_STATE_LOOKING_TO_PLAY"

reconnectCount?integer

Number of reconnects made within the current session establishment. Resets to 0 on each new session start.

Format"int32"

requestLatency?string

Latest measured correlated Steam request-to-first-response round trip in milliseconds, including server processing. Observed zero is valid. Unset means unmeasured. Separate from logon latency.

requestLatencyObservedAt?string

Original response time of the latest passively measured request round trip. Best-effort projection, separate from current connection and collection freshness.

Format"date-time"

sessionConnectedAt?string

When the account's current online stretch began: the logon that brought it online, kept across a reconnect or a move to another worker that logs on again within five minutes of going offline. Unset until the first logon.

Format"date-time"

sessionDisconnectedAt?string

When the account last went offline: moves when a logged-on account drops and stays put while an offline account keeps failing to sign in. Kept after it comes back online. Compare with session_connected_at.

Format"date-time"

sessionErrorReason?string

Typed cause of the most recent session error. Unset until a session has errored. Like last_session_error it is not cleared on recovery.

Value in"SESSION_ERROR_REASON_PROXY_NOT_ASSIGNED""SESSION_ERROR_REASON_PROXY_POOL_UNAVAILABLE""SESSION_ERROR_REASON_PROXY_UNREACHABLE""SESSION_ERROR_REASON_PROXY_AUTHENTICATION_FAILED""SESSION_ERROR_REASON_CREDENTIALS_REJECTED""SESSION_ERROR_REASON_ACCOUNT_RESTRICTED""SESSION_ERROR_REASON_LOGIN_THROTTLED""SESSION_ERROR_REASON_STEAM_UNAVAILABLE""SESSION_ERROR_REASON_WEB_SESSION_FAILED""SESSION_ERROR_REASON_INTERNAL"

sessionErrorUserFixable?boolean

Whether the customer can fix the account's current session error themselves, such as by updating its password or assigning a proxy. False when the session is not in error.

sessionLatency?string

Most recent logon round-trip latency in milliseconds. Unset until the session's first successful logon.

sessionStatus?string

Current Steam session lifecycle state.

Value in"SESSION_STATUS_DISCONNECTED""SESSION_STATUS_CONNECTING""SESSION_STATUS_CONNECTED""SESSION_STATUS_LOGGED_ON""SESSION_STATUS_ERROR"

sharedSecretSaved?AccountSecretSaved

When the Steam Guard shared secret was last saved and by whom. Unset for a secret saved before the platform recorded it.

Show attributes
savedAt?string

When the secret was saved.

Format"date-time"

savedBy?string

The member who saved it. Absent when it was saved by the platform rather than a member, such as a staff import.

Format"byte" base64

steamCreatedAt?string

When the Steam account itself was made, as Steam reports it. Unset until it has been read, and for an account whose Steam profile is private.

Format"date-time"

steamId?string

The account's 64-bit SteamID. Unset until the account has logged on at least once.

tradeOfferCheckedAt?string

When the current trade-offer list was last completely fetched and persisted in this account lifecycle, including a successful empty list. Unset until the first complete check. Separate from initial historical synchronization.

Format"date-time"

tradeOfferHistorySyncError?string

Bounded reason the scheduled history synchronization is waiting to retry. No recorded error when unspecified. Successful pages clear it without resetting progress.

Value in"TRADE_OFFER_HISTORY_SYNC_ERROR_ACCESS_DENIED""TRADE_OFFER_HISTORY_SYNC_ERROR_RATE_LIMITED""TRADE_OFFER_HISTORY_SYNC_ERROR_RETRYING"

tradeOfferHistorySyncedAt?string

When initial synchronization consumed all historical offer pages returned by Steam. Unset while pending or incomplete. Not a guarantee of lifetime history retention.

Format"date-time"

vacBanned?boolean

Whether the Steam account has a VAC ban.

workspaceId?string

Workspace the account belongs to.

Format"byte" base64

curl -X POST "https://api.goldmine.to/steam.v1.Steam/UpdateAccount" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountName": "trader_bot_01",
    "password": "newpassword99"
  }'
{
  "account": {
    "accountName": "trader_bot_01",
    "workspaceId": "AY86PB0ufwCKGyw9Tl9gcQ==",
    "sessionStatus": "SESSION_STATUS_LOGGED_ON",
    "steamId": "76561198000000001",
    "sessionConnectedAt": "2026-06-29T11:45:00Z",
    "communityBanned": false,
    "locked": false,
    "vacBanned": false,
    "numberOfGameBans": 0,
    "economyBan": "none"
  }
}