Skip to main content
PATCH
/
members
/
{id}
Update a member
curl --request PATCH \
  --url https://www.ruddr.io/api/workspace/members/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "email": "<string>",
  "isActive": true,
  "isBillable": true,
  "loginEnabled": true,
  "employmentTypeId": "employee",
  "defaultRate": 123,
  "defaultRateCurrency": "<string>",
  "activeStartDate": "2023-12-25",
  "activeEndDate": "2023-12-25",
  "timeOffAllowed": true,
  "allowedTimeOffTypes": "all",
  "timeOffApprovalMode": "auto",
  "receiveMissingTimeReminders": true,
  "unsubmittedTimesheetReminders": true,
  "automaticTimesheetSubmissionConfirmation": true,
  "forbidTimesheetSubmissionWhenBelowCapacity": true,
  "timesheetCapacityPolicy": "unrestricted",
  "internalId": "<string>",
  "internalNotes": "<string>",
  "trackTimeByDuration": true,
  "trackTimeByTimeRange": true,
  "securityRoleId": "<string>",
  "jobTitleId": "<string>",
  "memberLevelId": "<string>",
  "disciplineId": "<string>",
  "practiceId": "<string>",
  "locationId": "<string>",
  "managerId": "<string>",
  "timeOffApproverId": "<string>",
  "holidayScheduleId": "<string>",
  "tagIds": [
    "<string>"
  ],
  "certificationIds": [
    "<string>"
  ],
  "skillIds": [
    "<string>"
  ],
  "timeOffTypeIds": [
    "<string>"
  ]
}
'
{ "id": "d2e30834-2092-4d8b-aae8-1f58fa4594cb", "name": "Jane Smith", "email": "jane.smith@example.com", "isActive": true, "isBillable": true, "loginEnabled": true, "invitationStatusId": "accepted", "employmentTypeId": "employee", "costMethodId": "fixed_hourly", "defaultRate": 150, "defaultRateCurrency": "USD", "activeStartDate": "2025-01-15", "activeEndDate": "2027-06-30", "timeOffAllowed": true, "allowedTimeOffTypes": "custom", "timeOffApprovalMode": "member", "receiveMissingTimeReminders": true, "unsubmittedTimesheetReminders": true, "automaticTimesheetSubmissionConfirmation": true, "timesheetCapacityPolicy": "unrestricted", "internalId": "EMP-001", "internalNotes": "Senior consultant with expertise in cloud architecture.", "createdAt": "2025-01-15T20:47:03.284Z", "trackTimeByDuration": true, "trackTimeByTimeRange": false, "securityRole": { "id": "b8c9d0e1-f2a3-4456-1278-901234567b23", "name": "Member" }, "jobTitle": { "id": "a1b2c3d4-e5f6-4789-ab01-234567890abc", "name": "Senior Consultant" }, "level": { "id": "b2c3d4e5-f6a7-4890-bc12-345678901bcd", "name": "Senior" }, "discipline": { "id": "c3d4e5f6-a7b8-4901-cd23-456789012cde", "name": "Engineering" }, "practice": { "id": "d4e5f6a7-b8c9-4012-de34-567890123def", "name": "Consulting" }, "location": { "id": "e5f6a7b8-c9d0-4123-ef45-678901234ef0", "name": "San Francisco" }, "manager": { "id": "f6a7b8c9-d0e1-4234-f056-789012345f01", "name": "Robert Chen" }, "timeOffApprover": { "id": "7b8c9d0e-1f2a-4345-a167-890123456b12", "name": "Sarah Kim" }, "holidaySchedule": { "id": "a7b8c9d0-e1f2-4345-0167-890123456a12", "name": "US Holidays" }, "tags": [ { "id": "c9d0e1f2-a3b4-4567-2389-012345678c34", "name": "Billable" } ], "certifications": [ { "id": "d0e1f2a3-b4c5-4678-34ab-123456789d45", "name": "AWS Certified Solutions Architect" } ], "skills": [ { "id": "e1f2a3b4-c5d6-4789-45bc-234567890e56", "name": "Python" } ], "timeOffTypes": [ { "id": "a3b4c5d6-e7f8-4901-67de-456789012a78", "name": "Vacation" } ], "availabilityPeriods": [ { "id": "f2a3b4c5-d6e7-4890-56cd-345678901f67", "start": "2025-01-15", "end": "2026-12-31", "hoursPerDay": [ 0, 8, 8, 8, 8, 8, 0 ] } ], "costPeriods": [ { "id": "b4c5d6e7-f8a9-4012-78ef-567890123b89", "start": "2025-01-15", "end": "2026-12-31", "currency": "USD", "costMethodId": "fixed_hourly", "costPerHour": 100, "overheadCostPerHour": 20, "totalCostPerHour": 120, "costPerMonth": null, "overheadCostPerMonth": null, "totalCostPerMonth": null, "currencyName": "US Dollar" } ], "utilizationTargetPeriods": [ { "id": "c5d6e7f8-a9b0-4123-89f0-678901234c90", "start": "2025-01-15", "end": "2026-12-31", "targetPercentage": 80 } ], "forbidTimesheetSubmissionWhenBelowCapacity": false }
A person that belongs to your workspace.

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 member uuid

