Skip to content

API Reference / Workspaces

Create a workspace

Creates a new workspace. The caller becomes the workspace owner.

POST/accounts.v1.Accounts/CreateWorkspace

Request body

application/jsonRequired

Request to create a workspace with the caller as its owner.

description?string

Free-text description of the workspace. May be empty.

name?string

Workspace name, up to 256 characters after trimming. Empty names the workspace "Workspace".

Response body

application/json

Success

workspace?Workspace

The new workspace, owned by the caller.

Show attributes
createdAt?string

When the workspace was created.

Format"date-time"

deletedAt?string

When the workspace was soft-deleted. Unset for active workspaces.

Format"date-time"

description?string

Free-form workspace description set by the workspace owner.

getStartedCompletedAt?string

When the workspace completed Get started: the first time it had proxies, accounts, a connected market and a contract all at once. Unset until then. Once set it is never cleared.

Format"date-time"

hardDeleteAt?string

When a soft-deleted workspace and everything in it is removed permanently. Unset for active workspaces.

Format"date-time"

id?string

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

Format"byte" base64

memberCount?integer

Number of accepted memberships in the workspace, computed server-side at read time. Read-only: any value sent by a client is ignored.

Format"int32"

name?string

Human-readable workspace name.

owner?ActorSummary

The workspace owner resolved for display at read time. Set only on administrator reads. Unset when the workspace has no accepted owner.

Show attributes
avatarUrl?string

The user's avatar image URL. Unset for an API key or a user with no avatar.

displayName?string

The user's name or the API key's name at read time. Empty when the actor no longer exists.

id?string

Opaque 16-byte identifier of the user or API key, base64-encoded in JSON.

Format"byte" base64

subjectType?string

How the actor authenticated: a user session or an API key.

Value in"SUBJECT_TYPE_SESSION""SUBJECT_TYPE_API_KEY""SUBJECT_TYPE_SERVICE"

ownerEmail?string

The workspace owner's email. Set only on administrator reads.

updatedAt?string

When the workspace was last modified.

Format"date-time"

curl -X POST "https://api.goldmine.to/accounts.v1.Accounts/CreateWorkspace" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Redline Flips",
    "description": "Knife and glove flipping desk."
  }'
{
  "workspace": {
    "id": "9HrBC1jMQ3KlZw4CssPUeQ==",
    "name": "Redline Flips",
    "description": "Knife and glove flipping desk.",
    "createdAt": "2026-06-29T12:00:00Z",
    "updatedAt": "2026-06-29T12:00:00Z"
  }
}