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

# Actualizar Alerta

> Actualiza una alerta existente

## Descripción

Este endpoint permite actualizar los detalles de una alerta existente. Puede modificar cualquier campo de la alerta, incluyendo título, descripción, severidad, estado, etiquetas y observables.

## Parámetros de Ruta

<ParamField path="id" type="string" required>
  El identificador único de la alerta a actualizar
</ParamField>

## Cuerpo de la Solicitud

<ParamField body="title" type="string">
  Nuevo título de la alerta
</ParamField>

<ParamField body="description" type="string">
  Nueva descripción de la alerta
</ParamField>

<ParamField body="severity" type="string">
  Nuevo nivel de severidad (low, medium, high, critical)
</ParamField>

<ParamField body="status" type="string">
  Nuevo estado de la alerta
</ParamField>

<ParamField body="assigned_to" type="string">
  Usuario al que se asignará la alerta
</ParamField>

<ParamField body="tags" type="array">
  Nueva lista de etiquetas
</ParamField>

<ParamField body="observables" type="array">
  Nueva lista de observables
</ParamField>

<ParamField body="custom_fields" type="object">
  Nuevos valores para campos personalizados
</ParamField>

## Respuesta

<ResponseField name="status" type="string">
  Estado de la respuesta (success o error)
</ResponseField>

<ResponseField name="data" type="object">
  Objeto con los detalles actualizados de la alerta
</ResponseField>

## Ejemplo de Solicitud

```bash theme={null}
curl -X PATCH "https://api.casebender.com/v1/alerts/alert-123" \
  -H "Authorization: Bearer su-token-jwt" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "in_progress",
    "severity": "critical",
    "assigned_to": "ana.garcia@empresa.com",
    "tags": ["suspicious", "login", "escalated"],
    "custom_fields": {
      "impacto_estimado": "Alto",
      "requiere_escalamiento": true
    }
  }'
```

## Ejemplo de Respuesta

```json theme={null}
{
  "status": "success",
  "data": {
    "id": "alert-123",
    "title": "Actividad sospechosa detectada",
    "description": "Se detectó un intento de inicio de sesión desde una ubicación inusual",
    "severity": "critical",
    "status": "in_progress",
    "source": "auth_service",
    "created_at": "2023-01-15T08:30:00Z",
    "updated_at": "2023-01-15T09:45:00Z",
    "assigned_to": "ana.garcia@empresa.com",
    "tags": ["suspicious", "login", "escalated"],
    "observables": [
      {
        "type": "ip",
        "value": "192.168.1.1"
      },
      {
        "type": "user",
        "value": "john.doe@example.com"
      }
    ],
    "custom_fields": {
      "impacto_estimado": "Alto",
      "sistema_afectado": "Sistema de Autenticación",
      "requiere_escalamiento": true
    }
  }
}
```

## Códigos de Estado

<ResponseExample>
  200 - OK - La alerta se actualizó con éxito 400 - Bad Request - Datos de
  solicitud inválidos 401 - Unauthorized - Token de autenticación faltante o
  inválido 403 - Forbidden - No tiene permiso para actualizar esta alerta 404 -
  Not Found - Alerta no encontrada 422 - Unprocessable Entity - Datos de
  solicitud válidos pero inaceptables 500 - Internal Server Error - Error del
  servidor
</ResponseExample>

## Notas

* Solo es necesario incluir los campos que desea actualizar
* Los campos no incluidos en la solicitud mantendrán sus valores actuales
* Para actualizar múltiples alertas a la vez, utilice el endpoint [Actualización Masiva de Alertas](/es/api-reference/endpoint/alert/update-bulk)
* Para obtener los detalles completos de una alerta, utilice el endpoint [Obtener Alerta por ID](/es/api-reference/endpoint/alert/get-by-id)