ByteChef LogoByteChef

Nifty

Nifty Project Management is a software tool that streamlines team collaboration and project tracking with features like task management, timelines, and communication tools to enhance productivity.

Categories: Project Management, Productivity and Collaboration

Type: nifty/v1


Connections

Version: 1

OAuth2 Authorization Code

Properties

NameLabelTypeDescriptionRequired
clientIdClient IdSTRINGtrue
clientSecretClient SecretSTRINGtrue

Connection Setup

Create OAuth2 App

  1. Navigate to your Nifty dashboard.
  2. Click on your account name.
  3. Click on Settings.
  4. Click on App Center.
  5. Click on Integrate with API.
  6. Click on Create a new App.
  7. Enter name and description.
  8. Enter Redirect URI depending on your instance:
    • https://app.bytechef.io/callback (Cloud)
    • http://localhost:5173/callback (Local dev)
  9. Add all needed Scopes.
  10. Click on Create.
  11. Click this icon.
  12. Here are Client ID and Client Secret.

Actions

Add Labels

Name: addLabels

Add labels to the task.

Properties

NameLabelTypeDescriptionRequired
taskIdTask IDSTRINGID of the task to add label to.true
labelsLabelsARRAY
Items [STRING]
List of labels to add to the task.true

Example JSON Structure

{
  "label" : "Add Labels",
  "name" : "addLabels",
  "parameters" : {
    "taskId" : "",
    "labels" : [ "" ]
  },
  "type" : "nifty/v1/addLabels"
}

Output

Type: OBJECT

Properties

NameTypeDescription
messageSTRINGA confirmation message indicating whether the labels where added successfully.
labelsARRAY
Items [STRING]
List of labels added to the task.

Output Example

{
  "message" : "",
  "labels" : [ "" ]
}

Find Task ID

To find your task ID, click here.

Find Task Status

To find your task Status, click here.

Create Project

Name: createProject

Creates new project.

Properties

NameLabelTypeDescriptionRequired
nameNameSTRINGName of the project.true
descriptionDescriptionSTRINGDescription of the project's purpose, goals, or any other relevent information.false
template_idTemplate IDSTRINGID of template that can be used to pre-configure the project.false

Example JSON Structure

{
  "label" : "Create Project",
  "name" : "createProject",
  "parameters" : {
    "name" : "",
    "description" : "",
    "template_id" : ""
  },
  "type" : "nifty/v1/createProject"
}

Output

Type: OBJECT

Properties

NameTypeDescription
idSTRINGID of the project.
nameSTRINGName of the project.
descriptionSTRINGDescription of the project.
template_idSTRINGID of the template used to create the project.

Output Example

{
  "id" : "",
  "name" : "",
  "description" : "",
  "template_id" : ""
}

Find Template ID

To find your template ID, click here.

Create Status

Name: createStatus

Creates new status

Properties

NameLabelTypeDescriptionRequired
nameNameSTRINGName of the status.true
project_idProject IDSTRINGProject ID that the status belongs to.true

Example JSON Structure

{
  "label" : "Create Status",
  "name" : "createStatus",
  "parameters" : {
    "name" : "",
    "project_id" : ""
  },
  "type" : "nifty/v1/createStatus"
}

Output

Type: OBJECT

Properties

NameTypeDescription
messageSTRING
task_groupOBJECT
Properties {STRING(id), STRING(name), STRING(color), STRING(created_by), STRING(project), INTEGER(order)}

Output Example

{
  "message" : "",
  "task_group" : {
    "id" : "",
    "name" : "",
    "color" : "",
    "created_by" : "",
    "project" : "",
    "order" : 1
  }
}

Find Project ID

To find your project ID, click here.

Create Task

Name: createTask

Creates new task

Properties

NameLabelTypeDescriptionRequired
projectProject IDSTRINGID of the project within which the task will be created.false
task_group_idStatusSTRING
Depends On project
Status or Task Group ID of the group where the task will be stored.true
nameNameSTRINGName of the task.true
descriptionDescriptionSTRINGDescription of the task.false
due_dateDue DateDATE_TIMEDue date for the task.false

Example JSON Structure

{
  "label" : "Create Task",
  "name" : "createTask",
  "parameters" : {
    "project" : "",
    "task_group_id" : "",
    "name" : "",
    "description" : "",
    "due_date" : "2021-01-01T00:00:00"
  },
  "type" : "nifty/v1/createTask"
}

Output

Type: OBJECT

Properties

NameTypeDescription
idSTRINGID of the task.
nameSTRINGName of the task.
projectSTRINGID of the project the task belongs to.
descriptionSTRINGDescription of the task.
due_dateDATE_TIMEDue date for the task.

Output Example

{
  "id" : "",
  "name" : "",
  "project" : "",
  "description" : "",
  "due_date" : "2021-01-01T00:00:00"
}

Find Project ID

To find your project ID, click here.

Find Task Status

To find your task Status, click here.

Get Task

Name: getTask

