leads

leads.update

Edit a lead's fields, including its status. Org-scoped, so an API key can reach it.

Dispatched to leads.update on POST /mcp/mutate. This route is a different URL for the same call: the request is answered by the same dispatcher, with the same authentication, the same scope check, the same organisation scoping and the same refusals.

  • Scope: write
  • A free sandbox key may call it
  • MCP tools that wrap the same function: selda_update_lead
  • Filled in from your API key, never sent by you: orgId
patch/v1/leads/{leadId}

Request

  • Base URL: https://api.selda.ai
  • URL: https://api.selda.ai/v1/leads/{leadId}
  • Auth: HTTP bearer

Path parameters

leadIdstring required

A Convex document id in the leads table.

Request body

notesstring
appendNoteboolean

Add notes to what is already there instead of replacing it. Default false, because that is what this fn has always done over HTTP and a silent change of meaning would rewrite an integration's behaviour without it asking. The MCP tool selda_update_lead passes true unless told otherwise: its own description says "notes to add", and an integration writing a timeline one line at a time was getting a field with one line in it. A timeline that overwrites itself is not a timeline.

tagsstring[]
statusstring
analysisstring

THE ANALYSIS IS CORRECTABLE, because a wrong fact in it is not cosmetic. add_lead writes providedResearch and nothing could edit it, so an analysis pushed with a false claim, "the price is not shown", when the prices were right there, was permanent, and it is the text Selda writes the message FROM. The wrong fact would have reached the customer with no way to stop it short of deleting the lead.

campaignIdstring
firstNamestring
lastNamestring
emailstring
jobTitlestring
companyDescriptionstring
citystring
countrystring
locationstring
fitScorenumber
outreachAnglestring
externalUrlstring
customFieldsunknown
companyWebsitestring
companyDomainstring nullable
dealValueEurnumber nullable

What it is worth, in EUR. null clears a wrong figure.

Response

The call succeeded.

valueunknown required
request_idstring required

Echoed in the X-Request-Id header.

Changes

No recorded changes to this operation across all 1 revision of this API.