Update Task

Modifies aspects of an existing task including assignment, scheduling, and status.

PATCH /tasks

Update Task

cURL

curl --request PATCH \
  --url https://api.lemlist.com/api/tasks \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "opp_0Ieq2qRMg5EIeUMFV"
}
'

200

{
  "_id": "opp_KNQOrrlGnLvEXDDS9",
  "type": "manual",
  "title": "Check him out",
  "priority": 2,
  "dueDate": "2025-10-31T07:58:00.000Z",
  "userId": "usr_ahfFktBBHUIxbVG5P",
  "content": "Really glad we started using lemlist"
}

Updatable Fields

All fields are optional except id:

• Assignment: Change the assigned team member with assignedTo
• Schedule: Update the dueDate
• Details: Modify title or message content
• Priority: Set priority level (0=low, 1=medium, 2=high, ""=none)
• Status: Mark as complete with done: true
• LinkedIn media (LinkedIn tasks only): Replace attached files via images and videos. Pass an empty array to clear them. See the LinkedIn task attachments section on Create Task for size, MIME, and count limits

Passing images or videos to a non-LinkedIn task returns 400 with LINKEDIN_MEDIA_INVALID_TYPE.

Examples:

mark as done

{
    "id": "opp_abc123",
    "done": true
}

Authorizations

Authorization · string · header · required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

id · string · required

The unique identifier of the task to update

assignedTo · string

The ID of the team member to assign the task to (userId)

dueDate · string<date-time>

Updated due date in ISO 8601 format

title · string

Updated task title

message · string

Updated task message/description

priority · enum<string>

Priority level of the task

Available options: , 0, 1, 2

done · boolean

Mark task as completed

images · string<uri>[]

Public HTTPS URLs of images to attach to a LinkedIn task. Replaces the task's current images — pass an empty array to clear them. Returns 400 (LINKEDIN_MEDIA_INVALID_TYPE) when the target task is not a LinkedIn task. Allowed MIME types: image/png, image/jpeg, image/gif. Up to 20 MB per file, and up to 6 items total combined with videos.

videos · string<uri>[]

Public HTTPS URLs of videos to attach to a LinkedIn task. Replaces the task's current videos — pass an empty array to clear them. Returns 400 (LINKEDIN_MEDIA_INVALID_TYPE) when the target task is not a LinkedIn task. Allowed MIME types: video/mp4, video/quicktime. Up to 20 MB per file, and up to 6 items total combined with images.

Response

200

application/json

Success

A manual action assigned to a user to complete.

_id · string

Unique task identifier

type · string

Task type

leadId · string

Associated lead ID

campaignId · string

Campaign ID

userId · string

Assigned user ID

status · enum<string>

Task status

Available options: pending, completed, ignored

dueDate · string<date-time>

Due date timestamp

createdAt · string<date-time>

Creation timestamp

completedAt · string<date-time>

Completion timestamp