ProjectManagement > Subproject

Updates a Subproject

Changed on
What does it do?

This updates the subproject details.

put/api/2026-10-01/resources/project_management/subprojects/{id}

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/project_management/subprojects/{id}
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: project_management_projects
    • or API key in header x-api-key

Path parameters

idstring required

The id of the subproject.

Request body

idstring required

The id of the subproject.

namestring required

The name of the subproject.

descriptionstring

The description of the subproject.

status'active' | 'closed' | 'draft' | 'processing' required

The status of the subproject.

codestring

The code of the subproject.

start_datestring

The start date of the subproject.

due_datestring

The due date of the subproject.

Example request

{
  "id": "314",
  "name": "Subproject name",
  "description": "Subproject description",
  "status": "active",
  "code": "SUB123",
  "start_date": "2025-01-01",
  "due_date": "2025-12-31"
}

Response

OK

idstring

The id of the subproject

namestring required

The name of the subproject

project_idstring required

The id of the project

inputed_minutesinteger

The total minutes tracked in the subproject (if requested)

labor_cost_centsinteger

The total labor cost of the subproject in cents (if requested)

descriptionstring

The description of the subproject

status'active' | 'closed' | 'draft' | 'processing' required

The status of the subproject

codestring

The code of the subproject

start_datestring

The start date of the subproject

due_datestring

The due date of the subproject

is_billableboolean

Whether the subproject is billable

Example response

{
  "id": "314",
  "name": "Subproject name",
  "project_id": "11",
  "labor_cost_cents": 540000,
  "description": "Subproject description",
  "status": "active",
  "code": "SUB123",
  "start_date": "2025-01-01",
  "due_date": "2025-12-31",
  "is_billable": true
}

Changes