Nifty

App · 28 actions

Work with your Nifty projects: create, find, update and archive projects, lists and statuses; create, search, assign, label, comment on and update tasks; log time; and write documents.

Actions

ActionWhat it does
Add task commentWrite a comment on a task.
Assign people to taskAssign people to a task, keeping those already assigned.
Create documentCreate a document in a project from Markdown.
Create labelCreate a label for tasks.
Create listAdd a list to a project, or a milestone with a start and end.
Create projectCreate a project, optionally in a portfolio and with a visibility.
Create statusAdd a status, a column of the board, to a project.
Create taskCreate a task in a project, with its list, status, people, labels, dates and estimate.
Delete labelMove a label to Nifty's trash.
Delete projectMove a project and everything in it to Nifty's trash.
Get current memberGet the person the connection acts as, and the workspace it reaches.
Get projectGet one project with its short code, link, visibility and default status.
Get taskGet one task with its dates, status and list, and optionally its assigned people, labels, subtasks and more.
Label taskPut labels on a task, keeping those already on it.
List documentsList a project's documents.
List labelsList the workspace's labels.
List listsList a project's lists and milestones.
List membersList the people in the workspace, to find who to assign.
List projectsList projects, optionally only those with some text in the name or only archived ones.
List statusesList a project's statuses, the columns of its board.
List task commentsList the comments on a task, newest first.
List tasksList tasks, filtered by project, status, list, person, label or whether they are done.
List time entriesList logged time, newest first, optionally for one task or project.
Log timeLog time you spent on a task.
Search projectsFind projects by words in their name or description, best match first.
Search tasksFind tasks in a project by words in their name or description, best match first.
Update projectChange a project's name, description, visibility, or archive it.
Update taskChange a task: its name, description, dates, estimate, done or archived state, status or list, or move it to another project.

Add task comment

Write a comment on a task. Markdown works.

Inputs

Task IDtask_idtextRequired
The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
CommenttexttextRequired
What to say.

Outputs

commentobject
The new comment
Example output
{
  "comment": {
    "authorId": "mem_01",
    "createdAt": "2026-11-03T09:00:00Z",
    "id": "msg_01",
    "taskId": "KfS0ha8P",
    "text": "Looks good.",
    "type": "text"
  }
}

Assign people to task

Assign people to a task, keeping those already assigned.

Inputs

Task IDtask_idtextRequired
The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
Peoplemember_idslistRequired
The people to assign.

Outputs

assigneeslist
Everyone assigned to the task now
task_idtext
The task
Example output
{
  "assignees": [
    {
      "email": "jo@example.com",
      "id": "mem_01",
      "initials": "JB",
      "name": "Jo Bloggs",
      "pending": false,
      "removed": false,
      "roleId": "role_01",
      "tzIana": "America/New_York"
    }
  ],
  "task_id": "KfS0ha8P"
}

Create document

Create a document in a project from Markdown.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.
NamenametextRequired
The document's name.
Contentcontenttext
The document's text as Markdown: headings, lists, tables and code blocks.
Descriptiondescriptiontext
A one to three sentence summary.
Who can see itaccess_typetext
Who can open the document. Defaults to everyone in the project.One of: public (Everyone in the project (default)), limited (Only people added to it).

Outputs

documentobject
The new document
Example output
{
  "document": {
    "accessType": "public",
    "archived": false,
    "createdAt": "2026-11-03T09:00:00Z",
    "description": "Notes for launch day.",
    "id": "doc_01",
    "name": "Launch notes",
    "projectId": "Pz2J1w3rkD",
    "url": "https://app.niftypm.com/docs/doc_01"
  }
}

Create label

Create a label for tasks. Label names are unique in the workspace.

Inputs

NamenametextRequired
The label's text, up to 100 characters.
Colourcolortext
A hex colour such as #00A99B. Leave empty to let Nifty pick.

Outputs

labelobject
The new label
Example output
{
  "label": {
    "color": "#ff0000",
    "id": "lb_01",
    "name": "Urgent",
    "type": "others"
  }
}

Create list

Add a list to a project, or a milestone with a start and end.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.
NamenametextRequired
The list's name, up to 255 characters.
Descriptiondescriptiontext
What the list is for.
Milestoneis_milestonetrue/false
Make it a milestone on the roadmap. It needs a start and an end.
Startsstartdate and time
When the milestone starts.
Endsenddate and time
When the milestone ends.

