Nifty API
  • Authentication
  • OAuth 2.1
  • v1.0 API
  • API tokens
Information
Apps
    Get AppsgetGet Appget
Authentication
    Generate TokenpostAuthorize (browser entry point)get
Chats
    Get ChatsgetGet Chatget
Documents
    Get DocumentsgetCreate documentpostGet Personal DocumentsgetCreate Personal DocumentpostGet DocumentgetUpdate DocumentputRemove DocumentdeleteMove DocumentputUpdate Document MemberputRemove Document MemberdeleteUpdate DocumentpostUpdate Document LabelsputRemove Document Labelsdelete
Custom Fields
    Get Custom fieldsgetGet Custom fieldget
Files
    Get FilesgetUpload FilespostGet FilegetUpdate FileputRemove FiledeleteCopy FilepostAdd File LabelsputRemove File Labelsdelete
Folders
    Get Folder ChildrengetAdd FolderpostGet Folderget/api/v2.0/folders/{folderId}putRemove FolderdeleteGet Folder Conntentsget
Invite
    Get Inviteeget
Tags
    Get TagsgetCreate TagpostGet TaggetUpdate TagputRemove Tagdelete
Members
    Get Members DetailsgetGet Member Detailsget
Messages
    Get MessagesgetCreate MessagepostGet MessagegetUpdate MessageputRemove MessagedeleteMark Message seenpostMark Message heardpost
Milestones & Lists
    Get MilestonesgetCreate MilestonepostGet MilestonegetUpdate MilestoneputRemove MilestonedeleteMove MilestoneputTie Task To MilestoneputRemove Milestone TaskdeleteArchive Milestonepost
Projects
    Get ProjectsgetCreate ProjectpostGet ProjectgetUpdate ProjectputRemove ProjectdeleteInvite Team Member for projectpostLeave ProjectpostStart ProjectpostGet Project Custom FieldsgetAdd Project Custom FieldspostUpdate Project Custom Fieldsput
Portfolios
    Get PortfoliosgetCreate PortfoliopostGet PortfoliogetUpdate PortfolioputRemove PortfoliodeleteUpdate Portfolio MemberputRemove Portfolio MemberdeleteLeave Portfoliopost
Tasks
    Get TasksgetCreate TaskpostRemove TaskdeleteGet Personal TasksgetCreate Personal TaskpostGet TaskgetUpdate TaskputRemove TaskdeleteUpdate Task MilestoneputComplete TaskpostArchive TaskpostMove TaskpostAssign TaskputRemove AssigneedeleteAdd LabelsputRemove LabelsdeleteGet FieldsgetAdd FieldspostUpdate FieldsputAdd DocumentputClone TaskpostMove Taskpost
Status
    Get StatusesgetCreate StatuspostGet StatusgetUpdate StatusputRemove StatusdeleteMove TaskspostAssign Status MembersputRemove Status Memberdelete
Templates
    Get Templatesget
Time Tracking
    Get Tracked Time ReportgetGet Tracked Time Durationget
Users
    Get User Detailsget
Webhook
    Get WebhooksgetCreate WebhookpostUpdate WebhookputRemove Webhookdelete
Other endpoints
    /get
Schemas
powered by Zudoku
Nifty API v1.0
Nifty API v1.0

Tags


Get Tags

GET
https://openapi.niftypm.com
/api/v1.0/labels

This endpoint fetch list of all the tag based on given query parameters.

Get Tags › query Parameters

limit
​number

No of records per page

Example: 25
offset
​number

Record Offset

Example: 0
type
​number · enum

Label Type

Enum values:
0
1

Get Tags › Responses

Success Response

GetLabelsDto
​LabelResponse[] · required

List of Label records

hasMore
​boolean

True if there are more record else false

Default: false
GET/api/v1.0/labels
curl https://openapi.niftypm.com/api/v1.0/labels \ --header 'Authorization: Bearer <token>'
Example Responses
{ "hasMore": false, "items": [ { "id": "id", "name": "name", "color": "color", "type": "type", "created_by": "created_by", "team": "team", "default": "default" } ] }
json
application/json

Create Tag

POST
https://openapi.niftypm.com
/api/v1.0/labels

This endpoint create a new tag record.

Create Tag › Request Body

LabelBody
name
​string · required

Name

color
​string · required

Color

type
​number · enum

Type

Enum values:
0
1

Create Tag › Responses

The resource created successfully

GeneralLabelResponse
message
​string · required

Success message

id
​string · required

Label Record Unique ID

POST/api/v1.0/labels
curl https://openapi.niftypm.com/api/v1.0/labels \ --request POST \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer <token>' \ --data '{ "name": "name", "color": "color", "type": 0 }'
Example Request Body
{ "name": "name", "color": "color", "type": 0 }
json
Example Responses
{ "message": "message", "id": "id" }
json
application/json

Get Tag

GET
https://openapi.niftypm.com
/api/v1.0/labels/{label_id}

This endpoint fetch the tag details using unique label_id.

Get Tag › path Parameters

label_id
​string · required

Get Tag › Responses

Success Response

LabelResponse
id
​string · required
name
​string · required
color
​string · required
type
​string · required
created_by
​string · required
team
​string · required
default
​string · required
GET/api/v1.0/labels/{label_id}
curl https://openapi.niftypm.com/api/v1.0/labels/:label_id \ --header 'Authorization: Bearer <token>'
Example Responses
{ "id": "id", "name": "name", "color": "color", "type": "type", "created_by": "created_by", "team": "team", "default": "default" }
json
application/json

Update Tag

PUT
https://openapi.niftypm.com
/api/v1.0/labels/{label_id}

This endpoint update the tag details using unique label_id.

Update Tag › path Parameters

label_id
​string · required

Update Tag › Request Body

UpdateLabelBody
name
​string · required

Name

color
​string · required

Color

Update Tag › Responses

Success Response

GeneralLabelResponse
message
​string · required

Success message

id
​string · required

Label Record Unique ID

PUT/api/v1.0/labels/{label_id}
curl https://openapi.niftypm.com/api/v1.0/labels/:label_id \ --request PUT \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer <token>' \ --data '{ "name": "name", "color": "color" }'
Example Request Body
{ "name": "name", "color": "color" }
json
Example Responses
{ "message": "message", "id": "id" }
json
application/json

Remove Tag

DELETE
https://openapi.niftypm.com
/api/v1.0/labels/{label_id}

This endpoint removes the tag using unique label_id.

Remove Tag › path Parameters

label_id
​string · required

Remove Tag › Responses

Success Response

GeneralLabelResponse
message
​string · required

Success message

id
​string · required

Label Record Unique ID

DELETE/api/v1.0/labels/{label_id}
curl https://openapi.niftypm.com/api/v1.0/labels/:label_id \ --request DELETE \ --header 'Authorization: Bearer <token>'
Example Responses
{ "message": "message", "id": "id" }
json
application/json

InviteMembers