Help Center

Lists

Lists make tasks easier to navigate and share by organizing them into groups.

You can find more information on lists in Help.

Methods

GET /lists

This Method returns all the lists that are available to the user.

GET https://api.pyrus.com/v4/lists

Response body

{
  "lists": [
    {
      "id": 1352,
      "name": "Branch offices",
      "children": [
        {
          "id": 1465,
          "name": "Moscow"
        },
        {
          "id": 3763,
          "name": "San Francisco"
        }
      ]
    },
    {
      "id": 2144,
      "name": "Personal"
    }
  ]
}

curl

curl -X GET \
  https://api.pyrus.com/v4/lists \
  -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
  -H 'Content-Type: application/json'

GET /lists/{list-id}/tasks

This method returns all the tasks in the specified list.

GET https://api.pyrus.com/v4/lists/2144/tasks
  ?item_count=100
  &include_archived=y
  &modified_before=2022-04-21T15:51:27Z
  &modified_after=2022-03-11T15:51:25Z

Response body

{
  "tasks": [
    {
      "id": 7991,
      "create_date": "2018-02-28T07:34:23Z",
      "last_modified_date": "2018-02-28T07:34:23Z",
      "author": {
        "id": 1731,
        "first_name": "Bob",
        "last_name": "Smith",
        "email": "Bob.Smith@gmail.com",
        "type": "user"
      },
      "responsible": {
        "id": 1731,
        "first_name": "Bob",
        "last_name": "Smith",
        "email": "Bob.Smith@gmail.com",
        "type": "user"
      },
      "text": "Prepare Presentation",
      "due_date": "2022-04-13"
    },
    {
      "id": 7992,
      "create_date": "2018-02-27T17:42:42Z",
      "last_modified_date": "2018-02-27T17:42:42Z",
      "author": {
        "id": 1731,
        "first_name": "Bob",
        "last_name": "Smith",
        "email": "Bob.Smith@gmail.com",
        "type": "user"
      },
      "responsible": {
        "id": 1731,
        "first_name": "Bob",
        "last_name": "Smith",
        "email": "Bob.Smith@gmail.com",
        "type": "user"
      },
      "text": "Order office supplies"
    }
  ],
  "has_more": false
}

curl

curl -X GET \
  https://api.pyrus.com/v4/lists/2144/tasks \
  -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
  -H 'Content-Type: application/json'

Parameters

item_countThe maximum number of tasks in the response, the default is 200.
include_archivedSpecify "y" if you want to include archived tasks in the response.
modified_beforeTasks modified before specified date in UTC (inclusive).Date format: YYYY-MM-DDThh:mm:ssZ
modified_afterTasks modified after specified date in UTC (inclusive).Date format: YYYY-MM-DDThh:mm:ssZ

GET /inbox

This method returns all inbox tasks.

GET https://api.pyrus.com/v4/inbox
  ?item_count=100

Response body

{
  "tasks": [
    {
      "id": 7991,
      "create_date": "2018-02-28T07:34:23Z",
      "last_modified_date": "2018-02-28T07:34:23Z",
      "author": {
        "id": 1731,
        "first_name": "Bob",
        "last_name": "Smith",
        "email": "Bob.Smith@gmail.com",
        "type": "user"
      },
      "responsible": {
        "id": 1731,
        "first_name": "Bob",
        "last_name": "Smith",
        "email": "Bob.Smith@gmail.com",
        "type": "user"
      },
      "text": "Prepare Presentation",
      "due_date": "2022-04-13"
    },
    {
      "id": 7992,
      "create_date": "2018-02-27T17:42:42Z",
      "last_modified_date": "2018-02-27T17:42:42Z",
      "author": {
        "id": 1731,
        "first_name": "Bob",
        "last_name": "Smith",
        "email": "Bob.Smith@gmail.com",
        "type": "user"
      },
      "responsible": {
        "id": 1731,
        "first_name": "Bob",
        "last_name": "Smith",
        "email": "Bob.Smith@gmail.com",
        "type": "user"
      },
      "text": "Order office supplies"
    }
  ],
  "has_more": false
}

curl

curl -X GET \
  https://api.pyrus.com/v4/inbox \
  -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
  -H 'Content-Type: application/json'

Parameters

item_countThe maximum number of tasks in the response, the default is 50.

Was this article helpful?