Users and organizations

Workspace and editor keys

Your Weavour workspace owns billing and editor configurations. Each editor key selects that workspace and an editor. userId and organizationId are IDs from your application within that workspace. The same IDs in another customer workspace do not share content.

Choose stable IDs

Pass userId for a personal context, or both userId and organizationId for an organization. Use stable IDs rather than display names. IDs are case-sensitive and preserve valid whitespace.

What is shared

• Images: shared across users and editors in the same organization and customer workspace; personal to the user when no organization is supplied.
• Organization blocks: shared across editors in the same organization. Inserting a block creates an independent copy.
• User templates: private to the organization/user pair, or the user alone, until explicitly shared.
• Drafts: keep their editor and identity scope. Sharing a library does not share every document.

Identity and access

Supplied IDs are declarative namespaces, not authenticated identities. Callers using the same key and IDs can access and modify content in that scope. A public editor key and origin restrictions do not authenticate the end user.

Your application manages user sessions and chooses the IDs. Dashboard administration uses separate authentication. Switching IDs requires saving current work and mounting a new instance.