Skip to main content
Tasks

List tasks

Returns a paginated list of tasks for the authenticated company. Results are ordered by creation time (newest first).

GET
/tasks

Requires the tasks:read scope.

Authorizations

x-api-keystringheaderrequired

Company API key in the format: rotor_{keyId}_{keySecret}

To obtain an API key:

  1. Log into your Rotor dashboard
  2. Go to Settings → Integrations → API Keys
  3. Create a new key and select the scopes you need
  4. Copy the key — it's only shown once!

Query Parameters

pageintegerquerydefault:1

Page number (1-based)

Required range: 1 <= x
Example: 1
limitintegerquerydefault:50

Number of results per page (max 1000)

Required range: 1 <= x <= 1000
Example: 50
statusenum<string>query

Filter tasks by status

Available options: open, in_progress, waiting, done
priorityenum<string>query

Filter tasks by priority

Available options: low, medium, high
contact_idstringquery

Filter tasks linked to a given contact (lead or customer)

contact_typeenum<string>query

Filter tasks by linked contact type

Available options: lead, customer
assigned_tostringquery

Filter to tasks assigned to a given user ID

searchstringquery

Case-insensitive search against the task name

Headers

rotor-api-versionenum<string>headerdefault:1.1.0required

Required OpenAPI version header.

Available options: 1.1.0
Example: 1.1.0

Response

application/json

Tasks listed successfully

dataobject[]
paginationobject
statusstring
Example: success

Still need help? Ask the team