PATCHhttps://app.evoriqa.com/api/v1/leads/{leadId}

Update a lead's fields

Updates a lead pipeline status and/or its owner. At least one of `status`, `ownerId` is required — a body with neither is a 422 ("Nothing to update."). Omitting a key leaves that field unchanged; `ownerId: null` unassigns.

Requires scope leads:write

Access is gated — enable it before your first call

The API is off by default. A request succeeds only when all three switches are on: the platform master switch (off by default), your organisation’s API toggle, and your plan or client entitlement. Any one off returns 403 API access is not enabled for this workspace.

Parameters

Name	In	Type	Required	Default	Description
leadId	path	string uuid	Required	—	The lead's id.

Request body

Content type: application/json

Field	Type	Required	Description
status	string one of `new` · `contacted` · `qualified` · `won` · `lost`	Optional	New lead status.
ownerId	string uuid, or null	Optional	Assignee's user id, or null to unassign.

Request

curl

curl -X PATCH "https://app.evoriqa.com/api/v1/leads/{leadId}" \
  -H "x-api-key: $EVORIQA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "qualified" }'

Node.js

const res = await fetch("https://app.evoriqa.com/api/v1/leads/{leadId}", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.EVORIQA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "status": "qualified"
  }),
});

const responseBody = await res.json();

Python

import os
import requests

res = requests.patch(
    "https://app.evoriqa.com/api/v1/leads/{leadId}",
    headers={"Authorization": f"Bearer {os.environ['EVORIQA_API_KEY']}"},
    json={
      "status": "qualified"
    },
)

body = res.json()

Response

200 OK

{
  "success": true,
  "data": {
    "updated": true
  }
}