Outputs

listobject
The new list
Example output
{
  "list": {
    "archived": false,
    "color": "#00a99b",
    "description": null,
    "end": null,
    "id": "li_01",
    "isMilestone": false,
    "name": "Launch",
    "projectId": "Pz2J1w3rkD",
    "start": null
  }
}

Create project

Create a project, optionally in a portfolio and with a visibility. Its default statuses are added by Nifty.

Inputs

NamenametextRequired
The project's name, up to 100 characters. It must be unique in its portfolio.
Descriptiondescriptiontext
What the project is for. Markdown works.
Portfolioportfolio_idtext
The portfolio to put it in. Leave empty for the General portfolio (or your first one, if there is no General). It cannot be changed later.
Who can see itaccess_typetext
Who can find the project. Defaults to invited members only.One of: limited (Invited members only (default)), workspace (Anyone in the workspace can find it), public (Everyone in the workspace is added).

Outputs

projectobject
The new project
Example output
{
  "project": {
    "accessType": "limited",
    "archived": false,
    "createdAt": "2026-11-03T09:00:00Z",
    "defaultStatusId": "st_01",
    "description": "Everything for the new site.",
    "id": "Pz2J1w3rkD",
    "name": "Website relaunch",
    "niceId": "WEB",
    "ownerId": "mem_01",
    "portfolioId": "pf_01",
    "updatedAt": "2026-11-03T09:00:00Z",
    "url": "https://app.niftypm.com/projects/Pz2J1w3rkD"
  }
}

Create status

Add a status, a column of the board, to a project.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.
NamenametextRequired
The status's name, such as Blocked.
Colourcolortext
A hex colour such as #00A99B. Leave empty to let Nifty pick.

Outputs

statusobject
The new status
Example output
{
  "status": {
    "archived": false,
    "color": "#ffaa00",
    "id": "st_01",
    "name": "In progress",
    "order": 200,
    "projectId": "Pz2J1w3rkD"
  }
}

Create task

Create a task in a project, with its list, status, people, labels, dates and estimate.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.
NamenametextRequired
The task's name, up to 1,024 characters.
Descriptiondescriptiontext
What the task is about. Markdown works.
Listlist_idtext
The list to put it on. Leave empty for none.
Statusstatus_idtext
The status to start it in. Leave empty for the project's first.
Assign toassignee_idslist
The people to assign it to.
Labelslabel_idslist
The labels to use. Pick some, or give ids from an earlier step.
Startsstart_atdate and time
When work on it should start.
Duedue_atdate and time
When it is due.
Estimate in minutesestimate_minutesnumber
How long it should take, in minutes (90 for an hour and a half).At least 0.
Story pointsstory_pointsnumber
The size of the task in story points.At least 0.

Outputs

taskobject
The new task
Example output
{
  "task": {
    "archived": false,
    "completed": false,
    "completedAt": null,
    "createdAt": "2026-11-03T09:00:00Z",
    "description": "Write and publish it.",
    "dueAt": "2026-11-10T17:00:00Z",
    "estimate": 90,
    "id": "KfS0ha8P",
    "identifier": "WEB-12",
    "listId": "li_01",
    "name": "Ship the quickstart",
    "niceId": 12,
    "parentTaskId": null,
    "projectId": "Pz2J1w3rkD",
    "startAt": null,
    "statusId": "st_01",
    "storyPoints": null,
    "updatedAt": "2026-11-03T09:00:00Z",
    "url": "https://app.niftypm.com/tasks/KfS0ha8P"
  }
}

Delete label

Move a label to Nifty's trash. Nifty keeps it for 30 days, and it can be restored there.

Inputs

Labellabel_idtextRequired
The label. Pick one, or give its id from an earlier step.

Outputs

deletedtrue/false
Always true once moved to the trash
label_idtext
The label moved to the trash
Example output
{
  "deleted": true,
  "label_id": "lb_01"
}

Delete project

Move a project and everything in it to Nifty's trash. Nifty keeps it for 30 days, and it can be restored there.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.

Outputs

deletedtrue/false
Always true once moved to the trash
project_idtext
The project moved to the trash
Example output
{
  "deleted": true,
  "project_id": "Pz2J1w3rkD"
}

