Update a project

curl --request PUT \
  --url https://api.projectcor.com/v1/projects/{project_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "client_id": 123,
  "brief": "<string>",
  "start": "2023-12-25",
  "end": "2023-12-25",
  "pm_id": 123,
  "estimated_time": 123,
  "billable": true,
  "status": "<string>",
  "currency_id": 123,
  "evaluation_date": "2023-12-25",
  "estimated": 123,
  "fee_id": 123,
  "contract_id": 123,
  "deliverables": "<string>",
  "work_order": "<string>",
  "archived": false,
  "labels": [
    123
  ],
  "estimated_by_position": true,
  "estimation_by_categories": true,
  "estimated_by_hourly_rates": true,
  "ratecard_id": 123,
  "users_positions": [
    {
      "id": 123,
      "estimated_time": 123
    }
  ],
  "categories": [
    {
      "id": 123,
      "estimated_time": 123
    }
  ],
  "exchange": 123,
  "currency_change_amount": 123
}
'

import requests

url = "https://api.projectcor.com/v1/projects/{project_id}"

payload = {
    "name": "<string>",
    "client_id": 123,
    "brief": "<string>",
    "start": "2023-12-25",
    "end": "2023-12-25",
    "pm_id": 123,
    "estimated_time": 123,
    "billable": True,
    "status": "<string>",
    "currency_id": 123,
    "evaluation_date": "2023-12-25",
    "estimated": 123,
    "fee_id": 123,
    "contract_id": 123,
    "deliverables": "<string>",
    "work_order": "<string>",
    "archived": False,
    "labels": [123],
    "estimated_by_position": True,
    "estimation_by_categories": True,
    "estimated_by_hourly_rates": True,
    "ratecard_id": 123,
    "users_positions": [
        {
            "id": 123,
            "estimated_time": 123
        }
    ],
    "categories": [
        {
            "id": 123,
            "estimated_time": 123
        }
    ],
    "exchange": 123,
    "currency_change_amount": 123
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    client_id: 123,
    brief: '<string>',
    start: '2023-12-25',
    end: '2023-12-25',
    pm_id: 123,
    estimated_time: 123,
    billable: true,
    status: '<string>',
    currency_id: 123,
    evaluation_date: '2023-12-25',
    estimated: 123,
    fee_id: 123,
    contract_id: 123,
    deliverables: '<string>',
    work_order: '<string>',
    archived: false,
    labels: [123],
    estimated_by_position: true,
    estimation_by_categories: true,
    estimated_by_hourly_rates: true,
    ratecard_id: 123,
    users_positions: [{id: 123, estimated_time: 123}],
    categories: [{id: 123, estimated_time: 123}],
    exchange: 123,
    currency_change_amount: 123
  })
};

