Create Actual Time

Request

Creates a new record representing hours a person has logged to a project, typically synced from the Timesheet System for tracking actuals against planned work. Parallax only allows a person to have a single role on a project offering, which means that the role is inferred by project_offering_id.

Security

ApiKey

Body

project_idstring, (uuid)required

The id of the project that the actual time is being recorded for.

project_offering_idstring, (uuid)required

The id of the project offering in which the actual time entry belongs to.

person_idstring, (uuid)required

The id of the Person to which the actual time entry belongs. If a person is specified who does not currently have a role on the project, a new ProjectOfferingRole will be created using the person's default organization role. The person will be assigned to it, and the ActualTime entry will be attached.

descriptionstring or null

Notes associated with the actual time entry.

recorded_datestring, (date)required

The date for which the actual time entry is recorded. ISO date formatting expected (yyyy-MM-dd)

hoursnumber, (double)required

The number of hours associated with the actual time entry.

billablebooleanrequired

Indicates whether the actual time entry was for billable work.

curl -i -X POST \
  https://developer.getparallax.com/_mock/api-documentation/swagger/v1/actual-time \
  -H 'Content-Type: application/json-patch+json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",
    "project_offering_id": "7dfed78d-ddbe-4f81-b7b1-e4094f9ff440",
    "person_id": "087e858e-473c-4f50-b5b0-c1df6c021550",
    "description": "string",
    "recorded_date": "2019-08-24",
    "hours": 0.1,
    "billable": true
  }'

Responses

Created

Bodyapplication/json

idstring, (uuid)

The id of the actual time entry

project_idstring, (uuid)

The id of the project that the actual time is being recorded for.

project_offering_idstring, (uuid)

The id of the project offering in which the actual time entry belongs to.

project_offering_role_idstring, (uuid)

The id of the project offering role that the actual time is recorded to.

person_idstring, (uuid)

The id of the Person to which the actual time entry belongs. If a person is specified who does not currently have a role on the project, a new ProjectOfferingRole will be created using the person's default organization role. The person will be assigned to it, and the ActualTime entry will be attached.

descriptionstring or null

Notes associated with the actual time entry.

recorded_datestring, (date)

The date for which the actual time entry is recorded. ISO date formatting expected (yyyy-MM-dd)

hoursnumber, (double)

The number of hours associated with the actual time entry.

billableboolean

Indicates whether the actual time entry was for billable work.

Response

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",
  "project_offering_id": "7dfed78d-ddbe-4f81-b7b1-e4094f9ff440",
  "project_offering_role_id": "7e0533b8-5407-48c5-9bcc-a30f3092a3e8",
  "person_id": "087e858e-473c-4f50-b5b0-c1df6c021550",
  "description": "string",
  "recorded_date": "2019-08-24",
  "hours": 0.1,
  "billable": true
}