Gets task details.

Properties

NameLabelTypeDescriptionRequired
taskIdTask IDSTRINGID of the task to get details for.true

Example JSON Structure

{
  "label" : "Get Task",
  "name" : "getTask",
  "parameters" : {
    "taskId" : ""
  },
  "type" : "nifty/v1/getTask"
}

Output

Type: OBJECT

Properties

NameTypeDescription
idSTRINGID of the task.
nameSTRINGName of the task.
projectSTRINGID of the project the task belongs to.
descriptionSTRINGDescription of the task.

Output Example

{
  "id" : "",
  "name" : "",
  "project" : "",
  "description" : ""
}

Find Task ID

To find your task ID, click here.

Get Tracked Time Report

Name: getTrackedTimeReport

Gets tracked time report information.

Properties

NameLabelTypeDescriptionRequired
project_idProject IDSTRINGId of the project to get the report for.true
start_dateStart DateDATE_TIMEStart date for the report.false
end_dateEnd DateDATE_TIMEStart date for the report.false

Example JSON Structure

{
  "label" : "Get Tracked Time Report",
  "name" : "getTrackedTimeReport",
  "parameters" : {
    "project_id" : "",
    "start_date" : "2021-01-01T00:00:00",
    "end_date" : "2021-01-01T00:00:00"
  },
  "type" : "nifty/v1/getTrackedTimeReport"
}

Output

Type: OBJECT

Properties

NameTypeDescription
itemsARRAY
Items [{STRING(id), STRING(project), STRING(start), BOOLEAN(manual), STRING(user), STRING(task), STRING(end), BOOLEAN(active), STRING(duration)}]

Output Example

{
  "items" : [ {
    "id" : "",
    "project" : "",
    "start" : "",
    "manual" : false,
    "user" : "",
    "task" : "",
    "end" : "",
    "active" : false,
    "duration" : ""
  } ]
}

Find Project ID

To find your project ID, click here.

Triggers

New Task

Name: newTask

Triggers when new task is created.

Type: DYNAMIC_WEBHOOK

Properties

NameLabelTypeDescriptionRequired
app_idApplicationSTRINGApplication to be used for the trigger.true

Output

Type: OBJECT

Properties

NameTypeDescription
idSTRINGID pod the task.
projectSTRINGProject under which the task is created.
orderSTRINGOrder of the task.
milestoneSTRINGMilestone of the task.

JSON Example

{
  "label" : "New Task",
  "name" : "newTask",
  "parameters" : {
    "app_id" : ""
  },
  "type" : "nifty/v1/newTask"
}

What to do if your action is not listed here?

If this component doesn't have the action you need, you can use Custom Action to create your own. Custom Actions empower you to define HTTP requests tailored to your specific requirements, allowing for greater flexibility in integrating with external services or APIs.

To create a Custom Action, simply specify the desired HTTP method, path, and any necessary parameters. This way, you can extend the functionality of your component beyond the predefined actions, ensuring that you can meet all your integration needs effectively.


Additional Instructions

How to find your Project ID

You have several methods to find your Nifty project ID:

  • Method 1: Through the Project URL
  1. Open the project in Nifty.

  2. Look at the URL in your browser. It will look similar to:

    https://nifty.pm/projects/12345/tasks

  3. The number in the URL (12345 in this example) is your project ID.

  • Method 2: Through the Nifty API
  1. Open your browser or API client.

  2. Run the following request (replace WORKSPACE_ID with your workspace ID):

    https://api.nifty.pm/v1/workspaces/WORKSPACE_ID/projects

  3. Find the project in the JSON response.

  4. The value under id is the project ID.

How to find your Project Status

  1. Open your browser or API client.

  2. Run the following request (replace PROJECT_ID with your project ID):

    https://api.nifty.pm/v1/projects/PROJECT_ID

  3. Look for the status field in the JSON response.

  4. The value under status is your project status.

How to find your Task ID

You have several methods to find your Nifty task ID:

  • Method 1: Through the Task URL
  1. Open the task in Nifty.

  2. Look at the URL in your browser. It will look similar to:

    https://nifty.pm/projects/12345/tasks/67890

  3. The last number (67890 in this example) is the task ID.

  • Method 2: Through the Nifty API
  1. Open your browser or API client.

  2. Run the following request (replace PROJECT_ID with your project ID):

    https://api.nifty.pm/v1/projects/PROJECT_ID/tasks

  3. Find the task in the JSON response.

  4. The value under id is the task ID.

How to find your Template ID

  1. Open your browser or API client.

  2. Run the following request:

    https://api.nifty.pm/v1/templates

  3. Find the template you want in the JSON response.

  4. The value under id is the template ID.

How to find Task Status

  1. Open your browser or API client.

  2. Run the following request (replace TASK_ID with your task ID):

    https://api.nifty.pm/v1/tasks/TASK_ID

  3. Look for the status field in the JSON response.

  4. The value under status is your task status.

How is this guide?

Last updated on

On this page