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:
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.