Update a Project.

patch

https://api.personio.de/v2/projects/{id}

Update a project by given project ID.

Path Params

string

required

Body Params

Request object for updating an existing project.

name

string | null

Name of the project.

status

string | null

enum

Status of the project.

Allowed:

project_code

string | null

Optional project code. This field needs to be unique across all projects (regardless of top level or sub project). It can be used as a reference to the projects in another system.

description

string | null

Optional project description.

cost_center

object | null

Optional cost center ID pointing to an existing Personio cost center ID. Sub projects (projects with a parent project) can't have a cost center.

assigned_to_all

boolean | null

Flag to assign the project to all employees. Projects assigned to all employees can't have members. If set to true, every employee in the company is able to track time against this project. If set to false, only members of the project can track time against this project. When this field is updated from false to true, all the project's existing members are removed. Sub projects (projects with a parent project) always have the same assigment as their parent project. This field shouldn't be provided for sub projects.

start

object | null

An optional start date of the project (inclusive).

end

object | null

An optional end date of the project (exclusive).

billable

boolean | null

Flag to mark project as billable. Sub projects (projects with a parent project) always have the same billable flag as their parent project. This field shouldn't be provided for sub projects.

client_name

string | null

Optional client name for the project. Sub projects (projects with a parent project) can't have a client name.

project_type

string | null

Optional project type. This is a free text field defined by the customer. Sub projects (projects with a parent project) can't have a project type.

Responses

204

Project was successfully updated.

400Invalid request.

403Forbidden

404The resource could not be found.

422Unprocessable content.