fetch('https://api.projectcor.com/v1/projects/{project_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const url = 'https://api.projectcor.com/v1/projects/{project_id}';
const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    client_id: 123,
    brief: '<string>',
    start: '2023-12-25',
    end: '2023-12-25',
    pm_id: 123,
    estimated_time: 123,
    billable: true,
    status: '<string>',
    currency_id: 123,
    evaluation_date: '2023-12-25',
    estimated: 123,
    fee_id: 123,
    contract_id: 123,
    deliverables: '<string>',
    work_order: '<string>',
    archived: false,
    labels: [123],
    estimated_by_position: true,
    estimation_by_categories: true,
    estimated_by_hourly_rates: true,
    ratecard_id: 123,
    users_positions: [{id: 123, estimated_time: 123}],
    categories: [{id: 123, estimated_time: 123}],
    exchange: 123,
    currency_change_amount: 123
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.projectcor.com/v1/projects/{project_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'client_id' => 123,
    'brief' => '<string>',
    'start' => '2023-12-25',
    'end' => '2023-12-25',
    'pm_id' => 123,
    'estimated_time' => 123,
    'billable' => true,
    'status' => '<string>',
    'currency_id' => 123,
    'evaluation_date' => '2023-12-25',
    'estimated' => 123,
    'fee_id' => 123,
    'contract_id' => 123,
    'deliverables' => '<string>',
    'work_order' => '<string>',
    'archived' => false,
    'labels' => [
        123
    ],
    'estimated_by_position' => true,
    'estimation_by_categories' => true,
    'estimated_by_hourly_rates' => true,
    'ratecard_id' => 123,
    'users_positions' => [
        [
                'id' => 123,
                'estimated_time' => 123
        ]
    ],
    'categories' => [
        [
                'id' => 123,
                'estimated_time' => 123
        ]
    ],
    'exchange' => 123,
    'currency_change_amount' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.projectcor.com/v1/projects/{project_id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"client_id\": 123,\n  \"brief\": \"<string>\",\n  \"start\": \"2023-12-25\",\n  \"end\": \"2023-12-25\",\n  \"pm_id\": 123,\n  \"estimated_time\": 123,\n  \"billable\": true,\n  \"status\": \"<string>\",\n  \"currency_id\": 123,\n  \"evaluation_date\": \"2023-12-25\",\n  \"estimated\": 123,\n  \"fee_id\": 123,\n  \"contract_id\": 123,\n  \"deliverables\": \"<string>\",\n  \"work_order\": \"<string>\",\n  \"archived\": false,\n  \"labels\": [\n    123\n  ],\n  \"estimated_by_position\": true,\n  \"estimation_by_categories\": true,\n  \"estimated_by_hourly_rates\": true,\n  \"ratecard_id\": 123,\n  \"users_positions\": [\n    {\n      \"id\": 123,\n      \"estimated_time\": 123\n    }\n  ],\n  \"categories\": [\n    {\n      \"id\": 123,\n      \"estimated_time\": 123\n    }\n  ],\n  \"exchange\": 123,\n  \"currency_change_amount\": 123\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": 123,
  "name": "<string>",
  "brief": "<string>",
  "client_id": 123,
  "start": "2023-11-07T05:31:56Z",
  "end": "2023-11-07T05:31:56Z",
  "estimated_time": 123,
  "elapsed_time": 123,
  "profitability_now": 123,
  "estimated_profitability": 123,
  "archived": true,
  "billable": true,
  "pm_id": 123,
  "created_by": 123,
  "company_id": 123,
  "template_id": 123,
  "brand_id": 123,
  "product_id": 123,
  "total_estimated": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "labels": [
    123
  ],
  "client": {
    "id": 123,
    "name": "<string>",
    "client_status_id": 123
  },
  "pm": {
    "id": 123,
    "first_name": "<string>",
    "last_name": "<string>",
    "email": "<string>",
    "role_id": 123
  },
  "estimated_by_position": true,
  "estimation_by_categories": true,
  "estimated_by_hourly_rates": true,
  "user_positions_header_id": 123,
  "fee_id": 123,
  "contract_id": 123,
  "usersPositionsProject": [
    {
      "id": 123,
      "user_positions_unified_id": 123,
      "project_id": 123,
      "estimated_hours": 123,
      "hours_charged": 123,
      "total_cost": 123,
      "userPositionName": {
        "name": "<string>"
      }
    }
  ],
  "categoriesProject": [
    {
      "id": 123,
      "category_id": 123,
      "estimated_hours": 123,
      "hours_charged": 123,
      "total_cost": 123
    }
  ],
  "ratecard": {
    "id": 123,
    "name": "<string>",
    "original_name": "<string>",
    "percent": 123,
    "currency_id": 123,
    "linked_to_base_price": true
  }
}

Projects

Update a project

Update a project entity. Include only the fields you want to change.

Time estimation — You can switch estimation mode by updating estimated_by_position / estimation_by_categories together with users_positions / categories. Positions present in the project but absent from the users_positions array will have their estimated hours reset to 0 (or be soft-deleted if no hours have been logged against them).

These fields are unrelated to Project Estimates (/projects/{project_id}/project_estimate), which manage budget line items.

PUT

projects

{project_id}

Update a project

curl --request PUT \
  --url https://api.projectcor.com/v1/projects/{project_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "client_id": 123,
  "brief": "<string>",
  "start": "2023-12-25",
  "end": "2023-12-25",
  "pm_id": 123,
  "estimated_time": 123,
  "billable": true,
  "status": "<string>",
  "currency_id": 123,
  "evaluation_date": "2023-12-25",
  "estimated": 123,
  "fee_id": 123,
  "contract_id": 123,
  "deliverables": "<string>",
  "work_order": "<string>",
  "archived": false,
  "labels": [
    123
  ],
  "estimated_by_position": true,
  "estimation_by_categories": true,
  "estimated_by_hourly_rates": true,
  "ratecard_id": 123,
  "users_positions": [
    {
      "id": 123,
      "estimated_time": 123
    }
  ],
  "categories": [
    {
      "id": 123,
      "estimated_time": 123
    }
  ],
  "exchange": 123,
  "currency_change_amount": 123
}
'

import requests

url = "https://api.projectcor.com/v1/projects/{project_id}"

payload = {
    "name": "<string>",
    "client_id": 123,
    "brief": "<string>",
    "start": "2023-12-25",
    "end": "2023-12-25",
    "pm_id": 123,
    "estimated_time": 123,
    "billable": True,
    "status": "<string>",
    "currency_id": 123,
    "evaluation_date": "2023-12-25",
    "estimated": 123,
    "fee_id": 123,
    "contract_id": 123,
    "deliverables": "<string>",
    "work_order": "<string>",
    "archived": False,
    "labels": [123],
    "estimated_by_position": True,
    "estimation_by_categories": True,
    "estimated_by_hourly_rates": True,
    "ratecard_id": 123,
    "users_positions": [
        {
            "id": 123,
            "estimated_time": 123
        }
    ],
    "categories": [
        {
            "id": 123,
            "estimated_time": 123
        }
    ],
    "exchange": 123,
    "currency_change_amount": 123
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    client_id: 123,
    brief: '<string>',
    start: '2023-12-25',
    end: '2023-12-25',
    pm_id: 123,
    estimated_time: 123,
    billable: true,
    status: '<string>',
    currency_id: 123,
    evaluation_date: '2023-12-25',
    estimated: 123,
    fee_id: 123,
    contract_id: 123,
    deliverables: '<string>',
    work_order: '<string>',
    archived: false,
    labels: [123],
    estimated_by_position: true,
    estimation_by_categories: true,
    estimated_by_hourly_rates: true,
    ratecard_id: 123,
    users_positions: [{id: 123, estimated_time: 123}],
    categories: [{id: 123, estimated_time: 123}],
    exchange: 123,
    currency_change_amount: 123
  })
};

