PUT /api/v1.0/projects/{project_id}
Bearer

This endpoint updates the project details.

Path parameters

  • project_id string Required

    Enter project id

multipart/form-data

Body Required

  • name string

    Updated project name.

  • description string

    Updated project description.

  • archived string

    Set to "true" to archive the project, "false" to unarchive. Send as form string.

    Values are true or false.

  • auto_milestones string

    Enable or disable automatic milestones. Send as "true" or "false".

    Values are true or false.

  • subteam_id string

    Subteam ID (shortid) to move the project to. Omit to keep current.

  • access_type number

    Access type: public (0), limited (1), personal (2). Send as form string.

    Values are 0, 1, or 2.

  • default_tasks_view string

    Default task view: table, calendar, swimlane, kanban, timeline, report.

    Values are table, calendar, swimlane, kanban, timeline, or report.

  • disabled_widgets string

    Comma-separated or JSON list of disabled widget names (e.g. milestones, tasks, discussion).

  • hidden_taskboard_fields string

    Hidden taskboard fields. Comma-separated or JSON.

  • milestones_rollup string

    Milestone rollup configuration. Sent as string when using form-data.

  • color string

    Primary hex color for the project.

  • secondary_color string

    Secondary hex color for the project.

  • nice_id string

    Short custom identifier (2–5 characters). Used in task IDs and URLs.

    Minimum length is 2, maximum length is 5.

  • hidden_list_columns string

    Hidden list view columns. Comma-separated or JSON.

  • list_columns_order string

    Order of list view columns. Comma-separated or JSON.

  • query_all_files string

    Query all files scope. Send as "true" or "false".

    Values are true or false.

Responses

  • 200 application/json

    Success Response

    Hide response attributes Show response attributes object
    • message string Required

      Success or status message.

    • id string Required

      Created project ID (shortid format).
  • 401

    The client request has not been completed because it lacks valid authentication credentials for the requested resource.

  • 403

    The client does not have access rights to the content.

  • 405

    The request method is known by the server but is not supported by the target resource.

PUT /api/v1.0/projects/{project_id} 
curl \
 --request PUT 'https://openapi.niftypm.com/api/v1.0/projects/{project_id}' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: multipart/form-data" \
 --form "name=Q2 Marketing Campaign" \
 --form "description=Updated campaign scope for Q2." \
 --form "archived=false" \
 --form "auto_milestones=true" \
 --form "subteam_id=Jh3f8k" \
 --form "access_type=0" \
 --form "default_tasks_view=table" \
 --form "disabled_widgets=string" \
 --form "hidden_taskboard_fields=string" \
 --form "milestones_rollup=string" \
 --form "color=#4A90D9" \
 --form "secondary_color=#E74C3C" \
 --form "nice_id=MK" \
 --form "hidden_list_columns=string" \
 --form "list_columns_order=status,assignee,dueDate" \
 --form "query_all_files=true"
Response examples (200) 
{
  "message": "Project created successfully",
  "id": "Jh3f8k"
}