FOfolk
Tasks

Get a task

Changed on

Retrieve an existing task in the workspace.

get/v1/tasks/{taskId}

Request

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

Path parameters

taskIdstring required

The ID of the task to get.

Response

The task that has been retrieved.

deprecationsstring[]

Example response

{
  "data": {
    "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"
  },
  "deprecations": [
    "This field is deprecated"
  ]
}

Changes