Tasks

Download schema

The unit of work. Subtasks are tasks with a parent.

Get Tasks

GET

https://openapi.niftypm.com

/api/v1.0/tasks

Bearer (JWT)

This endpoint fetch the list of tasks for the team member.

Get Tasks › query Parameters

project_id

string

Project ID

task_group_id

string

Task Group ID

task_id

string

Task ID

member_id

string

Member ID

meeting_id

string

Meeting ID

milestone_id

string

Milestone ID

completed_by

string

Completed By

archived

string

Archived

include_archived

string

Include Archived

completed

string

Completed

limit

string

Page size. There is no server maximum; keep it at or below 100.

Example: 25

Default: 25

offset

string

Record Offset

Example: 0

order

string

Sort field and direction, colon-separated: dueDate:ASC, dueDate:DESC, archivedOn:DESC, completedOn:DESC. When order is set, sort is ignored.

Example: dueDate:DESC

from

string

Start of the due-date window. Both from and to must be sent for the filter to apply; ISO 8601, UTC.

to

string

End of the due-date window. Both from and to must be sent for the filter to apply; ISO 8601, UTC.

archived_from

string

Start of the archived-on window. Both archived_from and archived_to must be sent for the filter to apply; ISO 8601, UTC.

archived_to

string

End of the archived-on window. Both archived_from and archived_to must be sent for the filter to apply; ISO 8601, UTC.

completed_from

string

Start of the completed-on window. Both completed_from and completed_to must be sent for the filter to apply; ISO 8601, UTC.

completed_to

string

End of the completed-on window. Both completed_from and completed_to must be sent for the filter to apply; ISO 8601, UTC.

include_subtasks

boolean

Include Subtask

sort

string · enum

Sorting order, default is ascending. Ignored when order is present.

Enum values:

ascending

descending

Get Tasks › Responses

Success Response

GetTasksResponse

TaskResponse[] · required

List of all tasks

hasMore

boolean · required

True when the page was full (tasks.length === limit); a full final page also reports true — request the next page to confirm.

Default: false

GET/api/v1.0/tasks

curl https://openapi.niftypm.com/api/v1.0/tasks \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "tasks": [
    {
      "id": "Kx8vQ2mT1",
      "nice_id": "142",
      "name": "Draft the Q4 board deck",
      "description": "Pull the revenue chart from the finance sheet first.",
      "order": 300,
      "created_at": "2026-09-01T10:12:44.128Z",
      "created_by": "i5vtiganU9y25V",
      "archived": false,
      "completed": false,
      "due_date": "2026-09-11T17:00:00.000Z",
      "start_date": "2026-09-07T09:00:00.000Z",
      "reminder": null,
      "task_group": "Tg4pQw9Zx",
      "task": null,
      "project": "Pq4nZt7Rm",
      "milestone": "Ms2kLp8Vd",
      "assignees": [
        "i5vtiganU9y25V"
      ],
      "subscribers": [
        "i5vtiganU9y25V"
      ],
      "labels": [
        "Lb6yTn3Qw"
      ],
      "linked_tasks": [],
      "documents": [],
      "attachments": [],
      "fields": [],
      "hidden": [],
      "total_subtasks": 3,
      "completed_subtasks": 1,
      "comments": 2,
      "story_points": 5,
      "tracked_time": 5400,
      "project_archived": false,
      "meeting_ids": [],
      "related_commits": [],
      "related_prs": []
    }
  ],
  "hasMore": false
}

json

application/json

Create Task

POST

https://openapi.niftypm.com

/api/v1.0/tasks

Bearer (JWT)

This endpoint creates the task for the team member.

Create Task › Request Body

CreateTaskBody

name

string · required

Name

task_group_id

string · required

Task Group ID

description

string

Description

order

number

Order

task_id

string

Task Id. This field is mandatory only when we want to create this task as subtask of other task.

milestone_id

string

Milestone ID

rule_id

string

Rule ID

annotation_id

string

Annotation ID

