Skip to main content

Dive statuses

Every Dive carries a status that signals how much to trust it. Status drives where a Dive appears and how prominently — it never controls who can view or edit it.

The four statuses​

StatusMeaning
DraftWork in progress. The default for new Dives.
ReadyThe author has reviewed the Dive and it's ready for others to use.
EndorsedAn organization admin has marked the Dive as a trusted source of truth. Intentionally rare.
ArchivedRetired. Archived Dives stay accessible by URL and ID, but sort last and are hidden from AI agent listings by default.

A status is a statement about the trustworthiness of the Dive. Updating a Dive's content doesn't reset or change its status.

Who can set a status​

  • Owners can set Draft, Ready, or Archived on their own Dives.
  • Organization admins can set any status on any Dive in the organization, and only admins can set Endorsed.

Setting a status​

Open the Dive and select the status badge in the viewer header to pick a status. The picker offers only the statuses you can set; if you can't set any, the badge is read-only.

Moving a Dive off Endorsed is one-way unless you're an admin. Only admins can endorse, so the picker asks you to confirm before a non-admin owner gives up an endorsement.

You can also set a status with SQL using MD_UPDATE_DIVE_STATUS:

SELECT * FROM MD_UPDATE_DIVE_STATUS(
  id ='your-dive-uuid'::UUID,
  status ='ready'
);

Where status appears​

  • Dive viewer header: the status badge, which doubles as the picker when you can set a status.
  • Dives list page: a status column with a badge per Dive. Select a badge to filter the list to that status (select it again to clear the filter), use the filter button to combine statuses, or type a status name in the search box. In the organization-wide view, Dives sort by status — Endorsed first, Archived last — ordered by last viewed within each status.
  • Sidebar: hover over a Dive to see its status in the tooltip.

Statuses and AI agents​

Agents connected through the MotherDuck MCP Server see statuses too, and are guided to prefer Endorsed Dives when choosing existing content to read or build on:

  • list_dives returns each Dive's status and orders results from most to least trusted. Archived Dives are excluded unless the agent asks for them.
  • read_dive includes the status and always reads Archived Dives.