API ReferenceLead FinderDelete saved companies
DELETE/v2/campaigns/lead-finder/saved-companies

Delete saved companies

Removes saved companies from one list. A company can belong to several lists at once, so this only strips that list's label — the record itself is only deleted once it has no lists left. Free — no credit was ever refunded for a save, this just removes the record.

Stablescope: write API KeyLearn about API scopes →

Request

AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

Parameters

FieldTypeRequiredDescription
companyIdsstring[]Required1–100 company IDs.
labelstringRequiredList name to remove these companies from.
curl -X DELETE "https://api.stynar.com/v2/campaigns/lead-finder/saved-companies" \
  -H "Authorization: Bearer esk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"companyIds":["cmp_prs_9f8e7d"],"label":"Sourced Leads"}'

Response

✓ 200 OK
200 response
{
  "deleted": 1
}

Response fields

Errors

StatusCodeMeaning
✕ 401 UnauthorizedUNAUTHORIZEDMissing, malformed, unknown, revoked, or expired key.
✕ 403 ForbiddenAPI_ACCESS_DISABLEDAPI access is turned off for your account.
✕ 403 ForbiddenINSUFFICIENT_SCOPEThe key doesn't have the scope this endpoint requires.
✕ 404 Not FoundNOT_FOUNDUnknown route, or a resource that doesn't exist / isn't yours.
✕ 409 ConflictCONFLICTThe action can't be applied to the resource's current state.
✕ 429 Too Many RequestsRATE_LIMIT_EXCEEDEDPer-minute or per-second limit hit.
✕ 429 Too Many RequestsQUOTA_EXCEEDEDMonthly quota exhausted.
✕ 500 Internal Server ErrorINTERNAL_ERRORSomething broke on Stynar's end.
Full error reference →