# Ciclo de vida

Los endpoints de ciclo de vida mueven un journey entre estados. Pase el [ID del Journey](/es/developer/api-reference/api-identifiers/#journey-id) del journey como `uuid` en el cuerpo de la solicitud. La llamada devuelve el [objeto de journey](/es/developer/api-reference/customer-journey-api/journey-object/) actualizado.

Un journey siempre está en uno de estos estados:

| Estado | Significado |
|---|---|
| `STATUS_DRAFT` | Siendo editado. No procesa usuarios. |
| `STATUS_RUNNING` | Activo, procesando usuarios. |
| `STATUS_PAUSED` | Detenido temporalmente, se puede reanudar. |
| `STATUS_FINISHED` | Completado, ya no procesa usuarios. |
| `STATUS_ARCHIVED` | Archivado para almacenamiento. |

## Endpoints

Todas las llamadas de ciclo de vida utilizan el mismo cuerpo de solicitud: [ID del Journey](/es/developer/api-reference/api-identifiers/#journey-id) pasado como `uuid`. Solo difieren en la ruta:

| Acción | Método y ruta | Estado resultante |
|---|---|---|
| Iniciar | `POST /api/v3/journeygateway/start` | `STATUS_RUNNING` |
| Pausar | `POST /api/v3/journeygateway/pause` | `STATUS_PAUSED` |
| Finalizar | `POST /api/v3/journeygateway/finish` | `STATUS_FINISHED` |
| Borrador | `POST /api/v3/journeygateway/draft` | `STATUS_DRAFT` |
| Archivar | `POST /api/v3/journeygateway/archive` | `STATUS_ARCHIVED` |

## Solicitud

| Campo | Requerido | Tipo | Descripción |
|---|---|---|---|
| `uuid` | Sí | string | [ID del Journey](/es/developer/api-reference/api-identifiers/#journey-id) del journey a transicionar. |

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

La API valida el estado actual antes de la transición. Por ejemplo, iniciar un journey que ya está finalizado, o pausar uno que no está en ejecución, devuelve un error.

<Aside type="note">
Para iniciar un journey **y** aplicar las ediciones pendientes en una sola llamada, utilice [Actualizar y reanudar](/es/developer/api-reference/customer-journey-api/create-update/#update-and-resume) en lugar de `start`.
</Aside>

### Ejemplos de solicitud

#### Iniciar un journey

```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" }'
```

#### Pausar un journey

```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" }'
```

## Respuesta

Devuelve el [objeto de journey](/es/developer/api-reference/customer-journey-api/journey-object/) actualizado: `info`, `points` y `comments`. El campo `info.status` refleja el nuevo estado.

### Ejemplo de respuesta
```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": []
}
```

Consulte la [referencia del objeto de journey](/es/developer/api-reference/customer-journey-api/journey-object/) para ver la lista completa de campos.

## Relacionado

<CardGrid>
  <LinkCard title="Crear y actualizar" href="/developer/api-reference/customer-journey-api/create-update/" />
  <LinkCard title="Iniciar por API" href="/developer/api-reference/customer-journey-api/start-by-api/" />
  <LinkCard title="Objeto de journey" href="/developer/api-reference/customer-journey-api/journey-object/" />
</CardGrid>