API Reference / Steam chat
List chat conversations across the workspace
Return one conversation per Steam account and counterpart pair across the workspace, ordered by each pair's most recent message, with the newest message, who wrote it, the unread count and the open trade offers between the pair. Filters by text, counterpart, account and unread state apply before pagination.
/ steam. v1. Steam/ ListWorkspaceConversationsRequest body
application/jsonRequired
Request for one page of conversations across every Steam account in the workspace, one row per account and counterpart pair, ordered by most recent message.
cursor?stringOpaque cursor bound to the authorized workspace, normalized filter, and newest-message order. Empty for the first page. Reset when any predicate changes. Legacy unscoped cursors are rejected.
filter?WorkspaceConversationFilterOptional filters applied to the complete set of workspace conversation pairs before pagination. Keep unchanged on continuation pages.
Show attributes
accountName?stringOptional exact Steam account name, so the list reads one account's conversations. Absent or empty reads every active account's.
partnerSteamId?stringOptional exact counterpart SteamID for an authorized workspace conversation lookup, including older threads outside loaded sidebar pages. Intersects the other fields when present. Absent or empty reads all matching counterparts.
query?stringCase-insensitive literal substring across partner SteamID, the account name holding the thread, and last-known persona names observed by active workspace accounts. Whitespace is trimmed. Absent or empty matches every conversation.
unread?booleanTrue keeps only pairs with unread inbound messages, false keeps only pairs with none, absent keeps both.
limit?integerMaximum number of conversations to return. Server caps this at a service-defined upper bound.
Format"int32"
Response body
application/json
Success
conversations?array<WorkspaceConversation>Conversation pairs, newest message first.
Show attributes
accountName?stringThe Steam account holding this thread.
lastMessageAt?stringWhen the newest message between this account and the counterpart was sent.
Format"date-time"
lastMessageDirection?stringWhether the account sent or received the newest message, so the row can say who wrote it.
Value in"CHAT_"CHAT_
lastMessagePreview?stringBody text of the newest message between this account and the counterpart.
openTradeOfferCount?integerTrade offers between this account and the counterpart that are awaiting a confirmation, active or in escrow, excluding imported history.
Format"int32"
partnerSteamId?stringThe counterpart's 64-bit SteamID.
unreadCount?integerNumber of inbound messages newer than this account's read cursor for the counterpart.
Format"int32"
nextCursor?stringCursor to pass to fetch the next page. Empty when there are no more results.
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 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/steam.v1.Steam/ListWorkspaceConversations" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"limit": 50
}'const res = await fetch("https://api.goldmine.to/steam.v1.Steam/ListWorkspaceConversations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"limit": 50
}),
});
const data = await res.json();body := strings.NewReader(`{
"limit": 50
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/steam.v1.Steam/ListWorkspaceConversations", 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/steam.v1.Steam/ListWorkspaceConversations",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"limit": 50
},
)
data = res.json(){
"conversations": [
{
"partnerSteamId": "76561198044443322",
"lastMessageAt": "2026-06-29T11:52:00Z",
"lastMessagePreview": "Hi, your item has been sent!",
"unreadCount": 2,
"accountName": "trader_bot_01",
"lastMessageDirection": "CHAT_MESSAGE_DIRECTION_OUTBOUND",
"openTradeOfferCount": 1
}
],
"nextCursor": "eyJ0cyI6IjIwMjYtMDYtMjkifQ=="
}{
"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": "resource_exhausted",
"message": "The request was rate limited. Slow down and retry later."
}{
"code": "internal",
"message": "An internal server error occurred."
}