FAfactorialhr
ProjectManagement > Project

Activates a Project

Changed on
What does it do?

This endpoint can be used to set a project as Active.

What body params do you need?
  • id: mandatory. The id of the project aimed to be activated.
Who can use it?

Only companies who have enabled the projects_management feature and users with a role in the project.

post/api/2026-10-01/resources/project_management/projects/activate

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/project_management/projects/activate
  • 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

Request body

idstring required

Response

OK

idstring required

The id of the project

namestring required

The name of the project

codestring

The code of the project

descriptionstring

The description of the project

start_datestring

The start date of the project

due_datestring

The end date of the project

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

The lifecycle status of the project (whether it is still running and can take new charges)

employees_assignment'manual' | 'company' required

How employees get access to the project — manual (hand-picked members) or company (everyone in the company)

inputed_minutesinteger

The total minutes tracked in the project (if requested)

is_billableboolean required

Whether the project's costs can be billed (recharged) to a client

fixed_cost_centsinteger

Total fixed costs in cents

labor_cost_centsinteger

Total labor costs in cents

legal_entity_idstring required

The legal entity id of the project

spending_cost_centsinteger

Total spending costs in cents

client_idstring

The client of the project, refers to finance/contacts.

total_cost_centsinteger

Total Cost in cents

Example response

{
  "id": "314159",
  "name": "Project name",
  "code": "PRO",
  "description": "A comprehensive project to develop and implement a new customer relationship management system",
  "start_date": "2025-01-01",
  "due_date": "2026-01-01",
  "status": "active",
  "employees_assignment": "manual",
  "inputed_minutes": 123,
  "is_billable": true,
  "fixed_cost_cents": 123,
  "labor_cost_cents": 123,
  "legal_entity_id": "123",
  "spending_cost_cents": 123,
  "client_id": "123",
  "total_cost_cents": 123
}

Changes