Skip to main content
PATCH
/
time-entries
/
{id}
Update a time entry
curl --request PATCH \
  --url https://www.ruddr.io/api/workspace/time-entries/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "typeId": "project_time",
  "statusId": "not_submitted",
  "date": "2023-12-25",
  "minutes": 123,
  "notes": "<string>",
  "startTime": "<string>",
  "endTime": "<string>",
  "memberId": "<string>",
  "projectId": "<string>",
  "roleId": "<string>",
  "taskId": "<string>",
  "timeOffTypeId": "<string>"
}
'
{
  "id": "f8a2c4e1-7b3d-4f96-ae52-d1c8b9f03e74",
  "typeId": "project_time",
  "statusId": "approved",
  "clientStatusId": "not_created",
  "date": "2025-01-15",
  "minutes": 60,
  "timerStartedAt": "2025-01-15T14:30:00.000Z",
  "notes": "Worked on homepage wireframes.",
  "createdAt": "2025-01-15T20:47:03.284Z",
  "startTime": "09:00",
  "endTime": "10:00",
  "member": {
    "id": "a91e4c70-3f28-4d85-b6c9-7e2d8a150f43",
    "name": "Jane Smith"
  },
  "project": {
    "id": "c5d7e2a8-9f14-4b63-8e71-a0d3c6b582f9",
    "name": "Website Redesign",
    "client": {
      "id": "82f1a9d3-e4b7-40c6-9a58-d7f2c3e810b5",
      "name": "Acme Corp"
    }
  },
  "role": {
    "id": "14b8e3f6-d927-4a5c-b190-8cf7e2a063d4",
    "name": "Designer"
  },
  "task": {
    "id": "6e9f1a4d-c82b-43e7-a5d0-f731b298c604",
    "name": "Design Phase"
  },
  "timeOffType": null,
  "invoice": {
    "id": "d29a4b8e-f173-4c60-a5e2-8b9d0c316f74",
    "number": "INV-0042",
    "line": {
      "id": "71e2f8c3-a940-4b15-d6e9-3c7d5a2b01f8",
      "number": 1
    }
  },
  "timesheet": {
    "id": "8c3f7a92-e14b-4d60-b5a1-2f09d7c63e18",
    "submittedOn": "2025-01-19T17:32:10.541Z"
  },
  "isBillable": true,
  "invoiced": true,
  "rateCurrency": "USD",
  "rate": 150,
  "costCurrency": "USD",
  "costPerHour": 75
}
A record of time logged by a member against a project or time off type.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required

The time entry uuid

Body

application/json
​
typeId
enum<string>

The type of the time entry.

Available options:
project_time,
time_off
​
statusId
enum<string>

The approval status of the time entry.

Available options:
not_submitted,
pending_approval,
approved,
rejected
​
date
string<date>

The date of the time entry. Should be in the form YYYY-MM-DD.

​
minutes
integer | null

The number of minutes for the time entry. Must be a whole number between 1 and 1440.

​
notes
string | null

Notes for the time entry. May be required depending on the project configuration. Max 5000 characters.

​
startTime
string | null

The local start time in HH:mm (24-hour) format. Used with endTime to calculate minutes when not provided.

​
endTime
string | null

The local end time in HH:mm (24-hour) format. Must be after startTime when set.

​
memberId
string

The member ID (uuid) of the member for this time entry.

​
projectId
string | null

The project ID (uuid) of the project for the time entry. Required when typeId is changed to project_time.

​
roleId
string | null

The role ID (uuid) of the project role for the time entry.

​
taskId
string | null

The task ID (uuid) of the project task for the time entry.

​
timeOffTypeId
string | null

The time off type ID (uuid) for the time entry. Required when typeId is changed to time_off.

Response

200

​
id
string

The unique identifier for the object.

​
typeId
enum<string>

The type of the time entry.

Available options:
project_time,
time_off
​
statusId
enum<string>

The approval status of the time entry.

Available options:
not_submitted,
pending_approval,
approved,
rejected
​
clientStatusId
enum<string> | null

The client approval status. null when the project does not have client approvals enabled.

Available options:
not_created,
pending_approval,
approved,
rejected
​
date
string<date>

The date of the time entry. Will be in the form YYYY-MM-DD.

​
minutes
integer

The number of minutes logged for the time entry.

​
timerStartedAt
string<date-time> | null

The timestamp when the timer was started. null if no timer is active.

​
notes
string | null

Notes associated with the time entry.

​
createdAt
string<date-time>

The timestamp when the object was created.

​
startTime
string | null

The local start time of the time entry in HH:mm (24-hour) format.

​
endTime
string | null

The local end time of the time entry in HH:mm (24-hour) format.

​
member
object

The member who logged the time entry.

​
project
object

The project for this time entry. null for time off entries.

​
role
object

The project role for this time entry.

​
task
object

The project task for this time entry.

​
timeOffType
object

The time off type. null for project time entries.

​
invoice
object

The invoice this time entry has been billed on. null if not invoiced.

​
timesheet
object

The timesheet this time entry was submitted on. null when the time entry has not been submitted or the timesheets feature is disabled.

​
isBillable
boolean

Whether this time entry is billable. This is a calculated value based on the project, role, and other related objects.

​
invoiced
boolean

Whether this time entry has been invoiced. When true, the invoice property will be populated.

​
rateCurrency
string | null

The currency code for the billing rate.

​
rate
number | null

The billable rate applicable to this time entry. This is a calculated value based on the project, role, and other related objects.

​
costCurrency
string | null

The currency code for the cost rate.

​
costPerHour
number | null

The cost per hour for this time entry.