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
| Action | What it does |
|---|---|
| Add task comment | Write a comment on a task. |
| Assign people to task | Assign people to a task, keeping those already assigned. |
| Create document | Create a document in a project from Markdown. |
| Create label | Create a label for tasks. |
| Create list | Add a list to a project, or a milestone with a start and end. |
| Create project | Create a project, optionally in a portfolio and with a visibility. |
| Create status | Add a status, a column of the board, to a project. |
| Create task | Create a task in a project, with its list, status, people, labels, dates and estimate. |
| Delete label | Move a label to Nifty's trash. |
| Delete project | Move a project and everything in it to Nifty's trash. |
| Get current member | Get the person the connection acts as, and the workspace it reaches. |
| Get project | Get one project with its short code, link, visibility and default status. |
| Get task | Get one task with its dates, status and list, and optionally its assigned people, labels, subtasks and more. |
| Label task | Put labels on a task, keeping those already on it. |
| List documents | List a project's documents. |
| List labels | List the workspace's labels. |
| List lists | List a project's lists and milestones. |
| List members | List the people in the workspace, to find who to assign. |
| List projects | List projects, optionally only those with some text in the name or only archived ones. |
| List statuses | List a project's statuses, the columns of its board. |
| List task comments | List the comments on a task, newest first. |
| List tasks | List tasks, filtered by project, status, list, person, label or whether they are done. |
| List time entries | List logged time, newest first, optionally for one task or project. |
| Log time | Log time you spent on a task. |
| Search projects | Find projects by words in their name or description, best match first. |
| Search tasks | Find tasks in a project by words in their name or description, best match first. |
| Update project | Change a project's name, description, visibility, or archive it. |
| Update task | Change 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 ID
task_idtextRequired - The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
- Comment
texttextRequired - 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 ID
task_idtextRequired - The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
- People
member_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
- Project
project_idtextRequired - The project. Pick one, or give its id from an earlier step.
- Name
nametextRequired - The document's name.
- Content
contenttext - The document's text as Markdown: headings, lists, tables and code blocks.
- Description
descriptiontext - A one to three sentence summary.
- Who can see it
access_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
- Name
nametextRequired - The label's text, up to 100 characters.
- Colour
colortext - 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
- Project
project_idtextRequired - The project. Pick one, or give its id from an earlier step.
- Name
nametextRequired - The list's name, up to 255 characters.
- Description
descriptiontext - What the list is for.
- Milestone
is_milestonetrue/false - Make it a milestone on the roadmap. It needs a start and an end.
- Starts
startdate and time - When the milestone starts.
- Ends
enddate 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
- Name
nametextRequired - The project's name, up to 100 characters. It must be unique in its portfolio.
- Description
descriptiontext - What the project is for. Markdown works.
- Portfolio
portfolio_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 it
access_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
- Project
project_idtextRequired - The project. Pick one, or give its id from an earlier step.
- Name
nametextRequired - The status's name, such as Blocked.
- Colour
colortext - 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
- Project
project_idtextRequired - The project. Pick one, or give its id from an earlier step.
- Name
nametextRequired - The task's name, up to 1,024 characters.
- Description
descriptiontext - What the task is about. Markdown works.
- List
list_idtext - The list to put it on. Leave empty for none.
- Status
status_idtext - The status to start it in. Leave empty for the project's first.
- Assign to
assignee_idslist - The people to assign it to.
- Labels
label_idslist - The labels to use. Pick some, or give ids from an earlier step.
- Starts
start_atdate and time - When work on it should start.
- Due
due_atdate and time - When it is due.
- Estimate in minutes
estimate_minutesnumber - How long it should take, in minutes (90 for an hour and a half).At least 0.
- Story points
story_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
- Label
label_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
- Project
project_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
- Project
project_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 ID
task_idtextRequired - The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
- Also include
includelist - 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 ID
task_idtextRequired - The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
- Labels
label_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
- Project
project_idtextRequired - The project. Pick one, or give its id from an earlier step.
- Page size
limitnumber - How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
- Next page cursor
cursortext - 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 size
limitnumber - How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
- Next page cursor
cursortext - 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
- Project
project_idtextRequired - The project. Pick one, or give its id from an earlier step.
- Page size
limitnumber - How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
- Next page cursor
cursortext - 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 contains
name_containstext - Only people whose name has this text in it.
- Page size
limitnumber - How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
- Next page cursor
cursortext - 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 contains
name_containstext - Only projects whose name has this text in it.
- Archived only
archived_onlytrue/false - Show only archived projects. Off lists the active ones.
- Page size
limitnumber - How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
- Next page cursor
cursortext - 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
- Project
project_idtextRequired - The project. Pick one, or give its id from an earlier step.
- Page size
limitnumber - How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
- Next page cursor
cursortext - 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 ID
task_idtextRequired - The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
- Page size
limitnumber - How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
- Next page cursor
cursortext - 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
- Project
project_idtext - The project. Pick one, or give its id from an earlier step.
- Status
status_idtext - Only tasks in this status.
- List
list_idtext - Only tasks on this list.
- Assigned to
assignee_idtext - Only tasks assigned to this person.
- Label
label_idtext - Only tasks with this label.
- Done or not
completiontext - Which tasks to include. Defaults to both.One of:
all(Done and not done (default)),open(Not done only),done(Done only). - Order
sorttext - 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 size
limitnumber - How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
- Next page cursor
cursortext - 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 ID
task_idtext - Only time on this task.
- Project
project_idtext - The project. Pick one, or give its id from an earlier step.
- Page size
limitnumber - How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
- Next page cursor
cursortext - 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 ID
task_idtextRequired - The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
- Started
startdate and timeRequired - When the work started.
- Ended
enddate and time - When the work ended.
- Description
descriptiontext - 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 for
querytextRequired - Words to look for, 3 to 200 characters.
- Page size
limitnumber - How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
- Next page cursor
cursortext - 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
- Project
project_idtextRequired - The project. Pick one, or give its id from an earlier step.
- Search for
querytextRequired - Words to look for, 3 to 200 characters.
- Page size
limitnumber - How many to return, 1 to 200. Nifty's default is 50.From 1 to 200.
- Next page cursor
cursortext - 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
- Project
project_idtextRequired - The project. Pick one, or give its id from an earlier step.
- Name
nametext - A new name. Leave empty to leave it as it is.
- Description
descriptiontext - A new description. Leave empty to leave it as it is.
- Who can see it
access_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). - Archive
archivetext - 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 ID
task_idtextRequired - The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
- Name
nametext - A new name. Leave empty to leave it as it is.
- Description
descriptiontext - A new description. Leave empty to leave it as it is.
- Mark as
mark_astext - Mark the task done, or not done. Leave empty to leave it as it is.One of:
done,open(Not done). - Archive
archivetext - 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). - Starts
start_atdate and time - A new start time. Leave empty to leave it as it is.
- Due
due_atdate and time - A new due time. Leave empty to leave it as it is.
- Project
project_idtext - The project. Pick one, or give its id from an earlier step.
- List
list_idtext - Move it to this list (of the project above).
- Status
status_idtext - Move it to this status (of the project above).
- Estimate in minutes
estimate_minutesnumber - A new estimate, in minutes. Leave empty to leave it as it is.At least 0.
- Story points
story_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"
}
}