FOfolk
Tasks

List tasks

Changed on

Retrieve a paginated list of tasks in the workspace, optionally filtered by attributes.

get/v1/tasks

Request

  • Base URL
    https://api.folk.app
  • URL
    https://api.folk.app/v1/tasks
  • Auth
    HTTP bearer

Query parameters

onlyAssignedToMe'true' | 'false'

When true, restricts results to tasks assigned to the current user.

limitinteger

The number of items to return.

cursorstring

A cursor for pagination across multiple pages of results. Don’t include this parameter on the first call. Use the pagination.nextLink value returned in a previous response to request subsequent results.

combinator'and' | 'or'

The logical operator to combine multiple filters.

filterobject

A record of filters to apply, following the format filter[attribute][operator]=value. The attribute is the name of the attribute to filter on, and the operator is one of the supported filter operators. Refer to Filterable fields to learn more about the supported attributes and operators.

Response

A page of tasks in the workspace.

deprecationsstring[]

Example response

{
  "data": {
    "items": [
      {
        "id": "tsk_91118b73-5a75-480b-b8e3-a33671c35cdc",
        "title": "Follow up with John Doe",
        "description": "Discuss the Q3 proposal.",
        "entity": {
          "id": "per_55175e81-9a52-4ac3-930e-82792c23499b",
          "entityType": "person",
          "fullName": "John Doe"
        },
        "dueAt": "2025-07-17",
        "dueTime": "15:00",
        "completedAt": null,
        "recurrenceFrequency": null,
        "isPublic": true,
        "assignedUsers": [
          {
            "id": "usr_14c18444-a0c7-459a-86b0-ccd70ebcd65c",
            "fullName": "John Doe",
            "email": "john.doe@example.com"
          }
        ],
        "createdBy": {
          "id": "usr_14c18444-a0c7-459a-86b0-ccd70ebcd65c",
          "fullName": "John Doe",
          "email": "john.doe@example.com"
        },
        "createdAt": "2025-07-17T09:00:00.000Z",
        "updatedAt": "2025-07-17T09:00:00.000Z"
      }
    ],
    "pagination": {}
  },
  "deprecations": [
    "This field is deprecated"
  ]
}

Changes