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

# Cases and evidence

> Read moderation results and retry a failed action without making a second case.

Open **Moderation → Cases** or use a private slash command:

```text wrap theme={null}
/cases limit:10
/case number:5
/history user:@Alex
```

A case keeps the action, reason and result for every recorded moderation action. Channel actions identify the channel. Check the action status and each notification to see whether the action succeeded and the member received their DM. Imported cases are labelled read-only and link to their source capture.

## Browse older cases

Use the **Next** and **Previous** buttons, or add `page` to `/cases` or `/history`:

```text wrap theme={null}
/cases limit:10 page:2
/history user:@Alex page:2
```

`/case` opens the numbered case. `/reason` can update a pup case's reason; [warning revocation](https://docs.pup.run/warnings.md#revoke-a-warning) applies to warnings.

## Retry a failed step

Correct the missing permission, role position or destination, then select **Retry** on the failed case action or notification. Completed steps are not repeated. For blocked DMs, ask the member to allow messages from pup before retrying.

**Technical details** includes identifiers and diagnostic codes for investigating failures. Include them when asking the operator for help.

## Change a reason or add a note

```text wrap theme={null}
/reason case:5 reason:Repeated disruption after a moderator reminder.
/note user:@Alex note:Asked staff to follow up about the next walk.
```

Reasons require text when being edited. Staff notes require note content and restricted access; an ordinary case summary does not expose them. Check [command inputs](https://docs.pup.run/commands.md) for each command's current options.

## Case evidence

Evidence loads when you open a case. Case viewers can read and download stored
evidence; case administrators can delete it. Select **Download evidence** beside
an available item. See [Data and privacy](https://docs.pup.run/privacy.md) for file storage and deletion.

Moderation actions record references to their source message. They do not yet save
that message's text or files for later reading. These entries appear as
**Inaccessible**. Missing, deleted,
inaccessible or oversized content cannot be downloaded.

## Related tasks

See [Warnings](https://docs.pup.run/warnings.md) for expiry and escalation. [Activity](https://docs.pup.run/activity.md) lists scheduled reversals and event history. [Imported history](https://docs.pup.run/imported-history.md) explains Carl captures.

## Export cases

Open **Moderation → Case export** to choose a member, date range and case kinds. Download CSV or JSON when the export is ready. Export access is separate from reading a case, and restricted notes still require their own permission. Keep downloaded files private; deleting pup's copy does not remove your download.


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