# Notification logs

Notification logs allow you to understand and monitor what [notifications](/configure/settings/notifications.md) are being sent for your workspace, who they're sent to, and how users are engaging with them.

![See the notification list on the notification logs page](/files/nu8Us9ruplXEvhde7yfH)

### Log retention

Notification logs are retained for 30 days, and the contents of the notifications are retained for 14 days.

## Accessing notification logs in Cortex

You can view notification logs in the Cortex UI or fetch them through the [Cortex API](#access-notification-logs-via-api).

### Access notification logs via the Cortex UI

Users with the `View notification logs` permission can access notification logs in Cortex under [**Settings > Notification logs**](https://app.getcortexapp.com/admin/settings/notification-logs).

**Notification log summary**

The summary at the top of this page includes:

* A count of how many notifications are enabled
  * In the upper right corner of the Notification logs page, click **Workspace notifications** to visit the Notifications page where you can review the list of enabled notifications.
* The number of notifications delivered in the last 7 days
* The number of notifications that failed to deliver in the last 7 days

![The notification log summary is at the top of the page](/files/V8iSum4YDxbktAsnMNmE)

**Notification log list fields**

The list of notifications includes:

* Timestamp when the notification was sent
  * The timestamp is based on the client timezone from your browser. Hover over the timestamp to view the timezone being used.
* The name of the notification
  * An icon appears next to the notification name to indicate which medium was used to notify the user.
* The status
  * Statuses include:
    * `Completed`: The message was delivered successfully.
    * `Completed with errors`: Some recipients received the notification, but some did not. Click the notification to review details.
    * `Failed`: Notification failed to be delivered.
    * `Ignored`: The notification was ignored. This can occur for several reasons, including:
      * `Disabled workspace`: This status will appear if the notification medium has been disabled for the workspace, but there was an attempt to send a notification via that medium. For example, if an email notification is triggered, but email notifications are disabled for the workspace.
      * `Scorecard disabled`: Notifications are disabled for a scorecard.
    * `Created`: The notification has not yet been sent. If this occurs, try [resending the notification](#resend-a-notification).
* How many times it was sent
* The object that triggered the notification (e.g., a Scorecard, entity, initiative, etc.)
* The ability to resend the notification.

### Filter the notification logs list

1. In the upper right corner of the list, click **Filter**.
2. Select and configure filters for any of the following:
   * Failed reason
   * Ignored reason
   * Notification source
   * Notification type
   * Status\
     ![Click the Filter icon then apply filters](/files/tTcjdnq5AvEYqicuxiSD)
3. Click **Apply**.

You can also sort by date:

1. Click **Date** in the upper right corner.
2. Choose whether to sort ascending or descending.

### **View more information about a notification**

Click into a log to open a side panel showing the date a notification was sent, when it was last resent, who the recipients of the message were, and the contents of the notification:\
![A side panel shows more details about the notification](/files/v4fKUXZHC1OubjS6fb4D)

Notification logs are retained for 30 days, and the contents of the notifications are retained for 14 days.

## **Resend a notification**

Users with the `Execute notification logs` permission can resend a notification to all users, or to specific users.

To resend a notification:

1. Locate the notification in the list.
2. In the row for the notification, click the **Resend** icon on the right side. ![Click the Resend icon at the end of the row](/files/c1ocfwQg1QSmJSRltwkj)
3. A confirmation modal will appear.
   1. If the previous notification did not successfully send to all recipients, you will have the option to only resend to recipients who didn't receive the notification.\
      ![](/files/eYwAFoH9vwvHB8BMO7RX)
4. Click **Resend notification**.

## Access notification logs via API

Notification logs can also be accessed through the [public API endpoint](/api/readme/notification-logs.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cortex.io/configure/settings/notifications/logs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.