Re-enrich a lead
Re-enrich a lead, or fix one step of it.
POST/api/v1/leads/{id}/refresh
Parameters
Path
| Name | In | Description |
|---|---|---|
idrequired | path | The record's id. |
Body
A JSON object. Fields not listed are ignored.
| Name | In | Description |
|---|---|---|
profile_tier | body | none, cheap or full. |
verify | body, boolean | Verify the email again. |
only | body, array | Run only these steps and keep the rest: verify, linkedin, posts, research, phone, intelligence. |
failed | body, boolean | Run only the steps the lead's enrichment note says failed; a lead with nothing failed is skipped. |
email_source | body | apollo (default, MoltSets then LeadOcean as the fallback), moltsets (MoltSets looks the email up; Apollo only for a phone) or leadocean (one LeadOcean record carries the email and the mobile number; Apollo is not asked). One of apollo, moltsets, leadocean. |
models | body, object | Model per AI step: { company_profile, research, lead_intelligence }. |
phone | body, boolean | Ask for the phone number. |
posts | body, boolean | Read recent posts. |
research | body, boolean | Research the company. |
Example
curl
curl -X POST "https://crm.ashwanth.dev/api/v1/leads/{id}/refresh" \
-H "Authorization: Bearer $SALES_ENGINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"profile_tier": "",
"verify": false,
"only": [],
"failed": false,
"email_source": "apollo",
"models": {},
"phone": false,
"posts": false,
"research": false
}'CLI
sales-engine leads refresh <id>The JSON above lists every documented field with a typed placeholder; send only the ones you mean.
Response
A 200 with the result under data, on creation too. Errors come back as an error object with a stable code; see Errors.
Shape
{
"data": { ... }
}Run it below to see the live shape for your workspace.
Try it
Runs against this server, as the workspace behind the key. Kept in this page while you browse the docs, gone on reload, never stored. Signed in to the app? Leave it blank and the call runs as you.
Path
requiredThe record's id.
Every documented field is listed above; leave out the ones you do not need.
Request
POST /api/v1/leads/%7Bid%7D/refresh
Fill the path first.