InsionInsion
Java

Ingest a record

Persist a record for asynchronous moderation

IngestRecordResponse result = client.ingestARecord(
    RecordInput.builder()
        .clientId("post-123")
        .name("A post")
        .entity("post")
        .content(Content.of("Hello world"))
        .build()
);

RecordInput requires clientId, name, entity, and content; clientUrl, metadata, and user are optional. The response includes the Insion record ID and, when queued, a moderation ID.

Use ingestion for workflows that receive moderation asynchronously through webhooks. Reusing a clientId updates that record.

Method signature

IngestRecordResponse ingestARecord(RecordInput request)
IngestRecordResponse ingestARecord(RecordInput request, RequestOptions options)

RecordInput uses the same required builder fields as moderation: clientId, name, entity, and content. It additionally accepts clientUrl, metadata, and user.

Check result.getId() for the Insion record ID. If result.getModeration() is present, retain that ID to correlate the later webhook event with this ingestion request.

On this page