fetch('https://api.projectcor.com/v1/projects/{project_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const url = 'https://api.projectcor.com/v1/projects/{project_id}';
const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    client_id: 123,
    brief: '<string>',
    start: '2023-12-25',
    end: '2023-12-25',
    pm_id: 123,
    estimated_time: 123,
    billable: true,
    status: '<string>',
    currency_id: 123,
    evaluation_date: '2023-12-25',
    estimated: 123,
    fee_id: 123,
    contract_id: 123,
    deliverables: '<string>',
    work_order: '<string>',
    archived: false,
    labels: [123],
    estimated_by_position: true,
    estimation_by_categories: true,
    estimated_by_hourly_rates: true,
    ratecard_id: 123,
    users_positions: [{id: 123, estimated_time: 123}],
    categories: [{id: 123, estimated_time: 123}],
    exchange: 123,
    currency_change_amount: 123
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.projectcor.com/v1/projects/{project_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'client_id' => 123,
    'brief' => '<string>',
    'start' => '2023-12-25',
    'end' => '2023-12-25',
    'pm_id' => 123,
    'estimated_time' => 123,
    'billable' => true,
    'status' => '<string>',
    'currency_id' => 123,
    'evaluation_date' => '2023-12-25',
    'estimated' => 123,
    'fee_id' => 123,
    'contract_id' => 123,
    'deliverables' => '<string>',
    'work_order' => '<string>',
    'archived' => false,
    'labels' => [
        123
    ],
    'estimated_by_position' => true,
    'estimation_by_categories' => true,
    'estimated_by_hourly_rates' => true,
    'ratecard_id' => 123,
    'users_positions' => [
        [
                'id' => 123,
                'estimated_time' => 123
        ]
    ],
    'categories' => [
        [
                'id' => 123,
                'estimated_time' => 123
        ]
    ],
    'exchange' => 123,
    'currency_change_amount' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.projectcor.com/v1/projects/{project_id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"client_id\": 123,\n  \"brief\": \"<string>\",\n  \"start\": \"2023-12-25\",\n  \"end\": \"2023-12-25\",\n  \"pm_id\": 123,\n  \"estimated_time\": 123,\n  \"billable\": true,\n  \"status\": \"<string>\",\n  \"currency_id\": 123,\n  \"evaluation_date\": \"2023-12-25\",\n  \"estimated\": 123,\n  \"fee_id\": 123,\n  \"contract_id\": 123,\n  \"deliverables\": \"<string>\",\n  \"work_order\": \"<string>\",\n  \"archived\": false,\n  \"labels\": [\n    123\n  ],\n  \"estimated_by_position\": true,\n  \"estimation_by_categories\": true,\n  \"estimated_by_hourly_rates\": true,\n  \"ratecard_id\": 123,\n  \"users_positions\": [\n    {\n      \"id\": 123,\n      \"estimated_time\": 123\n    }\n  ],\n  \"categories\": [\n    {\n      \"id\": 123,\n      \"estimated_time\": 123\n    }\n  ],\n  \"exchange\": 123,\n  \"currency_change_amount\": 123\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": 123,
  "name": "<string>",
  "brief": "<string>",
  "client_id": 123,
  "start": "2023-11-07T05:31:56Z",
  "end": "2023-11-07T05:31:56Z",
  "estimated_time": 123,
  "elapsed_time": 123,
  "profitability_now": 123,
  "estimated_profitability": 123,
  "archived": true,
  "billable": true,
  "pm_id": 123,
  "created_by": 123,
  "company_id": 123,
  "template_id": 123,
  "brand_id": 123,
  "product_id": 123,
  "total_estimated": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "labels": [
    123
  ],
  "client": {
    "id": 123,
    "name": "<string>",
    "client_status_id": 123
  },
  "pm": {
    "id": 123,
    "first_name": "<string>",
    "last_name": "<string>",
    "email": "<string>",
    "role_id": 123
  },
  "estimated_by_position": true,
  "estimation_by_categories": true,
  "estimated_by_hourly_rates": true,
  "user_positions_header_id": 123,
  "fee_id": 123,
  "contract_id": 123,
  "usersPositionsProject": [
    {
      "id": 123,
      "user_positions_unified_id": 123,
      "project_id": 123,
      "estimated_hours": 123,
      "hours_charged": 123,
      "total_cost": 123,
      "userPositionName": {
        "name": "<string>"
      }
    }
  ],
  "categoriesProject": [
    {
      "id": 123,
      "category_id": 123,
      "estimated_hours": 123,
      "hours_charged": 123,
      "total_cost": 123
    }
  ],
  "ratecard": {
    "id": 123,
    "name": "<string>",
    "original_name": "<string>",
    "percent": 123,
    "currency_id": 123,
    "linked_to_base_price": true
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

project_id

integer

required

Body

Fields to update on a project. Include only the properties you want to change.

name

string

Project Name

client_id

integer

Client ID

brief

string

Project description or brief

start

string<date>

Project start date (YYYY-MM-DD)

end

string<date>

Project end date (YYYY-MM-DD)

pm_id

integer

Project Manager User ID

estimated_time

number

Estimated hours for the project

billable

boolean

Whether the project is billable

status

string

Project status

currency_id

integer

Currency ID

evaluation_date

string<date>

Project evaluation date (YYYY-MM-DD)

estimated

number

Estimated monetary value for the project

fee_id

integer

Fee ID

contract_id

integer

Contract ID

deliverables

string

Project deliverables description

work_order

string

Work order number or code

income_type

enum<string>

Income type for the project

Available options:

fee,

one_time,

hourly_rate,

contract

archived

boolean

default:false

Whether the project is archived

labels

(integer | object)[]

Label IDs to assign to the project. Omit this field entirely to leave existing labels unchanged. Send an empty array ([]) to remove all labels from the project. Each entry may be an integer ID or an object with an id property (for example [101, 102]). Maximum 50 labels. Use Get Categories and Labels with model=project (GET /categories/labels-model?model=project) to list project label objects for your company; use each label's id in this array.

Maximum array length: 50

estimated_by_position

boolean

When true, time estimation is split per position via the users_positions array. Mutually exclusive with estimation_by_categories.

estimation_by_categories

When truthy (true or 1), time estimation is split per category via the categories array. Mutually exclusive with estimated_by_position.

estimated_by_hourly_rates

boolean

When true, the project income is calculated from hourly rates using the assigned ratecard.

ratecard_id

integer

Ratecard ID. Alias for user_positions_header_id — if both are sent, ratecard_id takes precedence.

users_positions

object[]

Positions involved in the project with optional per-position hour estimates. Positions present in the project but absent from this array will have their estimated hours set to 0 (or be soft-deleted if no hours have been logged).

Show child attributes

Response

200 - application/json

Project updated successfully

integer

Unique project identifier

name

string

Project name

brief

string

Project brief/description

client_id

integer

Associated client ID

health

enum<integer>

Project health indicator: 1 (on track), 2 (at risk), 3 (delayed), 4 (critical)

Available options:

1,

2,

3,

4

status

enum<string>

Project status

Available options:

active,

finished,

suspended

start

string<date-time>

Project start date

end

string<date-time>

Project end date

estimated_time

number

Estimated hours for the project

elapsed_time

number

Hours already logged

profitability_now

number

Current profitability percentage

estimated_profitability

number

Estimated profitability percentage

archived

boolean

Whether the project is archived

billable

boolean

Whether the project is billable

income_type

enum<string>

Project billing type

Available options:

fee,

one_time,

hourly_rate,

contract

pm_id

integer

Project Manager user ID

created_by

integer

User ID who created the project

company_id

integer

Company ID

template_id

integer

Project template ID used

brand_id

integer

Associated brand ID

product_id

integer

Associated product ID

total_estimated

number

Total estimated budget

created_at

string<date-time>

Creation timestamp

updated_at

string<date-time>

Last update timestamp

labels

integer[]

IDs of labels assigned to this project. Resolve names and styling via Get Categories and Labels with model=project (GET /categories/labels-model?model=project), which returns label objects including the same id values.

client

object

Associated client object

Show child attributes

object

Project Manager details

Show child attributes

estimated_by_position

boolean

Whether time estimation is split per position

estimation_by_categories

Whether time estimation is split per category

estimated_by_hourly_rates

Whether income is calculated from hourly rates using a ratecard

user_positions_header_id

integer | null

ID of the ratecard assigned to this project

fee_id

integer | null

Associated fee ID

contract_id

integer | null

Associated contract ID

usersPositionsProject

object[]

Positions assigned to the project with their estimated and logged hours. Only present when fetching a single project (GET /projects/{project_id}).

Show child attributes

categoriesProject

object[]

Categories assigned to the project with their estimated and logged hours. Only present when fetching a single project.

Show child attributes

ratecard

object | null

Ratecard assigned to this project. Only present when fetching a single project.

Show child attributes

⌘I

Introduction

Authentication

Brands

Clients

Contracts

Fees

Hours

Labels

Products

Project Templates

Projects

Ratecards

Tasks

Teams

Transactions

User Leaves

Users

User Positions

Working Time

Update a project

Authorizations

Path Parameters

Body

Response