> ## Documentation Index > Fetch the complete documentation index at: https://alpha.developer.tomorro.com/llms.txt > Use this file to discover all available pages before exploring further. # Update member > Updates an existing member's role, group assignments, or other properties. All fields are optional — only include the fields you want to change. ## OpenAPI ````yaml /openapi-2025-01-29.alpha.json patch /members/{id} openapi: 3.0.0 info: title: Tomorro API description: > The Tomorro Public API enables you to programmatically manage contracts, members, and counterparties. Build powerful integrations that automate your contract management workflows. ## API Version: 2025-01-29.alpha This documentation is for API version `2025-01-29.alpha`. ### Using this version ``` curl -X GET https://api.tomorro.com/members \ -H "x-api-key: YOUR_API_KEY" \ -H "tomorro-version: 2025-01-29.alpha" ``` version: 2025-01-29.alpha contact: {} servers: - url: https://api.tomorro.com/v2 description: Production - url: https://api.demo.tomorro.com/v2 description: Demo - url: http://localhost:3015 description: Local Development security: [] tags: [] paths: /members/{id}: patch: tags: - Members summary: Update member description: >- Updates an existing member's role, group assignments, or other properties. All fields are optional — only include the fields you want to change. operationId: MemberController_updateMember parameters: - name: id required: true in: path description: The unique identifier (UUID) of the member to update schema: example: 550e8400-e29b-41d4-a716-446655440000 type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/MemberUpdateDto' responses: '200': description: Updated member details content: application/json: schema: $ref: '#/components/schemas/MemberResponseDto' '400': description: Invalid request body '401': description: Unauthorized - Invalid or missing API key '403': description: Forbidden - Insufficient permissions '404': description: Member not found '429': description: Too Many Requests - Rate limit exceeded security: - X-API-KEY: [] components: schemas: MemberUpdateDto: type: object properties: role: type: string description: >- New role for the member. USER: Standard user. MANAGER: Can manage contracts. ADMIN: Full access. enum: - USER - MANAGER - ADMIN example: MANAGER status: type: string description: >- New status for the member. active: Can access the platform. disabled: Cannot access. pending: Awaiting invitation acceptance. enum: - active - disabled - pending example: active groupIds: description: >- List of group UUIDs to assign the member to. Replaces existing group assignments. example: - 550e8400-e29b-41d4-a716-446655440000 - 6ba7b810-9dad-11d1-80b4-00c04fd430c8 type: array items: type: string folderIds: description: >- List of folder UUIDs to assign the member to. Replaces existing folder assignments. example: - 550e8400-e29b-41d4-a716-446655440000 type: array items: type: string firstname: type: string description: First name of the member example: John lastname: type: string description: Last name of the member example: Doe email: type: string description: Email address of the member example: john.doe@example.com resendInvitation: type: boolean description: Resend invitation email to a pending member example: true substituteId: type: string description: UUID of a member to act as substitute (for out-of-office). format: uuid nullable: true example: 7c9e6679-7425-40de-944b-e07fc1f90ae7 MemberResponseDto: type: object properties: id: type: string description: Unique identifier for the member. example: 550e8400-e29b-41d4-a716-446655440000 role: type: string description: >- The role assigned to this member, which determines their permissions. - `USER`: Standard user with basic access to view and interact with contracts. - `MANAGER`: Can create, edit, and manage contracts and workflows. - `ADMIN`: Full administrative access including member management and organization settings. enum: - USER - MANAGER - ADMIN example: ADMIN status: type: string description: >- The current status of the member. - `active`: The member has accepted their invitation and can access the platform. - `disabled`: The member has been deactivated and cannot access the platform. - `pending`: The member has been invited but has not yet accepted. enum: - active - disabled - pending example: active user: description: The user account associated with this member. example: email: john.doe@example.com firstname: John lastname: Doe allOf: - $ref: '#/components/schemas/MemberUserResponseDto' groupIds: description: List of group UUIDs the member belongs to. example: - 550e8400-e29b-41d4-a716-446655440000 type: array items: type: string createdAt: format: date-time type: string description: >- Time at which the member was created. Formatted as an ISO 8601 date-time string. example: '2024-01-01T00:00:00.000Z' updatedAt: format: date-time type: string description: >- Time at which the member was last updated. Formatted as an ISO 8601 date-time string. example: '2024-01-02T00:00:00.000Z' required: - id - role - status - user - groupIds MemberUserResponseDto: type: object properties: email: type: string description: >- The email address of the user. This is used for login and communications. example: john.doe@example.com firstName: type: string description: The first name of the user. nullable: true example: John lastName: type: string description: The last name of the user. nullable: true example: Doe required: - email securitySchemes: X-API-KEY: type: apiKey in: header name: x-api-key description: >- API key for authentication. Get your key at https://app.tomorro.com/settings/integrations?integration=api-key ````