Get current member

Get the person the connection acts as, and the workspace it reaches.

Inputs

None.

Outputs

memberobject
The connected member
Example output
{
  "member": {
    "email": "jo@example.com",
    "id": "mem_01",
    "initials": "JB",
    "name": "Jo Bloggs",
    "pending": false,
    "removed": false,
    "roleId": "role_01",
    "team": {
      "id": "team_01",
      "name": "Acme"
    },
    "tzIana": "America/New_York"
  }
}

Get project

Get one project with its short code, link, visibility and default status.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.

Outputs

projectobject
The project
Example output
{
  "project": {
    "accessType": "limited",
    "archived": false,
    "createdAt": "2026-11-03T09:00:00Z",
    "defaultStatusId": "st_01",
    "description": "Everything for the new site.",
    "id": "Pz2J1w3rkD",
    "name": "Website relaunch",
    "niceId": "WEB",
    "ownerId": "mem_01",
    "portfolioId": "pf_01",
    "updatedAt": "2026-11-03T09:00:00Z",
    "url": "https://app.niftypm.com/projects/Pz2J1w3rkD"
  }
}

Get task

Get one task with its dates, status and list, and optionally its assigned people, labels, subtasks and more.

Inputs

Task IDtask_idtextRequired
The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
Also includeincludelist
Related records to include in the answer.One or more of: assignees (Assigned people), labels, subtasks, checklists, status, list.

Outputs

taskobject
The task
Example output
{
  "task": {
    "archived": false,
    "assignees": [
      {
        "email": "jo@example.com",
        "id": "mem_01",
        "initials": "JB",
        "name": "Jo Bloggs",
        "pending": false,
        "removed": false,
        "roleId": "role_01",
        "tzIana": "America/New_York"
      }
    ],
    "completed": false,
    "completedAt": null,
    "createdAt": "2026-11-03T09:00:00Z",
    "description": "Write and publish it.",
    "dueAt": "2026-11-10T17:00:00Z",
    "estimate": 90,
    "id": "KfS0ha8P",
    "identifier": "WEB-12",
    "labels": [
      {
        "color": "#ff0000",
        "id": "lb_01",
        "name": "Urgent",
        "type": "others"
      }
    ],
    "listId": "li_01",
    "name": "Ship the quickstart",
    "niceId": 12,
    "parentTaskId": null,
    "projectId": "Pz2J1w3rkD",
    "startAt": null,
    "statusId": "st_01",
    "storyPoints": null,
    "updatedAt": "2026-11-03T09:00:00Z",
    "url": "https://app.niftypm.com/tasks/KfS0ha8P"
  }
}

Label task

Put labels on a task, keeping those already on it.

Inputs

Task IDtask_idtextRequired
The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
Labelslabel_idslistRequired
The labels to use. Pick some, or give ids from an earlier step.

Outputs

labelslist
Every label on the task now
task_idtext
The task
Example output
{
  "labels": [
    {
      "color": "#ff0000",
      "id": "lb_01",
      "name": "Urgent",
      "type": "others"
    }
  ],
  "task_id": "KfS0ha8P"
}

List documents

List a project's documents. Gets one page; to see more, run it again with the next page it gives.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.
Page sizelimitnumber
How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many were returned on this page
documentslist
The documents
has_moretrue/false
Whether there is another page
next_cursortext
Give this as the next page cursor to get the page after this one
Example output
{
  "count": 1,
  "documents": [
    {
      "accessType": "public",
      "archived": false,
      "createdAt": "2026-11-03T09:00:00Z",
      "description": "Notes for launch day.",
      "id": "doc_01",
      "name": "Launch notes",
      "projectId": "Pz2J1w3rkD",
      "url": "https://app.niftypm.com/docs/doc_01"
    }
  ],
  "has_more": false,
  "next_cursor": ""
}

List labels

List the workspace's labels. Gets one page; to see more, run it again with the next page it gives.

Inputs

Page sizelimitnumber
How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many were returned on this page
has_moretrue/false
Whether there is another page
labelslist
The labels
next_cursortext
Give this as the next page cursor to get the page after this one
Example output
{
  "count": 1,
  "has_more": false,
  "labels": [
    {
      "color": "#ff0000",
      "id": "lb_01",
      "name": "Urgent",
      "type": "others"
    }
  ],
  "next_cursor": ""
}

