Goldmine
Workspaces

Update a workspace

POST
/accounts.v1.Accounts/UpdateWorkspace

Updates the caller's active workspace's name or description. The target is always the workspace resolved from the caller's session or API key, never a request field, so a caller can never name a different workspace to update. Only the fields you supply are changed.

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

application/json

curl -X POST "https://loading/accounts.v1.Accounts/UpdateWorkspace" \  -H "Content-Type: application/json" \  -d '{    "description": "Primary trading and inventory workspace."  }'
{
  "workspace": {
    "id": "AAECAwQFBgcICQoLDA0ODw==",
    "name": "Acme Trading",
    "description": "Primary trading and inventory workspace.",
    "createdAt": "2026-01-15T10:00:00Z",
    "updatedAt": "2026-06-29T12:05: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."
}

ListWorkspaces

Returns every workspace the caller holds an accepted membership in, regardless of which workspace is currently active. There is no workspace_id or user_id request field; the result always means the caller's own workspaces.

GetMyPermissions

Returns the signed-in caller's role, granted policies, and the resolved set of permissions in the current workspace.