API v1 ReferenceTime Bookings

Creates a new time booking for a given project and user.

Required Permissions
Any authenticated user.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
userIdUUIDOptional
The id of the user this time booking is for.
projectIdUUID or nullOptional

(optional) The id of the project this time booking is for.

startDatedateOptional
The start date of this time booking.
endDatedateOptional
The end date and time of this time booking.
durationintegerOptional

The duration (in seconds) of this time booking.

descriptionstring or nullOptional

The optional name/description for this time booking.

laneOrderintegerOptional

The order in which this object should be shown in the timeline (row number). This value is used by the awork web app.

Response

OK
idUUID or null
createdOndatetime or null
createdByUUID or null
updatedOndatetime or null
updatedByUUID or null
userIdUUID or null
The id of the user this time booking is for.
projectIdUUID or null or null

(optional) The id of the project this time booking is for.

startDatedate or null
The start date of the time booking.
endDatedate or null
The end date of the time booking.
durationinteger or null
The planned duration, expressed in seconds, of this time booking.
descriptionstring or null or null
The optional description for this time booking.
laneOrderinteger or null

The order in which this object should be shown in the timeline (row number). Used by the awork web app.

isAnonymizedboolean or null or null
This will be true if the user doesn't have access to the project. In that case the description will be shadowed.