User Tasks
List user tasks
Lists user tasks — the account 'To-dos' inbox. Filter by assigned_to_me, completed, object_name (tasks linked to an object), or people_ids/team_ids. Each task includes assignees and the linked object record (if any). Requires a USER API key. Distinct from object-row tasks (/objects/{object}/rows/{rowId}/tasks) and from Max tasks.
get/public/v1/tasks
Query parameters
assigned_to_me'true' | 'false'
Only tasks assigned to the calling user.
Example:true
completed'true' | 'false'
Filter by completion state.
Example:false
object_namestring
Only tasks linked to this object.
Example:companies
people_idsstring
CSV of People record IDs linked to the task.
Example:12,15
team_idsstring
CSV of team IDs the task is shared with.
Example:3
Response
A list of tasks
Example response
{
"results": [
{
"id": 101,
"content": "Email David Booth about Q3 renewal",
"due_date": "2026-06-25T00:00:00Z",
"created_at": "2026-06-01T12:00:00Z",
"updated_at": "2026-06-01T12:00:00Z",
"created_by": {
"id": 42,
"name": "Alvaro Vargas",
"email": "alvaro@example.com"
},
"completed_by": {
"id": 42,
"name": "Alvaro Vargas",
"email": "alvaro@example.com"
},
"assignees": [
{
"id": 42,
"name": "Alvaro Vargas",
"email": "alvaro@example.com"
}
],
"related": {
"object_name": "companies",
"object_label": "Companies",
"row_id": "abc123"
}
}
]
}