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

# Permanent Bans

<img src="https://mintcdn.com/hyra/_qr5ulpWZdIsRVbg/images/pbans-his.png?fit=max&auto=format&n=_qr5ulpWZdIsRVbg&q=85&s=800f8f8276a751a58764226f74ca99ae" className="rounded-xl" alt="Bans Page in Hyra" width="2326" height="1246" data-path="images/pbans-his.png" />

Hyra's Player Bans allow you to log your permanent bans from your game to your Hyra workspace! It also allows your staff to insert evidence using Hyra's fast CDN!

<Tip>
  This article will show how to use the Permanent Bans Dashboard. For it's API Documentation, click
  [here](https://docs.hyra.io/api-reference/introduction).
</Tip>

## Setting Up

To set it up, you'll need to integrate Hyra's Ban API to your moderation suite. We suggest getting a scripter to integrate the two.

For more information on Hyra's Ban API, click [here.](https://docs.hyra.io/api-reference/players/get-playersbans)

## Permanent Bans Dashboard

The dashboard shows the following:

* <b>Permanent Bans List</b> allows you to see all of the bans in a list.
* <b>Only your Bans</b> allows you to filter the list to only show your bans. This is great for those who needs to insert
  evidences in their bans.
* <b>Search</b> allows you search for a ban. You can search via a banned player or moderator.
* <b>Log a missed ban</b> allows you to create a missing ban.

### Ban Information

In the list, you can click the <b>Ban ID</b> to access more information about the ban. You can also add comments and attachments to show proof of the ban.

<img src="https://mintcdn.com/hyra/_qr5ulpWZdIsRVbg/images/players-ban_info.png?fit=max&auto=format&n=_qr5ulpWZdIsRVbg&q=85&s=2bada74e1a700ebcd7d02db6cbcf6f13" className="rounded-xl" alt="Ban Information in Hyra" width="1959" height="944" data-path="images/players-ban_info.png" />

### Adding evidence

You can use the comments feature to attach evidence to your ban

<div style={{ position: "relative", paddingTop: "56.25%", background: "#000" }}>
  <iframe src="https://iframe.mediadelivery.net/embed/58977/cddba8f3-49b1-44d0-870b-d3d16b09c3e4?autoplay=false&loop=false&muted=false&preload=true&responsive=true" loading="lazy" style={{ border: 0, position: 'absolute', top: 0, height: '100%', width: '100%'}} allow="accelerometer;gyroscope;autoplay;encrypted-media;picture-in-picture;" allowfullscreen="true" />
</div>

### Logging a Missing Permanent Ban

Sometimes, Hyra can fail to log a permanent ban automatically. You can manually log one by clicking <b>Log a missed ban</b>.

In the form, you'll need to type in the username, reason, and which game is it.

<Warning>
  Once you've hit <b>Submit</b>, it will be permanently logged. <b>You cannot delete the ban.</b>
</Warning>

<img src="https://mintcdn.com/hyra/_qr5ulpWZdIsRVbg/images/players-missing_ban.png?fit=max&auto=format&n=_qr5ulpWZdIsRVbg&q=85&s=a54bb4ec7ca7111c1ebd21c2caecde4f" className="rounded-xl" alt="Missing Ban Form in Hyra" width="2444" height="1375" data-path="images/players-missing_ban.png" />

## Revoking a Ban

You cannot revoke a ban in the Ban Dashboard. You'll need to use an API to revoke a ban. This is for data integrity and security reasons.

For more information on the API, click [here.](https://docs.hyra.io/api-reference/players/delete-playersbans)
