SubscribersProperties

April 13, 2026 ยท View on GitHub

Overview

Available Operations

updateOnlineStatus

Update the subscriber online status by its unique key identifier subscriberId

Example Usage

package hello.world;

import co.novu.Novu;
import co.novu.models.components.UpdateSubscriberOnlineFlagRequestDto;
import co.novu.models.errors.ErrorDto;
import co.novu.models.errors.ValidationErrorDto;
import co.novu.models.operations.SubscribersV1ControllerUpdateSubscriberOnlineFlagResponse;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws ErrorDto, ValidationErrorDto, Exception {

        Novu sdk = Novu.builder()
                .secretKey("YOUR_SECRET_KEY_HERE")
            .build();

        SubscribersV1ControllerUpdateSubscriberOnlineFlagResponse res = sdk.subscribersProperties().updateOnlineStatus()
                .subscriberId("<id>")
                .body(UpdateSubscriberOnlineFlagRequestDto.builder()
                    .isOnline(false)
                    .build())
                .call();

        if (res.subscriberResponseDto().isPresent()) {
            System.out.println(res.subscriberResponseDto().get());
        }
    }
}

Parameters

ParameterTypeRequiredDescription
subscriberIdString:heavy_check_mark:N/A
idempotencyKeyOptional<String>:heavy_minus_sign:A header for idempotency purposes
bodyUpdateSubscriberOnlineFlagRequestDto:heavy_check_mark:N/A

Response

SubscribersV1ControllerUpdateSubscriberOnlineFlagResponse

Errors

Error TypeStatus CodeContent Type
models/errors/ErrorDto414application/json
models/errors/ErrorDto400, 401, 403, 404, 405, 409, 413, 415application/json
models/errors/ValidationErrorDto422application/json
models/errors/ErrorDto500application/json
models/errors/APIException4XX, 5XX*/*