Milestones & Lists

message

string · required

Success message

Remove Milestone

DELETE

https://openapi.niftypm.com

/api/v1.0/milestones/{milestone_id}

This endpoint removes the milestone.

Remove Milestone › path Parameters

milestone_id

string · required

Milestone ID

Remove Milestone › Responses

Success Response

MoveToProjectMilestoneDto

message

string · required

Success message

Move Milestone

PUT

https://openapi.niftypm.com

/api/v1.0/milestones/{milestone_id}/move_to_project

This endpoint moves the milestone to the project.

Move Milestone › path Parameters

milestone_id

string · required

Milestone ID

Move Milestone › Request Body

project_id

string · required

Project ID

Move Milestone › Responses

Success Response

message

string · required

Success message

Tie Task To Milestone

PUT

https://openapi.niftypm.com

/api/v1.0/milestones/{milestone_id}/tasks

This endpoint adds the list of tasks to the milestone.

Tie Task To Milestone › path Parameters

milestone_id

string · required

Milestone ID

Tie Task To Milestone › Request Body

tasks

string[] · required

List of Tasks ID

Tie Task To Milestone › Responses

Success Response

message

string · required

Success message

tasks

string[] · required

List of tasks

Remove Milestone Task

DELETE

https://openapi.niftypm.com

/api/v1.0/milestones/{milestone_id}/tasks

This endpoint removes the list of task from the milestone.

Remove Milestone Task › path Parameters

milestone_id

string · required

Milestone ID

Remove Milestone Task › Request Body

tasks

string[] · required

List of Tasks ID

Remove Milestone Task › Responses

Success Response

message

string · required

Success message

tasks

string[] · required

List of tasks

Archive Milestone

POST

https://openapi.niftypm.com

/api/v1.0/milestones/{milestone_id}/archive

This endpoint archives the milestone details.

Archive Milestone › path Parameters

milestone_id

string · required

Milestone ID

Archive Milestone › Request Body

UpdateStatus

archived

boolean · required

Archived

tasks

boolean

Task Flag

Archive Milestone › Responses

message

string · required

Success message

Messages Projects

Nifty API v1.0

Milestones & Lists

Get Milestones

GET

https://openapi.niftypm.com

/api/v1.0/milestones

This endpoint fetch the list of milestones.

Get Milestones › query Parameters

project_id

string · required

Project ID

limit

string

No of records per page

Example: 25

offset

string

Record Offset

Example: 0

sort

string · enum

Sorting order, default is descending

Enum values:

ascending

descending

is_list

string

List Flag

Get Milestones › Responses

Success Response

GetMilestonesReponse

hasMore

boolean · required

True if there are more record else false

Default: false

MilestoneShortView[] · required

List of Label records

GET/api/v1.0/milestones

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

Example Responses

{
  "hasMore": false,
  "items": [
    {
      "id": "id",
      "name": "name",
      "created_at": "2024-08-25T15:00:00Z",
      "created_by": "created_by",
      "description": "description",
      "dependency": "dependency",
      "start": "2024-08-25T15:00:00Z",
      "end": "2024-08-25T15:00:00Z",
      "archived": "archived",
      "project": "project",
      "task_group": "task_group",
      "rule": "rule",
      "tasks": [
        "string"
      ],
      "hidden": [
        "string"
      ],
      "fields": [
        {
          "id": "id",
          "value": "value"
        }
      ],
      "statistic": {
        "total": 0,
        "completed": 0,
        "overdue": 0,
        "total_story_points": 0,
        "completed_story_points": 0
      },
      "order": 0,
      "color": "color",
      "is_list": true,
      "assignees": [
        "string"
      ]
    }
  ]
}

json

application/json

Create Milestone

POST

https://openapi.niftypm.com

/api/v1.0/milestones

This endpoint creates the milestone.

Create Milestone › Request Body

CreateMilestone

project_id

string · required

Project ID

name

string · required

Milestone name

description

string · required

Milestone Description

task_group_id

string

Task Group ID

dependency

string

Milestone dependency

start

string

Milestone start date

end

string

Milestone end date

rule_id

string

Milestone rule id

hidden

string[]

Hidden

isTaskGroup

boolean

Is Task Group?

is_list

boolean

List Flag

Create Milestone › Responses

The resource created successfully

MilestoneReponse

message

string · required

Success message

id

string · required

Created Label ID

POST/api/v1.0/milestones

curl https://openapi.niftypm.com/api/v1.0/milestones \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "project_id": "project_id",
  "task_group_id": "task_group_id",
  "name": "name",
  "description": "description",
  "dependency": "dependency",
  "start": "start",
  "end": "end",
  "rule_id": "rule_id",
  "hidden": [
    "string"
  ],
  "isTaskGroup": true,
  "is_list": true
}'

Example Request Body

