tasks

List tasks

List tasks by status or assignee, newest first, with a cursor for the next page. Narrow with filter, for example filter: ['owner_actor_id:eq:act_...', 'expected_close_date:isNotNull'] and sort: '-expected_close_date'; get_crm_schema lists the fields each type accepts.

get/v1/tasks

Request

  • Base URL: https://api.indraft.io
  • URL: https://api.indraft.io/v1/tasks
  • Auth: HTTP bearer

Query parameters

limitinteger

How many to return. The page bound is published in the schema call, and asking for more is refused rather than quietly truncated.

cursorstring

The opaque marker from the previous page. Store it and hand it back; do not parse it. A cursor is only ever emitted when another row really exists, so a page you were given is never empty.

updatedSincestring

Only rows changed after this instant. The incremental read: without it a service syncing a large workspace has to walk all of it every time.

status'open' | 'done' | 'cancelled'

Only records with this status. Status is derived from the stage's kind rather than set separately, so a deal cannot be open and won at once.

assigneeActorIdstring

Only tasks assigned to this actor. The actor id comes back on every change and in the schema call for the caller themselves.

string
OR
string[]
string
OR
string[]
sortstring

A field to order by, with a leading minus for descending. Indexed fields only, for the same reason as filter.

Response

Success

nextCursorstring required

Hand this back to get the next page, or null when there is no next page. Null is the end of the list and an empty items is not: a cursor is only emitted when another row really exists.

requestIdstring required

Changes

No recorded changes to this operation across all 1 revision of this API.