Create a project status
POST/api/project-statuses
Required permissions:
- project_status.create: allows to create resources of projects where the user is the PM or the Account.
- project_status.create_other: allows to create resources of projects where the user is not the PM nor the Account.
Request
Header Parameters
The company you want to interact with
The API version you want to use
- application/json
Body
ID of the project to which the project status belongs
The date of the project status (must be a Monday)
This follows the YYYY-MM-DD format
The amount of days left
This value is required when the project status mode is remaining-days
Possible values: <= 100
The percentual progress
This value is required when the project status mode is percentage
The project status notes
ID of the project status risk
Responses
- 201
- 400
- 401
- 403
Returns the project status created.
- application/json
- Schema
- Example (from schema)
Schema
Possible values: >= 1
The unique identifier of the resource
The date and time when the resource was created
The date and time when the resource was last updated
Possible values: >= 1
ID of the project to which the project status belongs
The date of the project status
The amount of days left
The percentual progress
The project status notes
Possible values: >= 1
ID of the project status risk
The date and time when the resource was deleted
{
  "id": 1,
  "created_at": "2025-10-28T10:23:50.065Z",
  "updated_at": "2025-10-28T10:23:50.065Z",
  "project_id": 1,
  "date": "2025-10-28",
  "days_left": 4.5,
  "progress": 10,
  "notes": "I am a note",
  "project_status_risk_id": 1,
  "deleted_at": "2025-10-28T10:23:50.065Z"
}
Validation failed
- application/json
- Schema
- Example (from schema)
Schema
- Array [ 
- ] 
Error unique key
Human-readable message describing the error
failures
object[]
List of validation errors
Name of the field causing the error
Human-readable description of the error
{
  "key": "invalid_data",
  "message": "You provided invalid data. Check 'failures' for details.",
  "failures": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
Error unique key
Human-readable message describing the error
{
  "key": "string",
  "message": "string"
}
Forbidden
- application/json
- Schema
- Example (from schema)
Schema
Error unique key
Human-readable message describing the error
{
  "key": "string",
  "message": "string"
}