Schedule a task
Book one or more people on a task for a time slot.
POST https://cotlet.dev/api/v1/aroflo/tasks/{task_id}/schedule
write Confirm
Adds one schedule to the task with each resource and the times, and returns its schedule_id. It does not check availability or clashes. The people you schedule are the ones who do the work, which is different from the person the task is assigned to. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| task_id string required | string | Task ID from list_tasks. |
| resources string[] required | string[] | Names of the users to schedule. |
| start string required | string | Start, YYYY-MM-DDTHH:MM, local time. |
| finish string | string | Finish, YYYY-MM-DDTHH:MM, local time. |
| note string | string | Note for the schedule. |
Request
curl -X POST https://cotlet.dev/api/v1/aroflo/tasks/task_8814/schedule \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"resources":["Sam Rowe"],"start":"2026-10-30T09:00","finish":"2026-10-30T11:00","note":"Bring a contactor kit"}'result = client.call("aroflo", "schedule_task", {"task_id":"task_8814","resources":["Sam Rowe"],"start":"2026-10-30T09:00","finish":"2026-10-30T11:00","note":"Bring a contactor kit"})const result = await cotlet.call('aroflo', 'schedule_task', {"task_id":"task_8814","resources":["Sam Rowe"],"start":"2026-10-30T09:00","finish":"2026-10-30T11:00","note":"Bring a contactor kit"});cotlet call aroflo schedule_task --data '{"task_id":"task_8814","resources":["Sam Rowe"],"start":"2026-10-30T09:00","finish":"2026-10-30T11:00","note":"Bring a contactor kit"}'Example response
{
"task_id": "task_8814",
"job_number": "J1187",
"schedule_id": "sched_5532",
"resources": [
"Sam Rowe"
],
"start": "2026-10-30T09:00",
"finish": "2026-10-30T11:00",
"task_status": "Not Started"
}