List lists

List a project's lists and milestones. Gets one page; to see more, run it again with the next page it gives.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.
Page sizelimitnumber
How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many were returned on this page
has_moretrue/false
Whether there is another page
listslist
The lists
next_cursortext
Give this as the next page cursor to get the page after this one
Example output
{
  "count": 1,
  "has_more": false,
  "lists": [
    {
      "archived": false,
      "color": "#00a99b",
      "description": null,
      "end": null,
      "id": "li_01",
      "isMilestone": false,
      "name": "Launch",
      "projectId": "Pz2J1w3rkD",
      "start": null
    }
  ],
  "next_cursor": ""
}

List members

List the people in the workspace, to find who to assign. Gets one page; to see more, run it again with the next page it gives.

Inputs

Name containsname_containstext
Only people whose name has this text in it.
Page sizelimitnumber
How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many were returned on this page
has_moretrue/false
Whether there is another page
memberslist
The people
next_cursortext
Give this as the next page cursor to get the page after this one
Example output
{
  "count": 1,
  "has_more": false,
  "members": [
    {
      "email": "jo@example.com",
      "id": "mem_01",
      "initials": "JB",
      "name": "Jo Bloggs",
      "pending": false,
      "removed": false,
      "roleId": "role_01",
      "tzIana": "America/New_York"
    }
  ],
  "next_cursor": ""
}

List projects

List projects, optionally only those with some text in the name or only archived ones. Gets one page; to see more, run it again with the next page it gives.

Inputs

Name containsname_containstext
Only projects whose name has this text in it.
Archived onlyarchived_onlytrue/false
Show only archived projects. Off lists the active ones.
Page sizelimitnumber
How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many were returned on this page
has_moretrue/false
Whether there is another page
next_cursortext
Give this as the next page cursor to get the page after this one
projectslist
The projects
Example output
{
  "count": 1,
  "has_more": false,
  "next_cursor": "",
  "projects": [
    {
      "accessType": "limited",
      "archived": false,
      "createdAt": "2026-11-03T09:00:00Z",
      "defaultStatusId": "st_01",
      "description": "Everything for the new site.",
      "id": "Pz2J1w3rkD",
      "name": "Website relaunch",
      "niceId": "WEB",
      "ownerId": "mem_01",
      "portfolioId": "pf_01",
      "updatedAt": "2026-11-03T09:00:00Z",
      "url": "https://app.niftypm.com/projects/Pz2J1w3rkD"
    }
  ]
}

List statuses

List a project's statuses, the columns of its board. Gets one page; to see more, run it again with the next page it gives.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.
Page sizelimitnumber
How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many were returned on this page
has_moretrue/false
Whether there is another page
next_cursortext
Give this as the next page cursor to get the page after this one
statuseslist
The statuses
Example output
{
  "count": 1,
  "has_more": false,
  "next_cursor": "",
  "statuses": [
    {
      "archived": false,
      "color": "#ffaa00",
      "id": "st_01",
      "name": "In progress",
      "order": 200,
      "projectId": "Pz2J1w3rkD"
    }
  ]
}

List task comments

List the comments on a task, newest first. Gets one page; to see more, run it again with the next page it gives.

Inputs

Task IDtask_idtextRequired
The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
Page sizelimitnumber
How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

