> ## Documentation Index > Fetch the complete documentation index at: https://docs.ruddr.io/llms.txt > Use this file to discover all available pages before exploring further. # Update a project member A team member assigned to a project. ## OpenAPI ````yaml openapi.json PATCH /project-members/{id} openapi: 3.1.0 info: title: Ruddr API version: '1.0' license: name: Proprietary url: https://www.ruddr.com/master-subscription-agreement servers: - url: https://www.ruddr.io/api/workspace security: - bearerAuth: [] tags: - name: Allocations description: Manage resource allocations for scheduling team members to projects. - name: Availability Periods description: Manage member availability periods for capacity planning. - name: Business Units description: >- Manage business units for organizing invoice settings and grouping clients and projects. - name: Client Roles description: Manage client roles and their billing terms. - name: Client Tags description: Manage tags for categorizing clients. - name: Clients description: Manage clients and their billing settings. - name: Companies description: Manage companies in the CRM pipeline. - name: Company Spend Tiers description: Manage spend tier classifications for companies. - name: Company Types description: Manage type classifications for companies. - name: Contact Tags description: Manage tags for categorizing contacts. - name: Contacts description: Manage contacts associated with clients, companies, and opportunities. - name: Cost Periods description: Manage member cost rate periods for profitability tracking. - name: Credit Notes description: View credit notes issued against invoices. - name: Disciplines description: Manage disciplines for classifying member skill areas. - name: Exchange Rate description: Get exchange rates for multi-currency workspaces. - name: Exchange Rate Periods description: Manage custom exchange rate periods for currency conversion. - name: Expense Categories description: Manage expense categories for tracking and reporting. - name: Expense Items description: Manage individual expense line items. - name: Expense Reports description: Manage expense reports submitted by members. - name: Holiday Schedules description: Manage holiday schedules for capacity and availability planning. - name: Holidays description: Manage individual holidays within holiday schedules. - name: Industries description: Manage industry classifications for clients and companies. - name: Invoice Items description: Manage invoice line item types for billing. - name: Invoices description: View invoices and their line items. - name: Job Titles description: Manage job title classifications for members. - name: Locations description: Manage office locations for members and projects. - name: Member Certifications description: Manage certification types that can be assigned to members. - name: Member Levels description: Manage member level classifications for career tracking. - name: Member Tags description: Manage tags for categorizing members. - name: Members description: Manage workspace members and their profiles. - name: Opportunities description: Manage sales opportunities in the CRM pipeline. - name: Opportunity Pipelines description: Manage pipelines for tracking opportunity stages. - name: Opportunity Lead Sources description: Manage lead source classifications for opportunities. - name: Opportunity Stages description: Manage pipeline stage definitions for opportunities. - name: Opportunity Tags description: Manage tags for categorizing opportunities. - name: Opportunity Types description: Manage type classifications for opportunities. - name: Payment Methods description: Manage payment method options for invoices. - name: Payments description: View payments received against invoices. - name: Pipeline Activities description: >- Manage pipeline activities associated with companies, contacts, members, and opportunities. - name: Pipeline Activity Types description: Manage activity type classifications for pipeline activities. - name: Practices description: Manage practice area classifications for organizing projects and members. - name: Project Budget Expenses description: Manage expense budget line items on projects. - name: Project Budget Other Items description: Manage other budget line items on projects. - name: Project Budget Product Items description: Manage product budget line items on projects. - name: Project Budget Service Items description: Manage additional service budget line items on projects. - name: Project Expenses description: Manage project-level expense line items. - name: Project Groups description: View project groups for organizing related projects. - name: Project Health Reports description: Manage project health status reports. - name: Project Invoice Milestones description: Manage invoice milestones for fixed-fee project billing. - name: Project Members description: Manage team member assignments on projects. - name: Project Monthly Budget Expenses description: Manage monthly expense budget line items on projects. - name: Project Monthly Budget Other Items description: Manage monthly other budget line items on projects. - name: Project Monthly Budget Product Items description: Manage monthly product budget line items on projects. - name: Project Monthly Budget Service Items description: Manage monthly additional service budget line items on projects. - name: Project Other Items description: Manage project-level other item line items. - name: Project Product Items description: Manage project-level product line items. - name: Project Revenue Adjustments description: Manage earned revenue adjustments for projects. - name: Project Revenue Recognition Entries description: Manage revenue recognition entries for projects. - name: Project Roles description: Manage roles defined on projects for billing and staffing. - name: Project Service Items description: Manage project-level additional service line items. - name: Project Tags description: Manage tags for categorizing projects. - name: Project Tasks description: Manage tasks on projects for time tracking and planning. - name: Project Types description: Manage type classifications for projects. - name: Projects description: Manage projects and their settings. - name: Resource Placeholders description: Manage placeholder resources for allocation planning. - name: Security Roles description: View security roles for assigning member permissions. - name: Skills description: Manage skill classifications for members and resource planning. - name: Task Categories description: Manage task category classifications for project tasks. - name: Task Tags description: Manage tags for categorizing project tasks. - name: Task Templates description: Manage reusable task templates for projects. - name: Tax Rates description: Manage tax rates for invoicing. - name: Time Entries description: Manage time entries for tracking hours on projects. - name: Time Off Types description: Manage time off type classifications. - name: Timesheet Attestations description: Manage attestation statements members sign when submitting timesheets. - name: Timesheets description: Manage timesheet submissions for tracking hours across a period. - name: Utilization Target Periods description: Manage member utilization target periods for capacity planning. - name: Workspace Roles description: Manage workspace-level roles for billing rate configuration. paths: /project-members/{id}: patch: tags: - Project Members summary: Update a project member operationId: update-a-project-member parameters: - name: id in: path description: The project member `uuid` schema: type: string required: true requestBody: content: application/json: schema: type: object properties: typeId: type: string description: The type of project member. enum: - collaborator - administrator isActive: type: boolean description: Whether the member is still active on the project. isBillable: type: boolean description: >- Whether the member is billable on this project. Only used if the project is not using roles. rate: type: - number - 'null' description: >- The member's billing rate for the project. Only used if the project is not using roles and the member is billable. overrideCostRate: type: boolean description: >- Whether to override this project member's cost rate at the project member level rather than using the workspace or member default. costCurrency: type: - string - 'null' description: >- The ISO 4217 currency code for the overridden cost rate. This will only get used if `overrideCostRate` is `true`. costPerHour: type: - number - 'null' description: >- The overridden cost per hour. This will only get used if `overrideCostRate` is `true`. overheadCostPerHour: type: - number - 'null' description: >- The overridden overhead cost per hour. This will only get used if `overrideCostRate` is `true`. estimatedBillableHours: type: - number - 'null' description: >- The number of billable hours to budget. This will only get used if not using roles and `useBudget` is `true` and `budgetMode` is `"detailed"` on the project. estimatedNonBillableHours: type: - number - 'null' description: >- The number of non-billable hours to budget. This will only get used if not using roles and `useBudget` is `true` and `budgetMode` is `"detailed"` on the project. estimatedMonthlyBillableHours: type: - number - 'null' description: >- The number of billable hours on the monthly budget. This will only get used if not using roles and `useMonthlyBudget` is `true` and `monthlyBudgetMode` is `"detailed"` on the project. estimatedMonthlyNonBillableHours: type: - number - 'null' description: >- The number of non-billable hours on the monthly budget. This will only get used if not using roles and `useMonthlyBudget` is `true` and `monthlyBudgetMode` is `"detailed"` on the project. roleIds: type: array description: >- A list of project role IDs (`uuid`) assigned to the member. Only used if the project is using roles. items: type: string responses: '200': description: '200' content: application/json: schema: $ref: '#/components/schemas/ProjectMember' examples: Result: value: id: a3f2e1d4-5b6c-7890-abcd-ef1234567890 typeId: administrator isActive: true isBillable: true rate: 200 overrideCostRate: true costCurrency: USD costPerHour: 90 overheadCostPerHour: 15 createdAt: '2025-03-10T14:22:31.000Z' member: id: b7c8d9e0-1f2a-3b4c-5d6e-7f8a9b0c1d2e name: Sarah Chen project: id: c4d5e6f7-8a9b-0c1d-2e3f-4a5b6c7d8e9f name: Enterprise Portal Redesign client: id: d1e2f3a4-b5c6-d7e8-f9a0-b1c2d3e4f5a6 name: Meridian Technologies roles: null budget: billableHours: 160 nonBillableHours: 24 monthlyBudget: billableHours: 40 nonBillableHours: 6 '400': description: '400' content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' examples: InvalidId: value: status: 400 message: Parameter 'id' is not a valid UUID. Validation: value: status: 400 message: >- There was a problem processing your request. See errors for more details. errors: - '''typeId'' must be one of [collaborator, administrator]' InvalidData: value: status: 400 message: >- Cannot change 'typeId' to 'collaborator' until another member is set as an administrator for this project. '404': description: '404' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: NotFound: value: status: 404 message: >- Object with id 'e7a3c9d5-2f8b-4e1a-b6d4-c8f2a5e9b3d7' not found. deprecated: false components: schemas: ProjectMember: type: object properties: id: type: string description: The unique identifier for the object. typeId: type: string description: The project member type. enum: - collaborator - administrator isActive: type: boolean description: Whether the member is still active on the project. isBillable: type: - boolean - 'null' description: >- Whether the member is billable on this project. Only used if the project is not using roles; otherwise billability is assigned at the role level and this field is `null`. rate: type: - number - 'null' description: >- The member's billing rate for the project. Only used if the project is not using roles and the member is billable; otherwise `null`. overrideCostRate: type: boolean description: >- Whether this project member's cost rate is overridden at the project member level rather than using the workspace or member default. costCurrency: type: - string - 'null' description: >- The ISO 4217 currency code for the overridden cost rate. Only populated when `overrideCostRate` is `true`; otherwise `null`. costPerHour: type: - number - 'null' description: >- The overridden cost per hour for this project member. Only populated when `overrideCostRate` is `true`; otherwise `null`. overheadCostPerHour: type: - number - 'null' description: >- The overridden overhead cost per hour for this project member. Only populated when `overrideCostRate` is `true`; otherwise `null`. createdAt: type: string format: date-time description: The timestamp when the object was created. member: type: object description: The workspace member assigned to this project. properties: id: type: string description: The unique identifier for the object. name: type: string description: The name of the member. project: type: object description: The project this member belongs to. properties: id: type: string description: The unique identifier for the object. name: type: string description: The name of the project. client: type: object description: The client associated with the project. properties: id: type: string description: The unique identifier for the object. name: type: string description: The name of the client. roles: type: - array - 'null' description: >- The project roles assigned to this member. `null` when the project does not use roles. items: type: object properties: id: type: string description: The unique identifier for the object. name: type: string description: The name of the role. budget: type: - object - 'null' description: >- The member's budget hours for the project. `null` when the project does not use a budget or uses roles. properties: billableHours: type: - number - 'null' description: >- The budgeted billable hours for the member on this project. `null` when the member is not billable. nonBillableHours: type: - number - 'null' description: The budgeted non-billable hours for the member on this project. monthlyBudget: type: - object - 'null' description: >- The member's monthly budget hours for the project. `null` when the project does not use a monthly budget in detailed mode or uses roles. properties: billableHours: type: - number - 'null' description: >- The budgeted billable hours per month for the member on this project. `null` when the member is not billable. nonBillableHours: type: - number - 'null' description: >- The budgeted non-billable hours per month for the member on this project. ValidationErrorResponse: type: object properties: status: type: integer description: The HTTP status code. message: type: string description: A human-readable error message. errors: type: array description: A list of validation error messages. items: type: string ErrorResponse: type: object properties: status: type: integer description: The HTTP status code. message: type: string description: A human-readable error message. securitySchemes: bearerAuth: type: http scheme: bearer ````