Skip to main content
Every artifact lives under a two-level namespace: a workspace and a project. 
/{workspaceSlug}/{projectSlug}/{artifactSlug}
The workspace owns billing, membership, and namespace policy. The project groups related artifacts inside that workspace.

​
Workspaces

A workspace is either personal or team-based.
KindPurposeCreated
personalYour default namespaceWhen you claim a username
teamA shared namespace for collaborationBy signed-in users on a plan that allows team workspaces
Workspace slugs follow the same rules as usernames:
  • 3 to 32 characters.
  • Lowercase letters, numbers, underscores, and hyphens.
  • Must start and end with a letter or number.
  • Must not collide with reserved app routes such as api, docs, login, dashboard, or mcp.

​
Roles

Workspace membership grants access to the projects and artifacts in that namespace.
RoleTypical use
ownerFull namespace control and billing ownership
adminManage members and content
memberCreate and edit content
viewerRead visible workspace content
billing_adminManage billing without full content administration
Team invitations can grant admin, member, viewer, or billing_admin.

​
Projects

A project groups artifacts under a workspace: 
/alice/default/launch-review
/acme/design-explorations/pricing-grid
Each project has a projectId, an owner (ownerUsername or workspaceSlug), a slug, a title, an optional description, and an icon. Project slugs normalize to lowercase letters, numbers, and single hyphens.

​
Create a project

artifacts project create --json '{"ownerUsername":"alice","slug":"research","title":"Research"}'

​
Resolving paths

Artifacts supports path-first lookup for both humans and agents — useful when you have a URL but need an artifact ID for follow-up calls. 
artifacts path project --owner alice --project-slug research
artifacts path artifact --owner alice --project-slug research --slug synthesis
Project path resolution returns the project plus the artifacts visible to the caller. Artifact path resolution applies normal access policy and any share-link grants.