# Lebenszyklus

Die Lebenszyklus-Endpunkte verschieben eine Journey zwischen verschiedenen Zuständen. Übergeben Sie die [Journey ID](/de/developer/api-reference/api-identifiers/#journey-id) der Journey als `uuid` im Anfrage-Body. Der Aufruf gibt das aktualisierte [Journey-Objekt](/de/developer/api-reference/customer-journey-api/journey-object/) zurück.

Eine Journey befindet sich immer in einem dieser Zustände:

| Status | Bedeutung |
|---|---|
| `STATUS_DRAFT` | Wird bearbeitet. Verarbeitet keine Benutzer. |
| `STATUS_RUNNING` | Aktiv, verarbeitet Benutzer. |
| `STATUS_PAUSED` | Vorübergehend angehalten, kann fortgesetzt werden. |
| `STATUS_FINISHED` | Abgeschlossen, verarbeitet keine Benutzer mehr. |
| `STATUS_ARCHIVED` | Zur Speicherung archiviert. |

## Endpunkte

Alle Lebenszyklus-Aufrufe verwenden denselben Anfrage-Body: Die [Journey ID](/de/developer/api-reference/api-identifiers/#journey-id) wird als `uuid` übergeben. Sie unterscheiden sich nur im Pfad:

| Aktion | Methode & Pfad | Resultierender Zustand |
|---|---|---|
| Starten | `POST /api/v3/journeygateway/start` | `STATUS_RUNNING` |
| Pausieren | `POST /api/v3/journeygateway/pause` | `STATUS_PAUSED` |
| Beenden | `POST /api/v3/journeygateway/finish` | `STATUS_FINISHED` |
| Entwerfen | `POST /api/v3/journeygateway/draft` | `STATUS_DRAFT` |
| Archivieren | `POST /api/v3/journeygateway/archive` | `STATUS_ARCHIVED` |

## Anfrage

| Feld | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
| `uuid` | Ja | string | [Journey ID](/de/developer/api-reference/api-identifiers/#journey-id) der zu übertragenden Journey. |

```json title="Body"
{ "uuid": "11111111-2222-3333-4444-555555555555" }
```

Die API validiert den aktuellen Zustand vor dem Übergang. Zum Beispiel gibt das Starten einer bereits beendeten Journey oder das Pausieren einer nicht laufenden Journey einen Fehler zurück.

<Aside type="note">
Um eine Journey zu starten **und** ausstehende Änderungen in einem Aufruf anzuwenden, verwenden Sie [Aktualisieren und fortsetzen](/de/developer/api-reference/customer-journey-api/create-update/#update-and-resume) anstelle von `start`.
</Aside>

### Anfragebeispiele

#### Eine Journey starten

```bash
curl -X POST https://journey.pushwoosh.com/api/v3/journeygateway/start \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "uuid": "11111111-2222-3333-4444-555555555555" }'
```

#### Eine Journey pausieren

```bash
curl -X POST https://journey.pushwoosh.com/api/v3/journeygateway/pause \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "uuid": "11111111-2222-3333-4444-555555555555" }'
```

## Antwort

Gibt das aktualisierte [Journey-Objekt](/de/developer/api-reference/customer-journey-api/journey-object/) zurück: `info`, `points` und `comments`. Das Feld `info.status` spiegelt den neuen Zustand wider.

### Antwortbeispiel
```json
{
  "info": {
    "uuid": "11111111-2222-3333-4444-555555555555",
    "title": "Welcome series",
    "status": "STATUS_RUNNING",
    "created_at": "2026-05-01T09:00:00Z",
    "updated_at": "2026-06-17T12:00:00Z",
    "params": { "application_code": "XXXXX-XXXXX" },
    "campaign_type": "TriggerBased"
  },
  "points": [],
  "comments": []
}
```

Die vollständige Liste der Felder finden Sie in der [Referenz zum Journey-Objekt](/de/developer/api-reference/customer-journey-api/journey-object/).

## Verwandte Themen

<CardGrid>
  <LinkCard title="Erstellen und aktualisieren" href="/developer/api-reference/customer-journey-api/create-update/" />
  <LinkCard title="Start per API" href="/developer/api-reference/customer-journey-api/start-by-api/" />
  <LinkCard title="Journey-Objekt" href="/developer/api-reference/customer-journey-api/journey-object/" />
</CardGrid>