due_date

string

Due Date

start_date

string

Start Date

assignees

string[]

List of Assignees

labels

string[]

List of labels

meeting_ids

string[]

List of meeting ID

embed_url

string

Embed URL

banner

string

Banner

CreateTaskFieldBody[]

Task Field Body

story_points

number

Story Points

object

Task this one is blocked by, referenced by id.

Create Task › Responses

The resource created successfully

TaskResponse

id

string · required

nice_id

string · required

Nice ID

name

string · required

Name

description

string · required

Description

order

number · required

Order

created_at

string · date-time · required

Created Date

created_by

string · required

Created By

archived

boolean · required

Archived Flag

completed

boolean · required

Completed Flag

completed_on

string · date-time · required

Completed Date

completed_by

string · required

Completed By

due_date

string · date-time · required

Due Date

reminder

string · date-time · required

Reminder Date

task_group

string · required

Task Group

task

string · required

Task

project

string · required

Project ID

milestone

string · required

Milestone

assignees

string[] · required

Assignees

linked_tasks

string[] · required

Linked Tasks

subscribers

string[] · required

Subscribers

labels

string[] · required

Labels

AttachedCustomFieldResponse[] · required

Attached custom fields

total_subtasks

number · required

Total Number of subtasks

completed_subtasks

number · required

Number of completed tasks

comments

number · required

Numbers of comments

FileChildResponse[] · required

Files

documents

string[] · required

List of Documents

banner

string · required

Banner

hidden

string[] · required

hidden

dependency

string · required

Dependencies

repeat_cron

string · required

Repeat Cron

repeat_trigger

string · required

Repeat Trigger

embed_url

string · required

Embedded URL

repeat_till

string · date-time · required

Repeat Until

rule

string · required

Rule ID

story_points

number · required

Story Points

related_commits

string[] · required

RelatedPR · required

archived_on

string · date-time · required

Archived Date

tracked_time

number · required

Tracked Time

start_date

string · date-time · required

Start Date

project_archived

boolean · required

Project Archived

meeting_ids

string[] · required

Meeting IDs

POST/api/v1.0/tasks

curl https://openapi.niftypm.com/api/v1.0/tasks \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "name": "name",
  "description": "description",
  "order": 0,
  "task_group_id": "task_group_id",
  "task_id": "task_id",
  "milestone_id": "milestone_id",
  "rule_id": "rule_id",
  "annotation_id": "annotation_id",
  "due_date": "due_date",
  "start_date": "start_date",
  "assignees": [
    "string"
  ],
  "labels": [
    "string"
  ],
  "meeting_ids": [
    "string"
  ],
  "embed_url": "embed_url",
  "banner": "banner",
  "fields": [
    {
      "id": "id",
      "value": "value"
    }
  ],
  "story_points": 0,
  "dependency": {
    "id": "Kx8vQ2mT1"
  }
}'

Example Request Body

{
  "name": "name",
  "description": "description",
  "order": 0,
  "task_group_id": "task_group_id",
  "task_id": "task_id",
  "milestone_id": "milestone_id",
  "rule_id": "rule_id",
  "annotation_id": "annotation_id",
  "due_date": "due_date",
  "start_date": "start_date",
  "assignees": [
    "string"
  ],
  "labels": [
    "string"
  ],
  "meeting_ids": [
    "string"
  ],
  "embed_url": "embed_url",
  "banner": "banner",
  "fields": [
    {
      "id": "id",
      "value": "value"
    }
  ],
  "story_points": 0,
  "dependency": {
    "id": "Kx8vQ2mT1"
  }
}

json

Example Responses

