Skip to main content
POST
/
members
/
{id}
/
invite
Invite a member
curl --request POST \
  --url https://www.ruddr.io/api/workspace/members/{id}/invite \
  --header 'Authorization: Bearer <token>'
{
  "id": "4a8e2c6f-b319-4d75-a0e3-7f1d9b5c28a4",
  "name": "Alex Rivera",
  "email": "alex.rivera@example.com",
  "isActive": true,
  "isBillable": true,
  "loginEnabled": true,
  "invitationStatusId": "invited",
  "employmentTypeId": "employee",
  "costMethodId": "fixed_hourly",
  "defaultRate": 175,
  "defaultRateCurrency": "USD",
  "activeStartDate": "2025-03-01",
  "activeEndDate": "2027-09-30",
  "timeOffAllowed": true,
  "allowedTimeOffTypes": "custom",
  "timeOffApprovalMode": "member",
  "receiveMissingTimeReminders": true,
  "unsubmittedTimesheetReminders": true,
  "automaticTimesheetSubmissionConfirmation": true,
  "timesheetCapacityPolicy": "unrestricted",
  "internalId": "EMP-042",
  "internalNotes": "Lead developer specializing in distributed systems.",
  "createdAt": "2025-03-01T09:22:17.641Z",
  "trackTimeByDuration": true,
  "trackTimeByTimeRange": false,
  "jobTitle": {
    "id": "7c4b1e9a-d538-4f62-b0a7-3e6f8d2c51b9",
    "name": "Lead Developer"
  },
  "level": {
    "id": "8d5c2f0b-e649-4073-c1b8-4f709e3d62ca",
    "name": "Senior"
  },
  "discipline": {
    "id": "9e6d3a1c-f75a-4184-d2c9-5081af4e73db",
    "name": "Engineering"
  },
  "practice": {
    "id": "af7e4b2d-086b-4295-e3da-6192b05f84ec",
    "name": "Product Development"
  },
  "location": {
    "id": "b08f5c3e-197c-43a6-f4eb-72a3c160a5fd",
    "name": "Austin"
  },
  "manager": {
    "id": "c1906d4f-2a8d-44b7-05fc-83b4d271b60e",
    "name": "Morgan Lee"
  },
  "timeOffApprover": {
    "id": "d2a17e50-3b9e-45c8-160d-94c5e382c71f",
    "name": "Jordan Blake"
  },
  "holidaySchedule": {
    "id": "e3b28f61-4caf-46d9-271e-a5d6f493d820",
    "name": "US Federal Holidays"
  },
  "securityRole": {
    "id": "f4c39072-5db0-47ea-382f-b6e70504e931",
    "name": "Member"
  },
  "tags": [
    {
      "id": "05d4a183-6ec1-48fb-4930-c7f81615fa42",
      "name": "Remote"
    }
  ],
  "certifications": [
    {
      "id": "16e5b294-7fd2-490c-5a41-d8092726ab53",
      "name": "AWS Certified Developer"
    }
  ],
  "skills": [
    {
      "id": "27f6c3a5-80e3-4a1d-6b52-e91a3837bc64",
      "name": "Go"
    }
  ],
  "timeOffTypes": [
    {
      "id": "3807d4b6-91f4-4b2e-7c63-fa2b4948cd75",
      "name": "Vacation"
    }
  ],
  "costPeriods": [
    {
      "id": "4918e5c7-a205-4c3f-8d74-0b3c5a59de86",
      "start": "2025-03-01",
      "end": "2026-12-31",
      "currency": "USD",
      "costMethodId": "fixed_hourly",
      "costPerHour": 85,
      "overheadCostPerHour": 15,
      "totalCostPerHour": 100,
      "costPerMonth": null,
      "overheadCostPerMonth": null,
      "totalCostPerMonth": null,
      "currencyName": "US Dollar"
    }
  ],
  "availabilityPeriods": [
    {
      "id": "5a29f6d8-b316-4d40-9e85-1c4d6b6aef97",
      "start": "2025-03-01",
      "end": "2026-12-31",
      "hoursPerDay": [
        0,
        8,
        8,
        8,
        8,
        8,
        0
      ]
    }
  ],
  "utilizationTargetPeriods": [
    {
      "id": "6b3a07e9-c427-4e51-af96-2d5e7c7bf0a8",
      "start": "2025-03-01",
      "end": "2026-12-31",
      "targetPercentage": 85
    }
  ],
  "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.

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.