Create or add to an existing actual

Adds minutes to an existing actual. If no actual matches the date, project, person, role, and workstream, a new one is created. To overwrite the existing minutes instead of adding to them, use Create or overwrite an actual. Learn more.

Body Params
date
required

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

number
required
≥ 0
Defaults to 0

The number of billable minutes to either add to a matching actual or create a new actual with

string

A note about the billable minutes

string

A note about the nonbillable minutes

number
required
≥ 0
Defaults to 0

The number of nonbillable minutes to either add to a matching actual or create a new actual with

number | null

The optional phase the actual is for. Leaving this undefined will not update the phase id on any existing actual. Providing null will clear it. Providing a value will update the phase id

number
required

The person this time entry is for

number
required

The project this time entry is for

number
required

The role the person was in for the 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