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",
  "date": "2023-12-25",
  "minutes": 123,
  "memberId": "<string>",
  "statusId": "not_submitted",
  "notes": "<string>",
  "projectId": "<string>",
  "roleId": "<string>",
  "taskId": "<string>",
  "timeOffTypeId": "<string>",
  "startTime": "<string>",
  "endTime": "<string>"
}
'
{
  "id": "134acd20-52f5-40e9-a434-718977059c67",
  "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": "7c8f2e19-4d5a-4a3b-9c6d-2e8f1a0b3c4d",
    "name": "Jane Smith"
  },
  "project": {
    "id": "b4cc2b99-3b3a-4b73-8f4e-8c1d7a94e5b0",
    "name": "Website Redesign",
    "client": {
      "id": "56deca22-a707-4148-a5f7-ea3ae6391d67",
      "name": "Acme Corp"
    }
  },
  "role": {
    "id": "e3a1f7b2-8c4d-4e6f-9a2b-1d5c8e7f0a3b",
    "name": "Designer"
  },
  "task": {
    "id": "d4e5f6a7-b8c9-0123-4567-89abcdef0123",
    "name": "Design Phase"
  },
  "timeOffType": {
    "id": "9f8e7d6c-5b4a-3c2d-1e0f-a9b8c7d6e5f4",
    "name": "Paid Time Off"
  },
  "invoice": {
    "id": "c7d8e9f0-a1b2-3c4d-5e6f-7a8b9c0d1e2f",
    "number": "INV-0042",
    "line": {
      "id": "2b3c4d5e-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
      "number": 1
    }
  },
  "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. Can be either "project_time" (logging time to a project) or "time_off" (time off).

Available options:
project_time,
time_off
​
date
string<date>

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

​
minutes
integer<int32>

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

​
memberId
string

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

​
statusId
enum<string>

The status of the time entry.

Available options:
not_submitted,
pending_approval,
approved,
rejected
​
notes
string

Any notes with the associated entry. May be required depending on the project configuration.

​
projectId
string

The project ID (uuid) of the project for the time entry. Must be provided if the typeId is changed to project_time.

​
roleId
string

The role ID (uuid) of the project role for the time entry. May be required depending on the project configuration.

​
taskId
string

The task ID (uuid) of the project task for the time entry. May be required depending on the project configuration.

​
timeOffTypeId
string

The time off type ID (uuid) of the time off type for the time entry. Must be provided if the typeId is changed to time_off.

​
startTime
string

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

​
endTime
string

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

Response

200

​
id
string

The unique identifier for the object.

​
typeId
enum<string>

The type of the time entry. Can be either "project_time" (logging time to a project) or "time_off" (time off).

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

The status of the time entry. Will default to not_submitted if not supplied.

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

The client approval status. Only present when the project has client approvals enabled.

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

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

​
minutes
integer<int32>

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

​
timerStartedAt
string<date-time> | null

The timestamp of the start of a running timer. null if no timer is active.

​
notes
string | null

Any notes with the associated entry. May be required depending on the project configuration.

​
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. Used with endTime to calculate minutes if not provided.

​
endTime
string | null

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

​
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. Only present for time off entries.

​
invoice
object

The invoice this time entry has been billed on.

​
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. This is a read-only property.

​
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. This is a read-only property.

​
costPerHour
number | null

The cost per hour applicable to this time entry. This is a read-only property.