{
  "id": "Kx8vQ2mT1",
  "nice_id": "142",
  "name": "Draft the Q4 board deck",
  "description": "Pull the revenue chart from the finance sheet first.",
  "order": 300,
  "created_at": "2026-09-01T10:12:44.128Z",
  "created_by": "i5vtiganU9y25V",
  "archived": false,
  "completed": false,
  "due_date": "2026-09-11T17:00:00.000Z",
  "start_date": "2026-09-07T09:00:00.000Z",
  "reminder": null,
  "task_group": "Tg4pQw9Zx",
  "task": null,
  "project": "Pq4nZt7Rm",
  "milestone": "Ms2kLp8Vd",
  "assignees": [
    "i5vtiganU9y25V"
  ],
  "subscribers": [
    "i5vtiganU9y25V"
  ],
  "labels": [
    "Lb6yTn3Qw"
  ],
  "linked_tasks": [],
  "documents": [],
  "attachments": [],
  "fields": [],
  "hidden": [],
  "total_subtasks": 3,
  "completed_subtasks": 1,
  "comments": 2,
  "story_points": 5,
  "tracked_time": 5400,
  "project_archived": false,
  "meeting_ids": [],
  "related_commits": [],
  "related_prs": []
}

json

application/json

Remove Tasks (bulk)

DELETE

https://openapi.niftypm.com

/api/v1.0/tasks

Bearer (JWT)

This endpoint removes the task.

Remove Tasks (bulk) › Request Body

RemoveTasks

project_id

string

Project ID

task_ids

string[]

List of Task ID

Remove Tasks (bulk) › Responses

The record has been updated successfully.

UpdateTaskResponse

message

string · required

Success message

Get Personal Tasks

GET

https://openapi.niftypm.com

/api/v1.0/tasks/personal

Bearer (JWT)

This endpoint fetch the list of personal tasks for the team member.

Get Personal Tasks › query Parameters

limit

string · required

No of records per page

Example: 25

offset

string

Record Offset

Example: 0

meeting_id

string

Meeting ID

completed

boolean

Completed?

Get Personal Tasks › Responses

Success Response

GetTasksResponse

TaskResponse[] · required

List of all tasks

hasMore

boolean · required

True when the page was full (tasks.length === limit); a full final page also reports true — request the next page to confirm.

Default: false

GET/api/v1.0/tasks/personal

curl 'https://openapi.niftypm.com/api/v1.0/tasks/personal?limit=<string>' \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "tasks": [
    {
      "id": "id",
      "nice_id": "nice_id",
      "name": "name",
      "description": "description",
      "order": 0,
      "created_at": "2024-08-25T15:00:00Z",
      "created_by": "created_by",
      "archived": true,
      "completed": true,
      "completed_on": "2024-08-25T15:00:00Z",
      "completed_by": "completed_by",
      "due_date": "2024-08-25T15:00:00Z",
      "reminder": "2024-08-25T15:00:00Z",
      "task_group": "task_group",
      "task": "task",
      "project": "project",
      "milestone": "milestone",
      "assignees": [
        "string"
      ],
      "linked_tasks": [
        "string"
      ],
      "subscribers": [
        "string"
      ],
      "labels": [
        "string"
      ],
      "fields": [
        {
          "id": "id",
          "value": "value"
        }
      ],
      "total_subtasks": 0,
      "completed_subtasks": 0,
      "comments": 0,
      "attachments": [
        {
          "id": "id",
          "name": "name",
          "size": 0,
          "url": "url",
          "download": "download",
          "thumbnail": "thumbnail",
          "uploader": "uploader",
          "comments": 0,
          "created_at": "2024-08-25T15:00:00Z",
          "googleId": "googleId",
          "googleType": "googleType",
          "processed": true
        }
      ],
      "documents": [
        "string"
      ],
      "banner": "banner",
      "hidden": [
        "string"
      ],
      "dependency": "dependency",
      "repeat_cron": "repeat_cron",
      "repeat_trigger": "repeat_trigger",
      "embed_url": "embed_url",
      "repeat_till": "2024-08-25T15:00:00Z",
      "rule": "rule",
      "story_points": 0,
      "related_commits": [
        "string"
      ],
      "related_prs": {
        "number": "number",
        "title": "title",
        "url": "url",
        "status": "status"
      },
      "archived_on": "2024-08-25T15:00:00Z",
      "tracked_time": 0,
      "start_date": "2024-08-25T15:00:00Z",
      "project_archived": true,
      "meeting_ids": [
        "string"
      ]
    }
  ],
  "hasMore": false
}

