> ## Documentation Index
> Fetch the complete documentation index at: https://docs.izumi.akiaconsulting.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Proposals and review

> How a new note is proposed and who approves it.

Checked on Izumi 0.5.7, 2026-11-20.

A proposal is a note that an AI tool (or a person through their token) suggests for one domain. The note is not searchable until an editor of that domain approves it. The **Review queue** is the list of all proposals: an editor decides in it, and a proposer follows their own proposals.

## Who does what

| Role | What they see in the **Review queue** | Buttons in the detail |
| - | - | - |
| Domain editor | proposals of their domains and their own proposals | **Approve**, **Reject**, and **Withdraw** if they are also the proposer |
| Member without an editor role and without proposals of their own | an empty queue; someone else's proposal opens **Proposal not found** | none |

* The **Review queue** is in the left menu for every member of the company.
* A company admin is not automatically an editor. Only an editor of a domain sees the proposals of that domain and decides on them.

## Review and decide

**1. Open the queue**

Click **Review queue**. The number next to the item shows how many proposals wait for your decision. At the top you pick a status: **Pending**, **Approved**, **Rejected**, **Expired**, **Withdrawn** or **All**. Extra filters are **Domain** and **My proposals**. The columns are **Title**, **Domain**, **Proposer**, **Created**, **Expires in** and **Status**.

![Izumi, the Review queue](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/proposals/01-review-queue.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=1517a60833acb953f75cc8970928b253)

**2. Read the proposal**

Click a row. You see the status and the deadline ("Expires in: 30 days"), then the details **Domain**, **Proposer**, **Agent and client** and **Created**. Below are **Proposal text**, **Sources** and **Conversation**.

![Izumi, proposal detail](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/proposals/02-proposal-detail.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=2d501171da2586afd3b6bd67f11061c0)

**3. Approve**

Click **Approve**. The dialog has the fields **Title** (3 to 200 characters) and **Text (Markdown)** (20 to 20000 characters). The proposal gets the status **Approved**, and the note shortly appears in **Documents** with the **Note** label. The proposer is the author.

![Izumi, the Approve the proposal dialog](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/proposals/03-approve.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=ebeb0394a3025bf0b9ebd294a790e57c)

![Izumi, an approved proposal](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/proposals/07-approved.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=6894ce613ba93cb32d9e2b556eb116ab)

**4. Or reject**

Click **Reject**. A reason is required (up to 1000 characters), and the proposer sees it. No note is created and it never appears in search.

![Izumi, the Reject the proposal dialog](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/proposals/04-reject.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=74df87c273d1e8908ae3ac14a3517600)

![Izumi, a rejected proposal with the reason](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/proposals/08-rejected.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=3eb9245450ccf7bd8d59760f1872efd8)

## Withdraw your own proposal

**1. Click Withdraw**

Open your proposal and click **Withdraw**. The dialog says the proposal will be marked as withdrawn and nobody can approve it any more.

![Izumi, the dialog for withdrawing a proposal](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/proposals/05-withdraw.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=c84c51e346257c68b676ffb4d2e46ade)

**2. Follow your proposals**

Turn on **My proposals** and choose **All**. You see your proposals with their statuses and the reason for a rejection.

![Izumi, My proposals](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/proposals/06-proposer-view.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=261b0f8b83ae827b5760a6b8936d6b74)

A withdrawn proposal stays visible to the proposer and the editor (through the link and through the status **Withdrawn** or **All**), but it can no longer be decided.

## When a proposal is not available

If you open a proposal you may not see, or one that does not exist, you see **Proposal not found**: "It may have been decided, withdrawn or expired, or it is not yours to see." This is normal behavior, not an error.

![Izumi, Proposal not found](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/proposals/09-not-found.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=842f85e417fdc1a605d16869a7fca5c9)

## Limits

* An approved proposal is searchable within a few minutes. A rejected or withdrawn proposal is never searchable.
* A proposal is valid for 30 days, and the deadline shows in the **Expires in** column.
* Izumi does not send email about proposals. An editor sees only the number next to **Review queue**, and the proposer sees the outcome when they open their proposal.
* An approved note cannot be deleted from the **Documents** list or from the document page.

> [!WARNING]
>
> Not checked live yet: a proposer who is not an editor (only **Withdraw**, no **Approve** and **Reject**; the description comes from the code), changing the title or text before approving, expiry after 30 days and the status **Expired**, and how an AI tool (Claude, ChatGPT, Slackbot) learns the outcome of a proposal.

## Troubleshooting

* *"There are no proposals for your domains."* Nothing is pending, or you are not an editor of any domain and have no proposals of your own. Try **All** and **My proposals**.
* *"No proposal matches the filters."* Remove the **Domain** filter or choose **All**.
* *Proposal not found.* The proposal was decided, withdrawn or expired, or it is not yours to review. Open it from the list with the status **All**, or ask the proposer.
* *"This proposal can no longer be decided."* Someone already decided it, or the proposer withdrew it while your dialog was open. Refresh the list.
* *"The title needs 3 to 200 characters."* and *"The text needs 20 to 20000 characters."* Fix the fields in the **Approve the proposal** dialog.
* *"Enter a reason."* In the **Reject the proposal** dialog a reason is required.
* *"The proposals could not be loaded."* Refresh the page. If it keeps happening, tell your company admin.
* *An approved note is not found right away.* The message says "shortly". Wait a few minutes and search by words from the text.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.