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

Exact email of target user. If only a person's name is known, first use GET /users?search=&limit=25&page=0 in the active company directory, verify the returned name/email and resolve ambiguity before passing the selected email. Do not omit this filter after a failed lookup.

forCompanyPublicId

string

graphiteConnect publicId of target company

completed

boolean

Include completed tasks with tasks

assignedToMe

boolean

Only tasks currently assigned to the authenticated caller. Use it instead of forUserEmail when the caller is a service account, which has no email.

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

Include connection-advancement and bulk-disconnection history tasks. Defaults false.

abbreviated

boolean

Opt into task IDs, titles, types, completed/state/deleted status and connection/kit IDs only. Omitting or false preserves full task details. Abbreviated pages are capped at 100; limit must be positive and page non-negative. Use GET /tasks/{taskId} for details.

Response

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200