Body

application/json
​
name
string

The name of the member. Max 255 chars.

​
email
string

The email address of the member. Must be unique between all members. Max 255 chars.

​
isActive
boolean

Whether the member is active in the workspace.

​
isBillable
boolean

Whether the member is billable.

​
loginEnabled
boolean

Whether the member can log into the workspace.

​
employmentTypeId
enum<string>

The type of employment for this member.

Available options:
employee,
contractor,
other
​
defaultRate
number

The default bill rate for the member.

​
defaultRateCurrency
string

The currency code for the default rate.

​
activeStartDate
string<date>

The active start date (YYYY-MM-DD) of the member. Must come on or before activeEndDate if set.

​
activeEndDate
string<date>

The active end date (YYYY-MM-DD) of the member. Must come on or after activeStartDate if set.

​
timeOffAllowed
boolean

Whether the member is allowed to create time-off time entries.

​
allowedTimeOffTypes
enum<string>

Controls which time off types are allowed for time-off entries.

Available options:
all,
custom
​
timeOffApprovalMode
enum<string>

The approval mode for time-off time entries. If set to "manager" then managerId is required. If set to "member" then timeOffApproverId is required.

Available options:
auto,
manager,
member
​
receiveMissingTimeReminders
boolean

Whether the member receives missing time reminders.

​
unsubmittedTimesheetReminders
boolean

Whether the member receives reminders for unsubmitted timesheets.

​
automaticTimesheetSubmissionConfirmation
boolean

Whether the member receives confirmation emails when timesheets are automatically submitted.

​
forbidTimesheetSubmissionWhenBelowCapacity
boolean
deprecated

Deprecated. Sets timesheetCapacityPolicy to "timesheet" when true or "unrestricted" when false. Use timesheetCapacityPolicy instead.

​
timesheetCapacityPolicy
enum<string>

The timesheet capacity policy.

Available options:
unrestricted,
timesheet,
week
​
internalId
string

An extra identifier field for tracking this member against other systems. Must be unique between all members. Max 255 chars.

​
internalNotes
string

An area to store extra notes about the member. Max 5000 chars.

​
trackTimeByDuration
boolean

Whether the member can track time by entering a duration.

​
trackTimeByTimeRange
boolean

Whether the member can track time by entering a start and end time.

​
securityRoleId
string

The ID (uuid) of the security role for this member.

​
jobTitleId
string

The ID (uuid) of the job title for this member.

​
memberLevelId
string

The ID (uuid) of the member level for this member.

​
disciplineId
string

The ID (uuid) of the discipline for this member.

​
practiceId
string

The ID (uuid) of the practice for this member.

​
locationId
string

The ID (uuid) of the location for this member.

​
managerId
string

The member ID (uuid) of the manager for this member. Required if timeOffApprovalMode is "manager".

​
timeOffApproverId
string

The member ID (uuid) of the time off approver for this member. Required if timeOffApprovalMode is "member".

​
holidayScheduleId
string

