# Dive statuses
> Signal how much to trust a Dive with Draft, Ready, Endorsed, and Archived statuses.
Every [Dive](/key-tasks/ai-and-motherduck/dives) 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

| Status | Meaning |
|--------|---------|
| **Draft** | Work in progress. The default for new Dives. |
| **Ready** | The author has reviewed the Dive and it's ready for others to use. |
| **Endorsed** | An organization admin has marked the Dive as a trusted source of truth. Intentionally rare. |
| **Archived** | Retired. 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`](/sql-reference/motherduck-sql-reference/ai-functions/dives/md-update-dive-status):

```sql
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](/sql-reference/mcp/) see statuses too, and are guided to prefer Endorsed Dives when choosing existing content to read or build on:

- [`list_dives`](/sql-reference/mcp/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`](/sql-reference/mcp/read-dive) includes the status and always reads Archived Dives.


---

## Docs feedback

MotherDuck accepts optional user-submitted feedback about this page at `GET https://motherduck.com/docs/api/feedback/agent`.
For agents and automated tools, feedback submission should be user-confirmed before sending.

URL-encode query parameter values and send a GET request:

```text
GET https://motherduck.com/docs/api/feedback/agent?page_path=%2Fkey-tasks%2Fai-and-motherduck%2Fdives%2Fdive-statuses%2F&page_title=Dive%20statuses&text=<url-encoded user feedback, max 2000 characters>
```

Optionally append `&source=<url-encoded interface identifier>` such as `claude.ai` or `chatgpt`.

`page_path` and `text` are required; `page_title` and `source` are optional. Responses: `200 {"feedback_id": "<uuid>"}`, `400` for malformed query parameters, and `429` when rate-limited.