Skip to main content

LeadTaskSaveDTO

Lead task save (or update if id is provided) request body.

idint64

Lead task ID. Omit for create; provide to update.

Example: 501
textstring

Task description

Example: Call the client
leadTaskTypeIdint64required

Task type ID (required)

Example: 7
assignedByIdint32required

Assignee employee ID (required)

Example: 95
deadlineStartTimestampint64required

Task deadline start (epoch seconds, required, min 1)

Possible values: >= 1

Example: 1730419200
deadlineFinishTimestampint64required

Task deadline finish (epoch seconds, required, min 1)

Possible values: >= 1

Example: 1733011200
fields object[]nullable

Custom field values, full-replace semantics: any field not present in this list has its existing value cleared (uysot-v2's AbstractCustomFieldValueService.saveAll). Send the entire list on every save — including on update — not just the changed field. Omitting fields, or sending an empty array, clears all existing values.

  • Array [
    • fieldIdint64required

    Lead task custom field ID this value belongs to. Always required.

    Example: 91
    valuestringnullable

    Single-valued types (TEXT, SELECT, DATE, ADDRESS — as a uuid, LOCATION — as JSON).

    Example: Phone
    valuesstring[]nullable

    Multi-valued types (MULTI_SELECT, EMPLOYEE) — a write-time convenience, one entry per selected value.

    numberdoublenullable

    For type: NUMBER.

    currencyIdint32nullable

    For type: NUMBER when numberFormat: CURRENCY — required in that case.

    fileIdint32nullable

    For type: FILE — the ID of an already-uploaded file.

  • ]
    • LeadTaskSaveDTO
    {
      "id": 501,
      "text": "Call the client",
      "leadTaskTypeId": 7,
      "assignedById": 95,
      "deadlineStartTimestamp": 1730419200,
      "deadlineFinishTimestamp": 1733011200,
      "fields": [
        {
          "fieldId": 91,
          "value": "Phone",
          "values": [
            "string"
          ],
          "number": 0,
          "currencyId": 0,
          "fileId": 0
        }
      ]
    }