For Agents
Clean and validate inbound records against rules with a single POST call. Useful for ETL hygiene, lead deduplication, and pre-database validation in data pipelines.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Cleansify API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Cleansify API.
Clean and normalise inbound records through POST /clean
Validate records against a configured rule set via POST /validate
Return structured change reports alongside cleaned payloads
Process both single records and batches in a single request
GET STARTED
Use for: I need to clean a batch of leads before importing into the CRM, Validate a customer record against our data rules, Check whether the imported CSV passes validation, Run normalisation on inbound form submissions
Not supported: Does not handle email-specific deliverability scoring, address geocoding, or company firmographic enrichment — use for generic record cleaning and rule-based validation only.
Cleansify is a data cleaning and validation service exposed through a small, focused REST API. The API accepts records and either runs them through cleaning logic that normalises and corrects values, or validates them against a configured rule set. Both operations return the cleaned or validated payload along with structured information about what changed or what failed validation. It is designed to slot into ETL pipelines, lead-capture flows, or any workflow that needs deterministic data hygiene before persistence.
Authenticate per-request with an API key in the Authorization header
Patterns agents use Cleansify API for, with concrete tasks.
★ Lead capture cleansing before CRM ingestion
Marketing forms collect noisy data — extra whitespace, mixed-case emails, malformed phone numbers — that pollutes the CRM if pushed in raw. POST /clean normalises the record so the CRM sees a canonical version, and POST /validate flags records that should be rejected before insert. This pattern keeps duplicate detection accurate and reduces support tickets caused by bad contact data.
On every form webhook, call POST /clean with the submitted record and only forward the cleaned response to HubSpot if POST /validate returns no rule failures
ETL pipeline pre-load validation
Batch ETL jobs that ingest CSV or warehouse extracts use POST /validate as a gate step before loading into the warehouse. Records that fail are quarantined for manual review while passing records continue down the pipeline. This prevents bad data from entering the warehouse in the first place and shifts data quality left.
For each row in the nightly extract, call POST /validate and write failed rows to the quarantine S3 bucket while passing rows continue to the warehouse load step
AI agent integration via Jentic
An ops agent built on Jentic can clean a record on demand when a user pastes data into chat. The agent searches Jentic for the cleansing operation, loads the schema, and executes against POST /clean — returning a tidy version to the user. Because the API key is held in the Jentic vault, multiple users can call the agent without each having their own credential.
Receive a CSV row pasted in chat, search Jentic for 'clean a data record', and execute POST /clean to return the normalised version
2 endpoints — cleansify is a data cleaning and validation service exposed through a small, focused rest api.
METHOD
PATH
DESCRIPTION
/clean
Clean and validate input data
/validate
Validate data against configured rules
/clean
Clean and validate input data
/validate
Validate data against configured rules
Three things that make agents converge on Jentic-routed access.
Credential isolation
Cleansify API keys are stored encrypted in the Jentic vault. Agents call /clean and /validate through Jentic without ever holding the raw Authorization header value, which matters when running shared cleansing pipelines across teams.
Intent-based discovery
Agents query Jentic with intents like 'clean a record' or 'validate data against rules' and Jentic returns the matching Cleansify operation with its input schema, removing the need to read the docs for a 2-endpoint API.
Time to first call
Direct Cleansify integration: a few hours for auth, error handling, and pipeline wiring. Through Jentic: under 15 minutes — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Cleansify API through Jentic.
What authentication does the Cleansify API use?
Cleansify uses an API key passed in the Authorization header (the spec declares an apiKey scheme named 'Authorization' in the header). Through Jentic, the key is stored in the encrypted vault and applied at execution time, so agents never hold the raw key.
What is the difference between POST /clean and POST /validate?
POST /clean returns a normalised version of the input, with structured information about what was changed. POST /validate runs the input through a configured rule set and returns whether each record passes or fails along with the failing rules. Use /clean when you want corrected output and /validate when you want a pass/fail gate.
Can the Cleansify API process records in batches?
Yes — both POST /clean and POST /validate accept batched payloads, so a single request can cover a window of records rather than one row per call. This is the practical pattern for ETL gating where round-trip latency matters.
How do I add Cleansify as a step in my ETL through Jentic?
Install the SDK with pip install jentic, search Jentic for 'validate data records', load the returned schema, and call POST /validate at the gate stage of your pipeline. Failed records can then be routed to quarantine while passing rows continue downstream.
Does Cleansify expose validation rule configuration through the API?
The published OpenAPI surface covers only /clean and /validate operations; rule configuration is managed in the Cleansify dashboard rather than via API. Agents call /validate against the rule set already configured for the account.