Knowledge CenterAPI References

Tasks

Tasks are to-do items that can be linked to people, companies, or opportunities. Create the task first, then attach it via /rest/taskTargets.

Source:apiDocs/task.md
MethodPathDescription
POST/rest/tasksCreate a new task
GET/rest/tasks/{id}Get a task by ID
GET/rest/tasksList tasks
PATCH/rest/tasks/{id}Update a task
DELETE/rest/tasks/{id}Delete a task
POST/rest/tasks

Create a new task with a title, optional due date, and status.

Body

titlerequiredstring

Task title

bodystring

Task description or notes

dueAtstring

Due date and time (ISO 8601)

statusstring

TODO · IN_PROGRESS · DONE

assigneeIdUUID

Workspace member assigned to this task

Requestcurl
curl -X POST "https://app.usedalil.ai/rest/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Send follow-up email",
    "body": "Reference the pricing discussion from last call.",
    "dueAt": "2026-05-01T09:00:00.000Z",
    "status": "TODO",
    "assigneeId": "member-uuid"
  }'
GET/rest/tasks/{id}

Retrieve a single task by UUID.

Parameters

idrequiredUUID

Task ID

depthnumber

1 = include task targets and assignee

Requestcurl
curl -G "https://app.usedalil.ai/rest/tasks/task-uuid" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "depth=1"
GET/rest/tasks

List tasks. Filter by status or due date to build task dashboards.

Parameters

limitnumber

Records per page (default 60)

starting_afterUUID

Pagination cursor

filterstring

Filter expression URL-encode

order_bystring

e.g. dueAt[AscNullsLast]

Requestcurl
# Open tasks due this week
curl -G "https://app.usedalil.ai/rest/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "filter=status[eq]:TODO,dueAt[lte]:2026-05-07T23:59:59Z" \
  --data-urlencode "order_by=dueAt[AscNullsLast]"
PATCH/rest/tasks/{id}

Update a task. Partial updates send only the fields you want to change.

Parameters

idrequiredUUID

Task ID

Requestcurl
curl -X PATCH "https://app.usedalil.ai/rest/tasks/task-uuid" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "DONE" }'
DELETE/rest/tasks/{id}

Permanently delete a task.

Parameters

idrequiredUUID

Task ID

Requestcurl
curl -X DELETE "https://app.usedalil.ai/rest/tasks/task-uuid" \
  -H "Authorization: Bearer YOUR_API_KEY"

Linking Tasks to Records

After creating a task, link it to a record using /rest/taskTargets:

curl -X POST "https://app.usedalil.ai/rest/taskTargets" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "task-uuid",
    "personId": "person-uuid"
  }'