Workflows

Five flows cover almost everything users do on Monolith. Each maps cleanly onto API endpoints — the web app and desktop app are thin layers on top.

1. Onboard and create your Mark

Sign up at joinmonolith.com ; auth is handled by the Monolith identity service.
Pick a username. The system creates an initial personal Mark as your default.
Configure the Mark: license, AI training preference, description.

You can create more Marks later (e.g. one per series or per client) and switch between them when uploading.

2. Create an Artifact from a file

The fingerprint is computed locally; the file itself never leaves your device unless you opt in.

Web app: drag-and-drop on /create → fingerprint computed via WebCrypto → Artifact submitted. Image files trigger automatic C2PA signing and a thumbnail.

Desktop app: watch a folder; every new or modified file is fingerprinted and sent. Always-on protection in the background.

API: see the quickstart for the equivalent two-call sequence.

3. Verify provenance

Anyone — authenticated or not — can fetch an Artifact by fingerprint:


GET /api/v1/artifacts/0xabcdef…
Authorization: Bearer <token>

Result: the bound Mark, license, on-chain transaction hash, and (for public Marks) the author’s username. Private Marks redact author identity but still confirm the binding.

4. Collaborate via organizations and Mark members

Personal Marks — single owner. Add Mark members to grant Artifact-creation rights without giving up ownership.
Organization Marks — owned by an organization, governed by its subscription. Organization owners and members can submit Artifacts to any organization Mark.

API:

GET /api/v1/marks — list every Mark the caller can write to (across personal and organizational workspaces).
GET /api/v1/organizations — list every organization the caller belongs to.
GET /api/v1/marks/{markId}/artifacts — paginated Artifact list for one Mark (newest first; public Marks readable by anyone authenticated, private Marks gated to members).

5. Public discovery

Public Marks automatically surface in the Monolith gallery . Search by username, Mark name, organization, or fingerprint to verify existing attribution before creating an Artifact of your own.