json

application/json

Create Personal Task

POST

https://openapi.niftypm.com

/api/v1.0/tasks/personal

Bearer (JWT)

This endpoint creates a personal task for the team member.

Create Personal Task › Request Body

GetPersonalTasksDto

limit

string · required

No of records per page

Example: 25

offset

string

Record Offset

Example: 0

meeting_id

string

Meeting ID

completed

boolean

Completed?

Create Personal Task › Responses

The resource created successfully

PersonalTaskResponse

id

string · required

Task id.

Example: PtQ7bK2wR

niceId

number · required

Per-creator sequence number for personal tasks; the highest existing value plus one.

Example: 12

name

string · required

Task name.

Example: Draft Q4 board deck

description

string · required

Task description; Nifty Markdown.

Example: Pull the revenue chart from the finance sheet first.

order

number · required

Rank among the creator's personal tasks. Assigned as the midpoint between neighbours, or 100 for the first task.

Example: 100

personal

boolean · required

Always true on this endpoint — personal tasks belong to no project.

Example: true

startDate

string · date-time · required

Start date, or null when none was sent (ISO 8601, UTC).

Example: 2026-09-07T09:00:00.000Z

dueDate

string · date-time · required

Due date, or null when none was sent (ISO 8601, UTC).

Example: 2026-09-11T17:00:00.000Z

createdAt

string · date-time · required

Creation timestamp (ISO 8601, UTC).

Example: 2026-09-04T11:48:02.317Z

updatedAt

string · date-time · required

Last modification timestamp (ISO 8601, UTC).

Example: 2026-09-04T11:48:02.317Z

object · required

The team member who created the task.

object · required

Parent task when the request carried task_id, making this a subtask; null otherwise.

object · required

Recurring rule that produced the task when the request carried rule_id; null otherwise.

assignees

string[] · required

Always empty on the create response — assignees are cleared before the task is returned.

Example: []

hiddenFor

string[] · required

Roles the task is hidden from. Always empty for a personal task.

Example: []

meeting_ids

string[] · required

Meeting ids sent on the request, when any.

Example: []

POST/api/v1.0/tasks/personal

curl https://openapi.niftypm.com/api/v1.0/tasks/personal \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "limit": "25",
  "offset": "0",
  "meeting_id": "meeting_id",
  "completed": true
}'

Example Request Body

{
  "limit": "25",
  "offset": "0",
  "meeting_id": "meeting_id",
  "completed": true
}

json

Example Responses

{
  "id": "PtQ7bK2wR",
  "niceId": 12,
  "name": "Draft Q4 board deck",
  "description": "Pull the revenue chart from the finance sheet first.",
  "order": 100,
  "personal": true,
  "startDate": "2026-09-07T09:00:00.000Z",
  "dueDate": "2026-09-11T17:00:00.000Z",
  "createdAt": "2026-09-04T11:48:02.317Z",
  "updatedAt": "2026-09-04T11:48:02.317Z",
  "createdBy": {
    "id": "i5vtiganU9y25V"
  },
  "parentTask": {
    "id": "i5vtiganU9y25V"
  },
  "rule": {
    "id": "i5vtiganU9y25V"
  },
  "assignees": [],
  "hiddenFor": [],
  "meeting_ids": []
}

json

application/json

Get Task

GET

https://openapi.niftypm.com

/api/v1.0/tasks/{task_id}

Bearer (JWT)

This endpoint fetch the task details for the team member.

Get Task › path Parameters

task_id

string · required

Enter task id

Get Task › Responses

Success Response

TaskResponse

id

string · required

nice_id

string · required

Nice ID

name

string · required

Name

description

string · required

Description

order

number · required

Order

created_at

string · date-time · required

Created Date

created_by

