---
title: "Update project"
method: PUT
path: "/projects/{id}"
tags: ["Projects"]
---

# Update project

`PUT /projects/{id}`

Update a project

## Path parameters

- `id` integer, required

## Request body

- object
  - `project_name` string
  - `metadata` object
  - `idempotency_key` string — Optional idempotency key - this must be unique across firm's projects
  - `reminder_schedule` string — Set the project reminder schedule (case-insensitive). One of: Standard, All Off (alias: Project and Payments Off), "Project Off, Payment On" (alias: "Project Off, Payments On"), Daily, Every other day, Every 4 days, Weekly, Every other week, Every 3 weeks, Monthly. Custom schedules are not supported.

## Response `200`

successful

- object
  - `data` Project — Summary representation of a project. Contains scalar attributes plus the owning user and status — no assignees, tasks, tags, or entity. Use GET /projects/{id}, or POST /projects, for the ProjectExtended representation that includes those associations.
    - `id` integer
    - `name` string
    - `tax_year` integer, nullable — Four-digit year parsed from the project name, or null if the name contains no recent year.
    - `idempotency_key` string, nullable
    - `metadata` object
    - `last_uploaded` string, date-time, nullable — When a file was last uploaded to this project, or null if none has been.
    - `updated_at` string, date-time
    - `archived_at` string, date-time, nullable — When the project was archived, or null if it is active.
    - `user` User
      - `id` integer
      - `email` string
      - `first_name` string
      - `last_name` string
      - `idempotency_key` string, nullable
    - `project_status` ProjectStatus
      - `id` integer
      - `name` string
      - `position` integer

## Other responses

- `400` — project with idempotency key already exists

---

[API](https://skmtc.net/gettruss/apis/api-v1.md) · [All operations](https://skmtc.net/gettruss/apis/api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gettruss/api-v1/versions/7c956b3d1bdf/schema)