# Incidents
Incidents help you track, investigate, and resolve data quality issues when they occur. An incident is created when a data issue, such as a failed or warning check, has been confirmed and assigned to someone for resolution.
To create or update an incident, the user has to have "Manage Incidents" on the related dataset.
## How to create an incident
{% hint style="warning" %}
Only users with the **Manage Incidents** permission for the dataset can create or edit incidents. All users with access to the dataset can view existing incidents. Read about [global-and-dataset-roles](https://docs.soda.io/organization-and-admin-settings/global-and-dataset-roles "mention")
{% endhint %}
You can create an incident directly from a check result when an issue has been identified:
{% stepper %}
{% step %}
#### Navigate to a check page
On a check page, use the **context menu** to select **Create Incident**.
{% endstep %}
{% step %}
#### Describe the incident
Provide a **name** and **description** for the incident.
{% endstep %}
{% step %}
#### Connect the incident to check results
Select one or multiple **related check results** that you want to associate with the incident.
{% endstep %}
{% step %}
#### Create the incident
:octagon-check: Click **Save** to proceed
{% endstep %}
{% endstepper %}
## View incidents for a dataset
Once created, the incident will appear in the **Incidents tab** of the corresponding **Dataset Page**
It is possible to filter incidents based on lead, status, reporter, and severity.
## View incidents across the organization
Incidents can also be seen in a central place in Soda Cloud. In the top navigation, click on Incidents to see all the incidents of the organization.
Use the filters and the title search to find relevant incidents.
## Updating an incident
### Assign a lead
Every incident requires a **lead:** the user responsible for resolving the issue.
### Update status
Track progress by updating the incident’s status as the investigation and resolution evolve.
### Add a resolution note
When marking an incident as **resolved**, a resolution note is mandatory to document what was done.
### Include more check results
If new results are failing, you can include them in the incident.
{% hint style="success" %}
After any changes, click **Save** or **Resolve** on the top right corner to apply them.
{% endhint %}
## Integration with external systems
You can integrate incidents with Slack, MS Teams, or other external systems using Soda’s **webhook** capabilities or the **Incidents API**.
> Learn on how to integrate with Soda: [Integrations](https://docs.soda.io/integrations).
***
{% if (visitor.claims.plan === 'datasetStandard')
%}
{% hint style="success" %}
You are **logged in to Soda** and seeing the **Free license** documentation. Learn more about [documentation-access-and-licensing](https://docs.soda.io/reference/documentation-access-and-licensing "mention").
{% endhint %}
{% endif %}
{% if (visitor.claims.plan === 'enterprise')
%}
{% hint style="success" %}
You are **logged in to Soda** and seeing the **Team license** documentation. Learn more about [documentation-access-and-licensing](https://docs.soda.io/reference/documentation-access-and-licensing "mention").
{% endhint %}
{% endif %}
{% if (visitor.claims.plan === 'enterpriseUserBased')
%}
{% hint style="success" %}
You are **logged in to Soda** and seeing the **Enterprise license** documentation. Learn more about [documentation-access-and-licensing](https://docs.soda.io/reference/documentation-access-and-licensing "mention").
{% endhint %}
{% endif %}
{% if !(visitor.claims.plan === 'enterprise' || visitor.claims.plan === 'enterpriseUserBased' || visitor.claims.plan === 'datasetStandard')
%}
{% hint style="info" %}
You are **not logged in to Soda** and are viewing the default public documentation. Learn more about [documentation-access-and-licensing](https://docs.soda.io/reference/documentation-access-and-licensing "mention").
{% endhint %}
{% endif %}
---
# 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.soda.io/manage-issues/incidents.md?ask=
```
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.