{
  "project_id": "project_id",
  "task_group_id": "task_group_id",
  "name": "name",
  "description": "description",
  "dependency": "dependency",
  "start": "start",
  "end": "end",
  "rule_id": "rule_id",
  "hidden": [
    "string"
  ],
  "isTaskGroup": true,
  "is_list": true
}

json

Example Responses

{
  "message": "message",
  "id": "id"
}

json

application/json

Get Milestone

GET

https://openapi.niftypm.com

/api/v1.0/milestones/{milestone_id}

This endpoint fetch the milestone information.

Get Milestone › path Parameters

milestone_id

string · required

Milestone ID

Get Milestone › Responses

Success Response

MilestoneShortView

id

string · required

Milestone ID

name

string · required

Milestone Name

created_at

string · date-time · required

Creation Date

created_by

string · required

Operation message

description

string · required

Description

dependency

string · required

Dependencies

start

string · date-time · required

Start Date

end

string · date-time · required

End Date

archived

string · required

achived

project

string · required

Project

task_group

string · required

Task Group

rule

string · required

Rules

tasks

string[] · required

List of Tasks

hidden

string[] · required

hidden

AttachedCustomFieldResponse[] · required

TasksStatistic · required

order

number · required

Order

color

string · required

Color

is_list

boolean · required

List Flag

assignees

string[] · required

Assignee to List

GET/api/v1.0/milestones/{milestone_id}

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

Example Responses

{
  "id": "id",
  "name": "name",
  "created_at": "2024-08-25T15:00:00Z",
  "created_by": "created_by",
  "description": "description",
  "dependency": "dependency",
  "start": "2024-08-25T15:00:00Z",
  "end": "2024-08-25T15:00:00Z",
  "archived": "archived",
  "project": "project",
  "task_group": "task_group",
  "rule": "rule",
  "tasks": [
    "string"
  ],
  "hidden": [
    "string"
  ],
  "fields": [
    {
      "id": "id",
      "value": "value"
    }
  ],
  "statistic": {
    "total": 0,
    "completed": 0,
    "overdue": 0,
    "total_story_points": 0,
    "completed_story_points": 0
  },
  "order": 0,
  "color": "color",
  "is_list": true,
  "assignees": [
    "string"
  ]
}

json

application/json

Update Milestone

PUT

https://openapi.niftypm.com

/api/v1.0/milestones/{milestone_id}

This endpoint updates the milestone details.

Update Milestone › path Parameters

milestone_id

string · required

Milestone ID

Update Milestone › Request Body

UpdateMilestoneDto

name

string

Milestone name

description

string

Milestone description

dependency

string

Milestone dependencies

start

string

Milestone start date

end

string

Milestone end date

rollup

string

Milestone rollup

is_list

boolean

List Flag

Update Milestone › Responses

Success Response

message

string · required

Success message

Remove Milestone

DELETE

https://openapi.niftypm.com

/api/v1.0/milestones/{milestone_id}

This endpoint removes the milestone.

Remove Milestone › path Parameters

milestone_id

string · required

Milestone ID

Remove Milestone › Responses

Success Response

MoveToProjectMilestoneDto

message

string · required

Success message

Move Milestone

PUT

https://openapi.niftypm.com

/api/v1.0/milestones/{milestone_id}/move_to_project

This endpoint moves the milestone to the project.

Move Milestone › path Parameters

milestone_id

string · required

Milestone ID

Move Milestone › Request Body

project_id

string · required

Project ID

Move Milestone › Responses

Success Response

message

string · required

Success message

Tie Task To Milestone

PUT

https://openapi.niftypm.com

/api/v1.0/milestones/{milestone_id}/tasks

This endpoint adds the list of tasks to the milestone.

Tie Task To Milestone › path Parameters

milestone_id

string · required

Milestone ID

Tie Task To Milestone › Request Body

tasks

string[] · required

List of Tasks ID

Tie Task To Milestone › Responses

Success Response

message

string · required

Success message

tasks

string[] · required

List of tasks

Remove Milestone Task

DELETE

https://openapi.niftypm.com

/api/v1.0/milestones/{milestone_id}/tasks

This endpoint removes the list of task from the milestone.

Remove Milestone Task › path Parameters

milestone_id

string · required

Milestone ID

Remove Milestone Task › Request Body

tasks

string[] · required

List of Tasks ID

Remove Milestone Task › Responses

Success Response

message

string · required

Success message

tasks

string[] · required

List of tasks

Archive Milestone

POST

https://openapi.niftypm.com

/api/v1.0/milestones/{milestone_id}/archive

This endpoint archives the milestone details.

Archive Milestone › path Parameters

milestone_id

string · required

Milestone ID

Archive Milestone › Request Body

UpdateStatus

archived

boolean · required

Archived

tasks

boolean

Task Flag

Archive Milestone › Responses