Skip to content

List All Tasks

GET
/tasks

List all tasks org-wide with optional filters.

The backend list is unpaginated; limit/offset bound the response here (same approach as the MCP g8_get_tasks tool) so an org with many tasks can’t return an unbounded payload. Ordering is deterministic (due_date asc nulls-last, then created_at desc), so paging is stable.

Authorizations

Parameters

Query Parameters

status
Any of:
string

Filter by status (open, completed)

priority
Any of:
integer
<= 4

Filter by priority

assignee_id
Any of:
string

Filter by assignee user ID

created_by
Any of:
string

Filter by creator (email or user ID)

task_type
Any of:
string

Filter by task type (call, email, meeting, …)

entity_type
Any of:
string

Filter by linked entity type (contact, company, deal, team_member)

entity_id
Any of:
string

Filter by linked entity ID (pair with entity_type)

source_meeting_id
Any of:
integer

Filter to tasks from a specific meeting

search
Any of:
string

Search by task title

limit

Max tasks to return (default 100, max 200)

integer
default: 100 >= 1 <= 200

Max tasks to return (default 100, max 200)

offset

Number of tasks to skip

integer

Number of tasks to skip

Header Parameters

X-Target-Org-Id
Any of:
string

Responses

200

Successful Response

object
data
required
Array<object>
object
assignee_id
Any of:
string
assignee_name
Any of:
string
completed_subtask_count
Any of:
integer
created_at
Any of:
string
created_by
Any of:
string
description
Any of:
string
due_date
Any of:
string
entity_id
Any of:
string
entity_label
Any of:
string
entity_type
Any of:
string
execution_id
Any of:
string
executor_agent_id
Any of:
string
executor_agent_name
Any of:
string
executor_type
string
default: human
Allowed values: human agent
id
required
string
links
Array<object>
object
key
additional properties
any
parent_task_id
Any of:
string
priority
Any of:
integer
reminder_at
Any of:
string
reminder_sent_at
Any of:
string
source_external_id
Any of:
string
source_meeting_id
Any of:
integer
source_meeting_start_time
Any of:
string
source_meeting_title
Any of:
string
source_transcript_id
Any of:
string
source_url
Any of:
string
status
Any of:
string
subtask_count
Any of:
integer
subtask_sort_order
Any of:
integer
tags
Array<string>
task_type
Any of:
string
title
required
string
updated_at
Any of:
string
visibility
Any of:
string
pagination
Any of:
object
has_next
required

Whether there are more pages

boolean
limit
required

Items per page

integer
next_cursor
Any of:
string
page
required

Current page number (1-indexed)

integer
total
required

Total number of items

integer

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string