string · required

Created By

archived

boolean · required

Archived Flag

completed

boolean · required

Completed Flag

completed_on

string · date-time · required

Completed Date

completed_by

string · required

Completed By

due_date

string · date-time · required

Due Date

reminder

string · date-time · required

Reminder Date

task_group

string · required

Task Group

task

string · required

Task

project

string · required

Project ID

milestone

string · required

Milestone

assignees

string[] · required

Assignees

linked_tasks

string[] · required

Linked Tasks

subscribers

string[] · required

Subscribers

labels

string[] · required

Labels

AttachedCustomFieldResponse[] · required

Attached custom fields

total_subtasks

number · required

Total Number of subtasks

completed_subtasks

number · required

Number of completed tasks

comments

number · required

Numbers of comments

FileChildResponse[] · required

Files

documents

string[] · required

List of Documents

banner

string · required

Banner

hidden

string[] · required

hidden

dependency

string · required

Dependencies

repeat_cron

string · required

Repeat Cron

repeat_trigger

string · required

Repeat Trigger

embed_url

string · required

Embedded URL

repeat_till

string · date-time · required

Repeat Until

rule

string · required

Rule ID

story_points

number · required

Story Points

related_commits

string[] · required

RelatedPR · required

archived_on

string · date-time · required

Archived Date

tracked_time

number · required

Tracked Time

start_date

string · date-time · required

Start Date

project_archived

boolean · required

Project Archived

meeting_ids

string[] · required

Meeting IDs

GET/api/v1.0/tasks/{task_id}

curl https://openapi.niftypm.com/api/v1.0/tasks/:task_id \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": "Kx8vQ2mT1",
  "nice_id": "142",
  "name": "Draft the Q4 board deck",
  "description": "Pull the revenue chart from the finance sheet first.",
  "order": 300,
  "created_at": "2026-09-01T10:12:44.128Z",
  "created_by": "i5vtiganU9y25V",
  "archived": false,
  "completed": false,
  "due_date": "2026-09-11T17:00:00.000Z",
  "start_date": "2026-09-07T09:00:00.000Z",
  "reminder": null,
  "task_group": "Tg4pQw9Zx",
  "task": null,
  "project": "Pq4nZt7Rm",
  "milestone": "Ms2kLp8Vd",
  "assignees": [
    "i5vtiganU9y25V"
  ],
  "subscribers": [
    "i5vtiganU9y25V"
  ],
  "labels": [
    "Lb6yTn3Qw"
  ],
  "linked_tasks": [],
  "documents": [],
  "attachments": [],
  "fields": [],
  "hidden": [],
  "total_subtasks": 3,
  "completed_subtasks": 1,
  "comments": 2,
  "story_points": 5,
  "tracked_time": 5400,
  "project_archived": false,
  "meeting_ids": [],
  "related_commits": [],
  "related_prs": []
}

json

application/json

Update Task

PUT

https://openapi.niftypm.com

/api/v1.0/tasks/{task_id}

Bearer (JWT)

This endpoint update the task details.

Update Task › path Parameters

task_id

string · required

Enter task id

Update Task › Responses

Success Response

UpdateTaskResponse

message

string · required

Success message

Remove Task

DELETE

https://openapi.niftypm.com

/api/v1.0/tasks/{task_id}

Bearer (JWT)

This endpoint removes the task details.

Remove Task › path Parameters

Enter task id

Reorder Task › Request Body

MoveTaskNew

object · required

task_order

string

Task Order

next_task

string

Next Task

prev_task

string

Previous Task

Reorder Task › Responses

The resource created successfully

CompletedTaskResponse

message

string · required

Success message

Assign Task

PUT

https://openapi.niftypm.com

/api/v1.0/tasks/{task_id}/assignees

Bearer (JWT)

This endpoint adds assignee to the task.

Assign Task › path Parameters

task_id

string · required

Enter task id

Assign Task › Request Body

AssigneesBody

assignees

string[] · required

List of Assignees

