# Nifty

> 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.

App · 28 actions. Web page: https://docs.lodol.com/docs/integrations/nifty

## Actions

### Add task comment

Write a comment on a task. Markdown works.

**Inputs**

- Task ID (`task_id`, text, required): The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
- Comment (`text`, text, required): What to say.

**Outputs**

- `comment` (object): The new comment

**Example output**

```json
{
  "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_id`, text, required): The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
- People (`member_ids`, list, required): The people to assign.

**Outputs**

- `assignees` (list): Everyone assigned to the task now
- `task_id` (text): The task

**Example output**

```json
{
  "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_id`, text, required): The project. Pick one, or give its id from an earlier step.
- Name (`name`, text, required): The document's name.
- Content (`content`, text): The document's text as Markdown: headings, lists, tables and code blocks.
- Description (`description`, text): A one to three sentence summary.
- Who can see it (`access_type`, text): 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**

- `document` (object): The new document

**Example output**

```json
{
  "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 (`name`, text, required): The label's text, up to 100 characters.
- Colour (`color`, text): A hex colour such as #00A99B. Leave empty to let Nifty pick.

**Outputs**

- `label` (object): The new label

**Example output**

```json
{
  "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_id`, text, required): The project. Pick one, or give its id from an earlier step.
- Name (`name`, text, required): The list's name, up to 255 characters.
- Description (`description`, text): What the list is for.
- Milestone (`is_milestone`, true/false): Make it a milestone on the roadmap. It needs a start and an end.
- Starts (`start`, date and time): When the milestone starts.
- Ends (`end`, date and time): When the milestone ends.

**Outputs**

- `list` (object): The new list

**Example output**

```json
{
  "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 (`name`, text, required): The project's name, up to 100 characters. It must be unique in its portfolio.
- Description (`description`, text): What the project is for. Markdown works.
- Portfolio (`portfolio_id`, text): 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_type`, text): 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**

- `project` (object): The new project

**Example output**

```json
{
  "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_id`, text, required): The project. Pick one, or give its id from an earlier step.
- Name (`name`, text, required): The status's name, such as Blocked.
- Colour (`color`, text): A hex colour such as #00A99B. Leave empty to let Nifty pick.

**Outputs**

- `status` (object): The new status

**Example output**

```json
{
  "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_id`, text, required): The project. Pick one, or give its id from an earlier step.
- Name (`name`, text, required): The task's name, up to 1,024 characters.
- Description (`description`, text): What the task is about. Markdown works.
- List (`list_id`, text): The list to put it on. Leave empty for none.
- Status (`status_id`, text): The status to start it in. Leave empty for the project's first.
- Assign to (`assignee_ids`, list): The people to assign it to.
- Labels (`label_ids`, list): The labels to use. Pick some, or give ids from an earlier step.
- Starts (`start_at`, date and time): When work on it should start.
- Due (`due_at`, date and time): When it is due.
- Estimate in minutes (`estimate_minutes`, number): How long it should take, in minutes (90 for an hour and a half). At least 0.
- Story points (`story_points`, number): The size of the task in story points. At least 0.

**Outputs**

- `task` (object): The new task

**Example output**

```json
{
  "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_id`, text, required): The label. Pick one, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once moved to the trash
- `label_id` (text): The label moved to the trash

**Example output**

```json
{
  "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_id`, text, required): The project. Pick one, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once moved to the trash
- `project_id` (text): The project moved to the trash

**Example output**

```json
{
  "deleted": true,
  "project_id": "Pz2J1w3rkD"
}
```

### Get current member

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

**Inputs**: None.

**Outputs**

- `member` (object): The connected member

**Example output**

```json
{
  "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_id`, text, required): The project. Pick one, or give its id from an earlier step.

**Outputs**

- `project` (object): The project

**Example output**

```json
{
  "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_id`, text, required): The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
- Also include (`include`, list): Related records to include in the answer. One or more of: `assignees` (Assigned people), `labels`, `subtasks`, `checklists`, `status`, `list`.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "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_id`, text, required): The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
- Labels (`label_ids`, list, required): The labels to use. Pick some, or give ids from an earlier step.

**Outputs**

- `labels` (list): Every label on the task now
- `task_id` (text): The task

**Example output**

```json
{
  "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_id`, text, required): The project. Pick one, or give its id from an earlier step.
- Page size (`limit`, number): How many to return, 1 to 200. Nifty's default is 50. From 1 to 200.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many were returned on this page
- `documents` (list): The documents
- `has_more` (true/false): Whether there is another page
- `next_cursor` (text): Give this as the next page cursor to get the page after this one

**Example output**

```json
{
  "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 (`limit`, number): How many to return, 1 to 200. Nifty's default is 50. From 1 to 200.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many were returned on this page
- `has_more` (true/false): Whether there is another page
- `labels` (list): The labels
- `next_cursor` (text): Give this as the next page cursor to get the page after this one

**Example output**

```json
{
  "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_id`, text, required): The project. Pick one, or give its id from an earlier step.
- Page size (`limit`, number): How many to return, 1 to 200. Nifty's default is 50. From 1 to 200.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many were returned on this page
- `has_more` (true/false): Whether there is another page
- `lists` (list): The lists
- `next_cursor` (text): Give this as the next page cursor to get the page after this one

**Example output**

```json
{
  "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_contains`, text): Only people whose name has this text in it.
