List tasks for a connection or user

get

https://example.com/v1/tasks

Use this after locating a connection to determine its open work or who it is waiting on. Pass the connection public ID as forCompanyPublicId; omit it only when intentionally listing tasks across connections or for a user. This endpoint returns one side per request; call once with counterparty=false and once with counterparty=true to retrieve both sides.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

forUserEmail

string

Email of target user

forCompanyPublicId

string

graphiteConnect publicId of target company

completed

boolean

Include completed tasks with tasks

counterparty

boolean

Select which side's tasks to return. False returns the authenticated entity's tasks; true returns the connected counterparty's tasks. This does not include both sides.

includePending

boolean

Include pending tasks with tasks

includeAssignedUsers

boolean

Include assigned user info with tasks

includeDeleted

boolean

Include deleted tasks. The deleted flag will be set to true for these tasks.

connectionRole

string

enum

ConnectionRole to fetch tasks for

Allowed:

connectionPhases

string

Comma separeted list of connection phases to fetch tasks for.

kitId

string

ID of the associated kit

kitType

string

Only return tasks tied to kits of this type

limit

number

Limit number of tasks returned. Defaults 1000

page

number

Page number of tasks to return, used in conjunction with limit. Defaults 0

since

date-time

Earliest date to return tasks from.

includeAdvanceConnectionHistoryTasks

boolean

required

Response

200