Tasks API

Endpoints

GET /tasks, list tasks
GET /tasks/{taskId}, get one task
POST /tasks, create task
PATCH /tasks/{taskId}, update task

Scopes

tasks:read for GET; tasks:write for POST and PATCH. User needs Tasks page read/create/update permission.

List tasks (GET /tasks)

limit, offset, pagination
status, filter by task status
listId, filter by task list UUID
search, match title or description (case-insensitive)
includeSubtasks, when false (default), only top-level tasks (no parent) are returned

curl "https://api.elevale.app/v1/workspaces/{workspaceId}/tasks?limit=10&search=client" \
  -H "Authorization: Bearer elv_pat_..."

Get task (GET /tasks/{taskId})

Returns full task detail including assignee (profile join), parent_id, task_id (human code), and subtaskCount.

curl "https://api.elevale.app/v1/workspaces/{workspaceId}/tasks/{taskId}" \
  -H "Authorization: Bearer elv_pat_..."

Create body (POST)

title (required), string
description (optional), string
priority (optional), low | medium | high (default medium)
dueDate (optional), YYYY-MM-DD
listId (optional), task list UUID

curl -X POST "https://api.elevale.app/v1/workspaces/{workspaceId}/tasks" \
  -H "Authorization: Bearer elv_pat_..." \
  -H "Content-Type: application/json" \
  -d '{"title":"Follow up with client","description":"Send proposal","priority":"high","dueDate":"2026-06-01"}'

Update body (PATCH)

title, description, status, priority, dueDate, at least one required