Goldmine
Workspaces

Fetch multiple workspaces by ID

POST
/accounts.v1.Accounts/GetWorkspaces

Returns the workspaces for a list of IDs in a single call. The caller must be a member of each workspace requested; IDs that do not match a workspace are reported separately.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/accounts.v1.Accounts/GetWorkspaces" \  -H "Content-Type: application/json" \  -d '{    "workspaceIds": [      "AAECAwQFBgcICQoLDA0ODw==",      "9HrBC1jMQ3KlZw4CssPUeQ=="    ]  }'
{
  "workspaces": [
    {
      "id": "AAECAwQFBgcICQoLDA0ODw==",
      "name": "Acme Trading",
      "description": "Primary trading workspace.",
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-03-02T14:22:30Z"
    }
  ],
  "notFoundIds": [
    "9HrBC1jMQ3KlZw4CssPUeQ=="
  ]
}
{
  "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."
}

GetWorkspace

Returns the workspace record identified by workspace_id. The caller must be a member of the workspace; requests for workspaces the caller does not belong to are rejected with permission_denied.

UpdateWorkspace

Updates a workspace's name or description. Only the fields you supply are changed.