Create or overwrite an actual

Actuals are matched on date, project, person, role, and workstream. Minutes values represent the total time for the day and overwrite any previous actual with the same date, projectId, personId, roleId, and workstreamId. Learn more.

Body Params
date
required

The date this actual is for. Format: YYYY-MM-DD

number
required
≥ 0
Defaults to 0

The number of minutes that are billable. Either this or nonbillableMinutes must be set

number
required
≥ 0
Defaults to 0

The number of minutes that are non billable. Either this or billableMinutes must be set

string

A note about the billable minutes

string

A note about the nonbillable minutes

number | null

The phase this actual is for, if any.

number
required

The person this actual is for

number
required

The project this actual is for

number
required

The role the person was in when for this actual

number | null

The workstream the actual is for. Omitting this field matches an actual on any workstream and leaves that actual's workstream unchanged. null matches only an actual that has no workstream, and ignores actuals with workstreams in its filter. A value matches only an actual on that workstream, and ignores actuals on every other workstream. workstreamId will not update the existing actual's workstream. If nothing matches, the actual is created on the workstream you sent, or with no workstream when the field is omitted or null, in which case it appears under No Workstream. Where two or more actuals exist for the same date, project, person, and role on different workstreams, omitting this field updates the oldest of them. Send workstreamId on every request if the project uses workstreams.

Headers
enum
required
Defaults to 1.0.0
Allowed:
Responses

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json