Tasks

List tasks

List the tasks the caller can see, newest first by default. A task on a project is visible to the people who can see that project; any other task is visible to everyone in the organization. Filter by status, assignee, due date, the record a task is about, title, and when tasks were created or updated. Each task includes the caller's own reminder for it.

get/tasks

Request

  • Base URL
    https://api.parley.so/v1
  • URL
    https://api.parley.so/v1/tasks
  • Auth
    HTTP bearer

Query parameters

searchstring

Case-insensitive. Every word must match the title or a text custom field.

statusesstring[]

Only tasks whose status is one of these.

assigneeIdstring

Only tasks assigned to the user with this ID.

dueSincestring date

Only tasks due on or after this day, as YYYY-MM-DD.

dueBeforestring date

Only tasks due before this day, as YYYY-MM-DD.

projectIdstring

Only tasks about this project.

accountIdstring

Only tasks about this account.

contactIdstring

Only tasks about this contact.

createdSincestring

Only records created at or after this time. An ISO 8601 date (YYYY-MM-DD, read as UTC midnight) or date-time.

createdBeforestring

Only records created before this time. An ISO 8601 date (YYYY-MM-DD, read as UTC midnight) or date-time.

updatedSincestring

Only records last updated at or after this time. An ISO 8601 date (YYYY-MM-DD, read as UTC midnight) or date-time.

updatedBeforestring

Only records last updated before this time. An ISO 8601 date (YYYY-MM-DD, read as UTC midnight) or date-time.

sort'title' | '-title' | 'createdAt' | '-createdAt' | 'updatedAt' | '-updatedAt'

Sort order: a field name, prefixed with - for descending. Defaults to -createdAt.

cursorstring

Opaque cursor from nextCursor. Pass the same filters and sort. Omit for the first page.

limitinteger

Maximum number of items to return.

Response

OK

nextCursorstring nullable required

Cursor for the next page, or null on the last page.

Changes

No recorded changes to this operation across all 2 revisions of this API.