> ## Documentation Index > Fetch the complete documentation index at: https://docs.lighton.ai/llms.txt > Use this file to discover all available pages before exploring further. # Partially update a company member > This endpoint allows to update a specific company member by ID. **PUT:** Requires all fields (first_name, last_name, account_expiration_date, language). **PATCH:** Allows partial updates - only provide the fields you want to change. **Permissions:** - Admin, SysAdmin, Account Manager: can update any user - Company Admin: can update users from their own company only **Throttling:** 60 requests per minute It is API Key protected and restricted to users with appropriate permissions. ## OpenAPI ````yaml /api-reference/openapi-v3.yaml patch /api/v3/users/{id} openapi: 3.1.0 info: title: LightOn API version: 3.15.0 (v3) description: >- LightOn gives you an API to search, parse, and ingest documents at scale. Build knowledge-retrieval pipelines without managing vector databases or OCR models. servers: - url: https://paradigm.lighton.ai security: [] tags: - name: Agents description: Operations about agents - name: Threads description: Operations about agents conversation threads - name: Tools description: Operations about native tools - name: Models description: Operations about AI models - name: MCP description: Operations about MCP servers - name: Sources description: Operations about sources used by agents conversation threads - name: Artifacts description: Operations about artifacts generated by agents conversation threads - name: Agent description: >- Operations about agents (deprecated). Please use the 'Agents' API component instead. - name: Files description: Operations about files - name: Facets description: Operations about facets - name: Tags description: Operations about tags - name: Workspaces description: Operations about workspaces - name: Files Processing description: Operations about files processing - name: Users description: Operations about users - name: API Keys description: Operations about API keys - name: User Groups description: Operations about user groups - name: SCIM description: Operations about SCIM paths: /api/v3/users/{id}: patch: tags: - Users summary: Partially update a company member description: >- This endpoint allows to update a specific company member by ID. **PUT:** Requires all fields (first_name, last_name, account_expiration_date, language). **PATCH:** Allows partial updates - only provide the fields you want to change. **Permissions:** - Admin, SysAdmin, Account Manager: can update any user - Company Admin: can update users from their own company only **Throttling:** 60 requests per minute It is API Key protected and restricted to users with appropriate permissions. operationId: api_v3_users_partial_update parameters: - in: path name: id schema: type: integer required: true requestBody: content: application/json: schema: $ref: >- #/components/schemas/PatchedUpdateCompanyMemberRequestSerializerV3 application/x-www-form-urlencoded: schema: $ref: >- #/components/schemas/PatchedUpdateCompanyMemberRequestSerializerV3 multipart/form-data: schema: $ref: >- #/components/schemas/PatchedUpdateCompanyMemberRequestSerializerV3 responses: '200': content: application/json: schema: $ref: '#/components/schemas/CompanyMemberResponse' description: Company member updated successfully '401': content: application/json: schema: $ref: '#/components/schemas/APIV3ErrorResponse' examples: Unauthorized: value: id: null code: 401 error: unauthorized detail: >- Authentication credentials were not provided or are invalid. doc_url: https://developers.lighton.ai/errors#unauthorized description: Authentication credentials were not provided or are invalid '403': description: >- Permission denied - insufficient rights to update this company member '422': content: application/json: schema: $ref: '#/components/schemas/APIV3ValidationErrorResponse' examples: ValidationError: value: id: null code: 422 error: validation_error detail: One or more fields failed validation. doc_url: https://developers.lighton.ai/errors#validation_error fields: : - error: required detail: This field is required. summary: Validation Error description: Request body is valid JSON but one or more fields failed validation '500': content: application/json: schema: $ref: '#/components/schemas/APIV3ErrorResponse' examples: InternalServerError: value: id: null code: 500 error: internal_server_error detail: An unexpected error occurred. Please try again later. doc_url: https://developers.lighton.ai/errors#internal_server_error summary: Internal Server Error description: An unexpected error occurred '503': description: >- API is under maintenance. Check `GET /api/v3/system/status` for active periods and retry. content: application/json: schema: $ref: '#/components/schemas/ServiceMaintenance503' security: - bearerAuth: [] components: schemas: PatchedUpdateCompanyMemberRequestSerializerV3: type: object properties: first_name: type: string description: The first name of the user. last_name: type: string description: The last name of the user. account_expiration_date: type: string format: date-time description: The account expiration date and time with timezone. language: allOf: - $ref: '#/components/schemas/PreferredLanguageEnum' description: |- The preferred language of the user. * `ar` - Arabic * `en` - English * `fr` - French * `de` - German CompanyMemberResponse: type: object properties: id: type: integer username: type: string first_name: type: string last_name: type: string email: type: string is_active: type: boolean date_joined: type: string format: date-time account_expiration_date: type: string format: date-time last_login: type: string format: date-time invitation_status: type: string language: type: string company: $ref: '#/components/schemas/CompanyMemberCompany' roles: type: array items: $ref: '#/components/schemas/TenantUserRole' groups: type: array items: $ref: '#/components/schemas/CompanyMemberGroups' required: - account_expiration_date - company - date_joined - email - first_name - groups - id - invitation_status - is_active - language - last_login - last_name - roles - username APIV3ErrorResponse: type: object properties: id: type: - string - 'null' description: >- Job/resource id when one already exists (useful for async error diagnosis); null otherwise. code: type: integer description: HTTP status code error: type: string description: Error code used by the UI as a translation key detail: type: string description: Human-readable error message for developers doc_url: type: string description: Link to the error-code documentation page required: - code - detail - doc_url - error - id APIV3ValidationErrorResponse: type: object properties: id: type: - string - 'null' description: >- Job/resource id when one already exists (useful for async error diagnosis); null otherwise. code: type: integer description: HTTP status code error: type: string description: Error code used by the UI as a translation key detail: type: string description: Human-readable error message for developers doc_url: type: string description: Link to the error-code documentation page fields: type: object additionalProperties: type: array items: $ref: '#/components/schemas/APIV3FieldError' description: Field-level validation errors keyed by field name required: - code - detail - doc_url - error - id ServiceMaintenance503: type: object description: >- Returned by the maintenance middleware when the requested endpoint is blocked. required: - detail - error - mode properties: detail: type: string example: System is under maintenance. error: type: string example: service_maintenance mode: type: string enum: - full_shutdown - warning_banner description: >- `full_shutdown` blocks all traffic; `warning_banner` also blocks and shows a dismissible toast. reason: type: string description: Operator-supplied maintenance reason, if any. started_at: type: string format: date-time endpoint_category_names: type: array items: type: string description: >- Non-empty only for category-scoped periods. Empty means all endpoints are affected. PreferredLanguageEnum: enum: - ar - en - fr - de type: string description: |- * `ar` - Arabic * `en` - English * `fr` - French * `de` - German CompanyMemberCompany: type: object properties: name: type: string id: type: integer required: - id - name TenantUserRole: type: object properties: name: type: string id: type: integer required: - id - name CompanyMemberGroups: type: object properties: id: type: integer name: type: string description: type: string role: type: string category: type: string created_at: type: string format: date-time required: - category - created_at - description - id - name - role APIV3FieldError: type: object properties: error: type: string description: Error code / translation key detail: type: string description: Human-readable description of the field error required: - detail - error securitySchemes: bearerAuth: type: http scheme: bearer description: >- Bearer authentication header of the form `Bearer `, where `` is your auth token. ````