leads

5 operation(s). All run through POST /syteops/v1/manage/dispatch (reads may use the documented GET form).

delete

Permanently delete a lead and its events.

🔴 Destructive — requires confirm: true.
Capability: manage_options

Parameters

Parameter	Type	Required	Description
id	integer	yes
confirm	boolean	no

Returns

data: {id, deleted: true}

Request

{
  "resource": "leads",
  "action": "delete",
  "params": {
    "id": 0,
    "confirm": true
  },
  "confirm": true
}

export

Export the lead ledger as structured rows (optionally since a datetime).

Capability: manage_options

Parameters

Parameter	Type	Required	Description
since	string	no

Returns

data: {rows[], count}

Request

{
  "resource": "leads",
  "action": "export",
  "params": {
    "since": "string"
  }
}

get

Get one lead with attribution, event timeline, and chain status.

Capability: manage_options

Parameters

Parameter	Type	Required	Description
id	integer	yes

Returns

data: {id,ref,attribution,events[],chain:{ok,count,broken_at}}

Request

{
  "resource": "leads",
  "action": "get",
  "params": {
    "id": 0
  }
}

list

List captured leads (paginated; filter by source/since).

Capability: manage_options

Parameters

Parameter	Type	Required	Description
per_page	integer	no
page	integer	no
source	string	no
since	string	no

Returns

data: {items[]: {id,ref,source,campaign,status,event_count,first_seen}, total, page, per_page}

Request

{
  "resource": "leads",
  "action": "list",
  "params": {
    "per_page": 0,
    "page": 0,
    "source": "string",
    "since": "string"
  }
}

verify

Verify the tamper-evident integrity chain for a lead.

Capability: manage_options

Parameters

Parameter	Type	Required	Description
id	integer	yes

Returns

data: {id, chain:{ok,count,broken_at}}

Request

{
  "resource": "leads",
  "action": "verify",
  "params": {
    "id": 0
  }
}