List tasks

GET

/v1/tasks

• Production

Cursor-paginated CRM tasks. Requires scope tasks:read.

Authorizations

• bearerAuth

Parameters

Query Parameters

after

integer

limit

integer

default: 25 >= 1 <= 100

status

string

Allowed values: open inprogress done

priority

string

Allowed values: low medium high

overdue

boolean

contactId

integer

dealId

integer

Responses

200

Paginated task list.

object

items

Array<object>

object

id

integer

title

string

description

string

nullable

contactId

integer

nullable

contactName

string

nullable

dealId

integer

nullable

dealTitle

string

nullable

priority

string

Allowed values: Low Medium High

status

string

Allowed values: Open InProgress Done

dueAt

string format: date-time

nullable

completedAt

string format: date-time

nullable

isOverdue

boolean

createdAt

string format: date-time

updatedAt

string format: date-time

nullable

nextCursor

integer

nullable

hasMore

boolean

401

Missing or invalid bearer token.

Standard error envelope for all v1 error responses.

object

error

Machine-readable error code.

string

Allowed values: bad_request not_found conflict unauthorized forbidden rate_limited internal_error

message

Human-readable explanation of the error.

string

details

Optional structured context (field-level validation errors, etc.).

nullable

Example

{
  "error": "unauthorized",
  "message": "Invalid bearer principal"
}

403

The API key does not have the required scope for this operation.

Standard error envelope for all v1 error responses.

object

error

Machine-readable error code.

string

Allowed values: bad_request not_found conflict unauthorized forbidden rate_limited internal_error

message

Human-readable explanation of the error.

string

details

Optional structured context (field-level validation errors, etc.).

nullable

Example

{
  "error": "forbidden",
  "message": "scope contacts:write is required"
}