Assign Task › Responses

Success Response

CompletedTaskResponse

message

string · required

Success message

Remove Assignee

DELETE

https://openapi.niftypm.com

/api/v1.0/tasks/{task_id}/assignees

Bearer (JWT)

This endpoint removes the assignee to the task.

Remove Assignee › path Parameters

task_id

string · required

Enter task id

Remove Assignee › Request Body

AssigneesBody

assignees

string[] · required

List of Assignees

Remove Assignee › Responses

The record has been updated successfully.

CompletedTaskResponse

message

string · required

Success message

Add Labels

PUT

https://openapi.niftypm.com

/api/v1.0/tasks/{task_id}/labels

Bearer (JWT)

This endpoint adds the labels to the task.

Add Labels › path Parameters

task_id

string · required

Enter task id

Add Labels › Request Body

UpdateLabels

labels

string[] · required

Labels

Add Labels › Responses

Success Response

AddLabelsToTaskResponse

message

string · required

labels

string[] · required

Remove Labels

DELETE

https://openapi.niftypm.com

/api/v1.0/tasks/{task_id}/labels

Bearer (JWT)

This endpoint removes the labels from the task.

Remove Labels › path Parameters

task_id

string · required

Enter task id

Remove Labels › Request Body

UpdateLabels

labels

string[] · required

Labels

Remove Labels › Responses

The record has been updated successfully.

AddLabelsToTaskResponse

message

string · required

labels

string[] · required

Get Fields

GET

https://openapi.niftypm.com

/api/v1.0/tasks/{task_id}/fields

Bearer (JWT)

This endpoint fetch the custom field of the task.

Get Fields › path Parameters

task_id

string · required

Enter task id

Get Fields › Responses

Success Response

AttachedCustomFieldResponse[]

AttachedCustomFieldResponse

id

string · required

value

string · required

Value

Add Fields

POST

https://openapi.niftypm.com

/api/v1.0/tasks/{task_id}/fields

Bearer (JWT)

This endpoint adds the custom field to the task.

Add Fields › path Parameters

task_id

string · required

Enter task id

Add Fields › Request Body

CreateCustomField

name

string · required

Custom field name

type

number · enum · required

Custom field type

Enum values:

CustomFieldOptions[] · required

roles

string[] · required

Roles

field_id

string

field_id

description

string

description

currency

string

Currency

tracking_type

number · enum

Tracking Type

Enum values:

cost_per_hour

number

Cost per hour

save

boolean

Save

association

string

Association

project_id

string

Project ID

Add Fields › Responses

The resource created successfully

No data returned

POST/api/v1.0/tasks/{task_id}/fields

curl https://openapi.niftypm.com/api/v1.0/tasks/:task_id/fields \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "field_id": "field_id",
  "name": "name",
  "description": "description",
  "type": 0,
  "currency": "currency",
  "tracking_type": 0,
  "cost_per_hour": 0,
  "options": [
    {
      "value": "value",
      "color": "color"
    }
  ],
  "roles": [
    "string"
  ],
  "save": true,
  "association": "association",
  "project_id": "project_id"
}'

Example Request Body

{
  "field_id": "field_id",
  "name": "name",
  "description": "description",
  "type": 0,
  "currency": "currency",
  "tracking_type": 0,
  "cost_per_hour": 0,
  "options": [
    {
      "value": "value",
      "color": "color"
    }
  ],
  "roles": [
    "string"
  ],
  "save": true,
  "association": "association",
  "project_id": "project_id"
}

json

Example Responses

No example specified for this content type

Update Fields

PUT

https://openapi.niftypm.com

/api/v1.0/tasks/{task_id}/fields/{field_id}

Bearer (JWT)

This endpoint updates the custom field detail of the task.

Update Fields › path Parameters

task_id

string · required

Enter task id

field_id

string · required

Update Fields › Responses

string[] · required

List of Task ID

Move Tasks to Project › Responses

The resource created successfully

No data returned

Documents

Was this page helpful?