commentslist
The comments
countnumber
How many were returned on this page
has_moretrue/false
Whether there is another page
next_cursortext
Give this as the next page cursor to get the page after this one
Example output
{
  "comments": [
    {
      "authorId": "mem_01",
      "createdAt": "2026-11-03T09:00:00Z",
      "id": "msg_01",
      "taskId": "KfS0ha8P",
      "text": "Looks good.",
      "type": "text"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_cursor": ""
}

List tasks

List tasks, filtered by project, status, list, person, label or whether they are done. Gets one page; to see more, run it again with the next page it gives.

Inputs

Projectproject_idtext
The project. Pick one, or give its id from an earlier step.
Statusstatus_idtext
Only tasks in this status.
Listlist_idtext
Only tasks on this list.
Assigned toassignee_idtext
Only tasks assigned to this person.
Labellabel_idtext
Only tasks with this label.
Done or notcompletiontext
Which tasks to include. Defaults to both.One of: all (Done and not done (default)), open (Not done only), done (Done only).
Ordersorttext
How to order the tasks. Defaults to board order.One of: order (Board order (default)), -createdAt (Newest first), createdAt (Oldest first), dueAt (Due soonest first), -dueAt (Due latest first), -updatedAt (Recently changed first), name (Name, A to Z).
Page sizelimitnumber
How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many were returned on this page
has_moretrue/false
Whether there is another page
next_cursortext
Give this as the next page cursor to get the page after this one
taskslist
The tasks
Example output
{
  "count": 1,
  "has_more": false,
  "next_cursor": "",
  "tasks": [
    {
      "archived": false,
      "completed": false,
      "completedAt": null,
      "createdAt": "2026-11-03T09:00:00Z",
      "description": "Write and publish it.",
      "dueAt": "2026-11-10T17:00:00Z",
      "estimate": 90,
      "id": "KfS0ha8P",
      "identifier": "WEB-12",
      "listId": "li_01",
      "name": "Ship the quickstart",
      "niceId": 12,
      "parentTaskId": null,
      "projectId": "Pz2J1w3rkD",
      "startAt": null,
      "statusId": "st_01",
      "storyPoints": null,
      "updatedAt": "2026-11-03T09:00:00Z",
      "url": "https://app.niftypm.com/tasks/KfS0ha8P"
    }
  ]
}

List time entries

List logged time, newest first, optionally for one task or project. You see your own unless your role allows more. Gets one page; to see more, run it again with the next page it gives.

Inputs

Task IDtask_idtext
Only time on this task.
Projectproject_idtext
The project. Pick one, or give its id from an earlier step.
Page sizelimitnumber
How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many were returned on this page
has_moretrue/false
Whether there is another page
next_cursortext
Give this as the next page cursor to get the page after this one
time_entrieslist
The time entries
Example output
{
  "count": 1,
  "has_more": false,
  "next_cursor": "",
  "time_entries": [
    {
      "description": "Drafting",
      "end": "2026-11-03T10:00:00Z",
      "id": "te_01",
      "manual": true,
      "memberId": "mem_01",
      "projectId": "Pz2J1w3rkD",
      "start": "2026-11-03T09:00:00Z",
      "taskId": "KfS0ha8P",
      "taskName": "Ship the quickstart"
    }
  ]
}

Log time

Log time you spent on a task. Leave the end empty to start a timer that is still running.

Inputs

Task IDtask_idtextRequired
The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
Startedstartdate and timeRequired
When the work started.
Endedenddate and time
When the work ended.
Descriptiondescriptiontext
What you worked on.

Outputs

time_entryobject
The new time entry
Example output
{
  "time_entry": {
    "description": "Drafting",
    "end": "2026-11-03T10:00:00Z",
    "id": "te_01",
    "manual": true,
    "memberId": "mem_01",
    "projectId": "Pz2J1w3rkD",
    "start": "2026-11-03T09:00:00Z",
    "taskId": "KfS0ha8P",
    "taskName": "Ship the quickstart"
  }
}

Search projects

Find projects by words in their name or description, best match first. Needs at least 3 characters, and no links or email addresses. Gets one page; to see more, run it again with the next page it gives.

Inputs

Search forquerytextRequired
Words to look for, 3 to 200 characters.
Page sizelimitnumber
How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many were returned on this page
has_moretrue/false
Whether there is another page
next_cursortext
Give this as the next page cursor to get the page after this one
projectslist
The matching projects
Example output
{
  "count": 1,
  "has_more": false,
  "next_cursor": "",
  "projects": [
    {
      "accessType": "limited",
      "archived": false,
      "createdAt": "2026-11-03T09:00:00Z",
      "defaultStatusId": "st_01",
      "description": "Everything for the new site.",
      "id": "Pz2J1w3rkD",
      "name": "Website relaunch",
      "niceId": "WEB",
      "ownerId": "mem_01",
      "portfolioId": "pf_01",
      "updatedAt": "2026-11-03T09:00:00Z",
      "url": "https://app.niftypm.com/projects/Pz2J1w3rkD"
    }
  ]
}

Search tasks

Find tasks in a project by words in their name or description, best match first. Needs at least 3 characters, and no links or email addresses. Gets one page; to see more, run it again with the next page it gives.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.
Search forquerytextRequired
Words to look for, 3 to 200 characters.
Page sizelimitnumber
How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
Next page cursorcursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many were returned on this page
has_moretrue/false
Whether there is another page
next_cursortext
Give this as the next page cursor to get the page after this one
taskslist
The matching tasks
Example output
{
  "count": 1,
  "has_more": false,
  "next_cursor": "",
  "tasks": [
    {
      "archived": false,
      "completed": false,
      "completedAt": null,
      "createdAt": "2026-11-03T09:00:00Z",
      "description": "Write and publish it.",
      "dueAt": "2026-11-10T17:00:00Z",
      "estimate": 90,
      "id": "KfS0ha8P",
      "identifier": "WEB-12",
      "listId": "li_01",
      "name": "Ship the quickstart",
      "niceId": 12,
      "parentTaskId": null,
      "projectId": "Pz2J1w3rkD",
      "startAt": null,
      "statusId": "st_01",
      "storyPoints": null,
      "updatedAt": "2026-11-03T09:00:00Z",
      "url": "https://app.niftypm.com/tasks/KfS0ha8P"
    }
  ]
}

Update project

Change a project's name, description, visibility, or archive it. Fields left empty stay as they are.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.
Namenametext
A new name. Leave empty to leave it as it is.
Descriptiondescriptiontext
A new description. Leave empty to leave it as it is.
Who can see itaccess_typetext
Who can find the project. Leave empty to leave it as it is.One of: limited (Invited members only (default)), workspace (Anyone in the workspace can find it), public (Everyone in the workspace is added).
Archivearchivetext
Archive it, or take it out of the archive. Leave empty to leave it as it is.One of: archive (Archive it), restore (Take it out of the archive).

Outputs

projectobject
The updated project
Example output
{
  "project": {
    "accessType": "limited",
    "archived": false,
    "createdAt": "2026-11-03T09:00:00Z",
    "defaultStatusId": "st_01",
    "description": "Everything for the new site.",
    "id": "Pz2J1w3rkD",
    "name": "Website relaunch",
    "niceId": "WEB",
    "ownerId": "mem_01",
    "portfolioId": "pf_01",
    "updatedAt": "2026-11-03T09:00:00Z",
    "url": "https://app.niftypm.com/projects/Pz2J1w3rkD"
  }
}

Update task

Change a task: its name, description, dates, estimate, done or archived state, status or list, or move it to another project. Fields left empty stay as they are.

Inputs

Task IDtask_idtextRequired
The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
Namenametext
A new name. Leave empty to leave it as it is.
Descriptiondescriptiontext
A new description. Leave empty to leave it as it is.
Mark asmark_astext
Mark the task done, or not done. Leave empty to leave it as it is.One of: done, open (Not done).
Archivearchivetext
Archive it, or take it out of the archive. Leave empty to leave it as it is.One of: archive (Archive it), restore (Take it out of the archive).
Startsstart_atdate and time
A new start time. Leave empty to leave it as it is.
Duedue_atdate and time
A new due time. Leave empty to leave it as it is.
Projectproject_idtext
The project. Pick one, or give its id from an earlier step.
Listlist_idtext
Move it to this list (of the project above).
Statusstatus_idtext
Move it to this status (of the project above).
Estimate in minutesestimate_minutesnumber
A new estimate, in minutes. Leave empty to leave it as it is.At least 0.
Story pointsstory_pointsnumber
New story points. Leave empty to leave it as it is.At least 0.

Outputs

taskobject
The updated task
Example output
{
  "task": {
    "archived": false,
    "completed": false,
    "completedAt": null,
    "createdAt": "2026-11-03T09:00:00Z",
    "description": "Write and publish it.",
    "dueAt": "2026-11-10T17:00:00Z",
    "estimate": 90,
    "id": "KfS0ha8P",
    "identifier": "WEB-12",
    "listId": "li_01",
    "name": "Ship the quickstart",
    "niceId": 12,
    "parentTaskId": null,
    "projectId": "Pz2J1w3rkD",
    "startAt": null,
    "statusId": "st_01",
    "storyPoints": null,
    "updatedAt": "2026-11-03T09:00:00Z",
    "url": "https://app.niftypm.com/tasks/KfS0ha8P"
  }
}

On this page