- Page size (`limit`, number): How many to return, 1 to 200. Nifty's default is 50. From 1 to 200.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many were returned on this page
- `has_more` (true/false): Whether there is another page
- `members` (list): The people
- `next_cursor` (text): Give this as the next page cursor to get the page after this one

**Example output**

```json
{
  "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_contains`, text): Only projects whose name has this text in it.
- Archived only (`archived_only`, true/false): Show only archived projects. Off lists the active ones.
- Page size (`limit`, number): How many to return, 1 to 200. Nifty's default is 50. From 1 to 200.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many were returned on this page
- `has_more` (true/false): Whether there is another page
- `next_cursor` (text): Give this as the next page cursor to get the page after this one
- `projects` (list): The projects

**Example output**

```json
{
  "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_id`, text, required): The project. Pick one, or give its id from an earlier step.
- Page size (`limit`, number): How many to return, 1 to 200. Nifty's default is 50. From 1 to 200.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many were returned on this page
- `has_more` (true/false): Whether there is another page
- `next_cursor` (text): Give this as the next page cursor to get the page after this one
- `statuses` (list): The statuses

**Example output**

```json
{
  "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_id`, text, required): The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
- Page size (`limit`, number): How many to return, 1 to 200. Nifty's default is 50. From 1 to 200.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `comments` (list): The comments
- `count` (number): How many were returned on this page
- `has_more` (true/false): Whether there is another page
- `next_cursor` (text): Give this as the next page cursor to get the page after this one

**Example output**

```json
{
  "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_id`, text): The project. Pick one, or give its id from an earlier step.
- Status (`status_id`, text): Only tasks in this status.
- List (`list_id`, text): Only tasks on this list.
- Assigned to (`assignee_id`, text): Only tasks assigned to this person.
- Label (`label_id`, text): Only tasks with this label.
- Done or not (`completion`, text): Which tasks to include. Defaults to both. One of: `all` (Done and not done (default)), `open` (Not done only), `done` (Done only).
- Order (`sort`, text): 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 (`limit`, number): How many to return, 1 to 200. Nifty's default is 50. From 1 to 200.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many were returned on this page
- `has_more` (true/false): Whether there is another page
- `next_cursor` (text): Give this as the next page cursor to get the page after this one
- `tasks` (list): The tasks

**Example output**

```json
{
  "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_id`, text): Only time on this task.
- Project (`project_id`, text): The project. Pick one, or give its id from an earlier step.
- Page size (`limit`, number): How many to return, 1 to 200. Nifty's default is 50. From 1 to 200.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many were returned on this page
- `has_more` (true/false): Whether there is another page
- `next_cursor` (text): Give this as the next page cursor to get the page after this one
- `time_entries` (list): The time entries

**Example output**

```json
{
  "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_id`, text, required): The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
- Started (`start`, date and time, required): When the work started.
- Ended (`end`, date and time): When the work ended.
- Description (`description`, text): What you worked on.

**Outputs**

- `time_entry` (object): The new time entry

**Example output**

```json
{
  "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 (`query`, text, required): Words to look for, 3 to 200 characters.
- Page size (`limit`, number): How many to return, 1 to 200. Nifty's default is 50. From 1 to 200.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many were returned on this page
- `has_more` (true/false): Whether there is another page
- `next_cursor` (text): Give this as the next page cursor to get the page after this one
- `projects` (list): The matching projects

**Example output**

```json
{
  "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_id`, text, required): The project. Pick one, or give its id from an earlier step.
- Search for (`query`, text, required): Words to look for, 3 to 200 characters.
- Page size (`limit`, number): How many to return, 1 to 200. Nifty's default is 50. From 1 to 200.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many were returned on this page
- `has_more` (true/false): Whether there is another page
- `next_cursor` (text): Give this as the next page cursor to get the page after this one
- `tasks` (list): The matching tasks

**Example output**

```json
{
  "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_id`, text, required): The project. Pick one, or give its id from an earlier step.
- Name (`name`, text): A new name. Leave empty to leave it as it is.
- Description (`description`, text): A new description. Leave empty to leave it as it is.
- Who can see it (`access_type`, text): 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 (`archive`, text): 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**

- `project` (object): The updated project

**Example output**

```json
{
  "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_id`, text, required): The task's id, from 'List tasks', 'Search tasks' or 'Create task'.
- Name (`name`, text): A new name. Leave empty to leave it as it is.
- Description (`description`, text): A new description. Leave empty to leave it as it is.
- Mark as (`mark_as`, text): Mark the task done, or not done. Leave empty to leave it as it is. One of: `done`, `open` (Not done).
- Archive (`archive`, text): 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_at`, date and time): A new start time. Leave empty to leave it as it is.
- Due (`due_at`, date and time): A new due time. Leave empty to leave it as it is.
- Project (`project_id`, text): The project. Pick one, or give its id from an earlier step.
- List (`list_id`, text): Move it to this list (of the project above).
- Status (`status_id`, text): Move it to this status (of the project above).
- Estimate in minutes (`estimate_minutes`, number): A new estimate, in minutes. Leave empty to leave it as it is. At least 0.
- Story points (`story_points`, number): New story points. Leave empty to leave it as it is. At least 0.

**Outputs**

- `task` (object): The updated task

**Example output**

```json
{
  "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"
  }
}
```
