> ## Documentation Index > Fetch the complete documentation index at: https://docs.stardex.com/llms.txt > Use this file to discover all available pages before exploring further. # Update client contact > Update a client contact's status, owners, or both. Omitted fields remain unchanged; at least one of `client_contact_status_id` or `owner_ids` is required. **ID**: Accepts a client contact UUID or a person UUID — if a person UUID is provided, the associated client contact is resolved automatically. **Status**: Pass a valid status UUID to change the status, or null to clear it. Use GET /v1/client-contacts/statuses to discover available status IDs. **Owners**: Pass `owner_ids` to set the client contact owners. The list replaces all current owners; pass an empty array to remove every owner. Get team member IDs from GET /v1/team-members. ## OpenAPI ````yaml /api-reference/openapi-v1.json patch /v1/client-contacts/{id} openapi: 3.1.0 info: title: Stardex API (v1) version: 1.0.0 description: >- Stardex ATS API — manage candidates, jobs, companies, and recruiting workflows. servers: - url: https://api.stardex.ai description: Production API server security: - bearerAuth: [] tags: - name: Persons description: Manage person records — contacts, work history, and custom fields. - name: Jobs description: Manage job postings — pipeline stages, team members, and custom fields. - name: Candidates description: Manage candidate records and pipeline stage transitions. - name: Companies description: Browse and retrieve company records. - name: Lists description: Create, search, and retrieve saved person and company lists. - name: Person Activities description: Create and manage activity records (notes, emails, meetings) for persons. - name: Team Members description: List team members for use in search filters and assignments. - name: Custom Fields description: Retrieve custom field definitions and tag options for search filters. paths: /v1/client-contacts/{id}: patch: tags: - Client Contacts summary: Update client contact description: >- Update a client contact's status, owners, or both. Omitted fields remain unchanged; at least one of `client_contact_status_id` or `owner_ids` is required. **ID**: Accepts a client contact UUID or a person UUID — if a person UUID is provided, the associated client contact is resolved automatically. **Status**: Pass a valid status UUID to change the status, or null to clear it. Use GET /v1/client-contacts/statuses to discover available status IDs. **Owners**: Pass `owner_ids` to set the client contact owners. The list replaces all current owners; pass an empty array to remove every owner. Get team member IDs from GET /v1/team-members. operationId: updateClientContact parameters: - in: path name: id required: true schema: type: string description: Client contact UUID or person UUID. requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateClientContactRequest' responses: '200': description: Client contact updated content: application/json: schema: $ref: '#/components/schemas/UpdateClientContactResponse' example: success: true data: id: ab12cd34-ef56-7890-ab12-cd34ef567890 client_contact_status_id: 890e1234-f56a-78b9-c012-345678901234 owner_ids: - ddd44444-eeee-ffff-0000-111111114444 - eee55555-ffff-0000-1111-222222225555 message: Client contact updated successfully '400': description: Validation error content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error '404': description: Resource not found content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error '500': description: Internal server error content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error components: schemas: UpdateClientContactRequest: type: object properties: client_contact_status_id: type: - string - 'null' format: uuid description: >- Client contact status UUID, or null to clear the status. Omit to leave the status unchanged. Use GET /v1/client-contacts/statuses to get available status IDs. owner_ids: type: array items: type: string format: uuid description: >- Team member UUIDs to set as the client contact owners. Replaces all current owners. Pass an empty array to remove all owners. Omit to leave owners unchanged. Get IDs from GET /v1/team-members. UpdateClientContactResponse: type: object properties: success: type: boolean enum: - true data: type: object properties: id: type: string format: uuid description: Client contact UUID. client_contact_status_id: type: - string - 'null' format: uuid description: Client contact status UUID after the update. owner_ids: type: array items: type: string format: uuid description: Team member UUIDs assigned as owners after the update. message: type: string description: Confirmation message. required: - id - client_contact_status_id - owner_ids - message required: - success - data securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Authenticate with a Bearer token: API key, OAuth token, or session token. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.