The ID (uuid) of the holiday schedule for this member.

​
tagIds
string[]

A list of member tag IDs (uuid) associated with this member.

​
certificationIds
string[]

A list of member certification IDs (uuid) associated with this member.

​
skillIds
string[]

A list of member skill IDs (uuid) associated with this member.

​
timeOffTypeIds
string[]

A list of time off type IDs (uuid) associated with this member. allowedTimeOffTypes must be set to "custom".

Response

200

​
id
string

The unique identifier for the object.

​
name
string

The name of the member.

​
email
string

The email address of the member.

​
isActive
boolean

Whether the member is active in the workspace.

​
isBillable
boolean

Whether the member is billable.

​
loginEnabled
boolean

Whether the member can log into the workspace.

​
invitationStatusId
enum<string>

The invitation status of the member.

Available options:
not_invited,
invited,
accepted
​
employmentTypeId
enum<string>

The type of employment for this member.

Available options:
employee,
contractor,
other
​
costMethodId
enum<string>
deprecated

Deprecated. The cost method for the member. Use costPeriods instead.

Available options:
hourly,
fixed_hourly,
fixed_monthly
​
defaultRate
number | null

The default bill rate for the member.

​
defaultRateCurrency
string | null

The currency code for the default bill rate.

​
activeStartDate
string<date> | null

The start date of the member's active period. Will be in the form YYYY-MM-DD.

​
activeEndDate
string<date> | null

The end date of the member's active period. Will be in the form YYYY-MM-DD.

​
timeOffAllowed
boolean

Whether the member is allowed to create time-off time entries.

​
allowedTimeOffTypes
enum<string>

Controls which time off types this member can use for time-off entries.

Available options:
all,
custom
​
timeOffApprovalMode
enum<string>

The approval mode for time-off time entries.

Available options:
auto,
manager,
member
​
receiveMissingTimeReminders
boolean

Whether the member receives missing time reminders.

​
unsubmittedTimesheetReminders
boolean

Whether the member receives reminders for unsubmitted timesheets.

​
automaticTimesheetSubmissionConfirmation
boolean

Whether the member receives confirmation emails when timesheets are automatically submitted.

​
timesheetCapacityPolicy
enum<string>

The timesheet capacity policy for this member.

Available options:
unrestricted,
timesheet,
week
​
internalId
string | null

An identifier for tracking this member against other systems.

​
internalNotes
string | null

Extra notes about the member.

​
createdAt
string<date-time>

The timestamp when the object was created.

​
trackTimeByDuration
boolean

Whether the member can track time by entering a duration. This is the effective value combining the workspace and member settings.

​
trackTimeByTimeRange
boolean

Whether the member can track time by entering a start and end time. This is the effective value combining the workspace and member settings.

​
securityRole
object

The security role assigned to the member.

​
jobTitle
object

The job title assigned to the member.

​
level
object

The member level assigned to the member.

​
discipline
object

The discipline assigned to the member.

​
practice
object

The practice assigned to the member.

​
location
object

The location assigned to the member.

​
manager
object

The member's direct manager.

​
timeOffApprover
object

The member designated to approve time-off requests. Only populated when timeOffApprovalMode is "member".

​
holidaySchedule
object

The holiday schedule assigned to the member.

​
tags
object[]

The list of member tags assigned to this member.

​
certifications
object[]

The list of certifications assigned to this member.

​
skills
object[]

The list of skills assigned to this member.

​
timeOffTypes
object[]

The list of time off types allowed for this member. Only populated when allowedTimeOffTypes is "custom".

​
availabilityPeriods
object[]

The list of availability periods defining how many hours per day the member is available.

​
costPeriods
object[]

The list of cost periods defining the member's cost over time.

​
utilizationTargetPeriods
object[] | null

The list of utilization target periods for the member. null if the Utilization Tracking feature is not enabled.

​
forbidTimesheetSubmissionWhenBelowCapacity
boolean
deprecated

Legacy. A computed flag derived from timesheetCapacityPolicy. true when the policy is "timesheet" or "week". Use timesheetCapacityPolicy instead.