Skip to main content
A workspace is the top-level container for everything in Marble. Each workspace holds its own posts, media, authors, categories, tags, custom fields, API keys, and team members — fully isolated from every other workspace.
Think of a workspace as a single project: a personal blog, a company website, or a documentation site. If you manage multiple sites, create a separate workspace for each.

​
What lives in a workspace

Content

Posts, authors, categories, and tags — see the content model.

Media

Images and video uploaded to the workspace’s media library.

Custom fields

Workspace-specific metadata fields added to posts.

API keys

Keys that scope API access to this workspace’s content.

​
Workspaces and the API

A workspace is also the boundary for API access. Every API key belongs to a single workspace, so a key only ever returns content from that workspace. This keeps your projects cleanly separated — there’s no way for one site’s key to read another site’s posts. Create and manage keys from Settings → API Keys in your dashboard. See API Authentication to make your first request.

​
Team members and roles

Invite collaborators to a workspace from Settings → Members. Each member has a role that determines what they can do:
RoleDescription
OwnerFull control of the workspace, including billing, deleting the workspace, and managing the logo and members. There is one owner per workspace.
AdminManage content and members, but cannot perform owner-only actions like deleting the workspace.
MemberWrite, edit, and publish content within the workspace.
1

Open member settings

Go to your workspace dashboard and open Settings → Members.
2

Send an invite

Enter the person’s email and choose a role. They’ll receive an invitation to join.
3

They accept and start writing

Once accepted, they appear in the members list and can collaborate on content.
Workspace members and authors are related but distinct. A member is someone with dashboard access; an author is a byline attached to posts. See the content model for how they connect.

​
Next steps

Content Model

How posts, authors, categories, and tags fit together.

API Keys

Create a key and make your first request.