---
title: "Incident Management aktivieren"
description: "Schaltet Incident Management für deine Organisation ein. Idempotent: ein weiterer Aufruf bei aktivierter Organisation ändert nichts."
---

`POST /api/im/activate`

Schaltet Incident Management für deine Organisation ein. Solange das nicht geschehen ist, antwortet jeder andere Endpunkt dieser API mit `403` und `imNotEnabled`; dieser hier (und der [Einrichtungsstand](/de/api/incident-management/setup)) ist absichtlich schon vor der Aktivierung erreichbar.

Die Aktivierung ist idempotent. Bei einer bereits aktivierten Organisation liefert sie `alreadyEnabled: true` und ändert nichts. Bei der ersten Aktivierung führt Uptimeify zusätzlich seine Aktivierungs-Hooks aus, zum Beispiel die Übernahme offener Monitoring-Incidents in Incident Management, wenn die Monitoring-Brücke eingeschaltet ist. Schlägt ein Hook fehl, bleibt die Aktivierung trotzdem bestehen; sein Name steht dann in `hookErrors`.

## Authentifizierung

Erfordert eine IM-berechtigte Rolle und **Schreibrechte an der Organisation**: die Rolle `admin` dieser Organisation oder einen organisationsweiten API-Token, den ein Organisations-Admin erstellt hat. `editor` und `responder` erhalten `403` (`forbidden`).

## Query-Parameter

| Parameter | Typ | Pflicht | Beschreibung |
|-----------|-----|---------|--------------|
| `organizationId` | number | Nein | Die zu aktivierende Organisation. Standard ist deine eigene. Eine andere Organisation zu nennen, gelingt nur Plattform-Administratoren. |

## Beispiel (cURL)

```bash
curl -X POST "$BASE_URL/api/im/activate" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"
```

## Antwort (Response)

Erste Aktivierung:

```json
{
  "organizationId": 42,
  "enabled": true,
  "monitoringBridge": true,
  "alreadyEnabled": false,
  "hookErrors": []
}
```

Bereits aktiviert:

```json
{
  "organizationId": 42,
  "enabled": true,
  "monitoringBridge": true,
  "alreadyEnabled": true
}
```

| Feld | Beschreibung |
|------|--------------|
| `monitoringBridge` | Ob Incidents aus Uptimeifys eigenem Monitoring in Incident Management übernommen werden. Änderbar in den [Organisationseinstellungen](/de/api/incident-management/org-settings). |
| `hookErrors` | Namen der fehlgeschlagenen Aktivierungs-Hooks. Leer bei Erfolg. Nur bei der ersten Aktivierung vorhanden. |

## Häufige Fehler

- `400 Bad Request` (`organizationIdRequired`) wenn sich keine Organisation bestimmen lässt
- `401 Unauthorized` wenn du nicht authentifiziert bist
- `403 Forbidden` (`customerScopedTokenForbidden`) bei Verwendung eines kunden-gescopten Tokens
- `403 Forbidden` (`imAccessDenied`) wenn keine IM-berechtigte Rolle vorliegt
- `403 Forbidden` (`forbidden`) wenn du kein Admin der Organisation bist