> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Owner

> Update an owner's email or name

Update an entry in the owner directory. Only the fields you send are changed, so you can rename an owner without resending their email. Use [List Owners](/api-reference/list-owners) to get the owner ID.

Changing an owner does not move the opportunities they hold. They keep the same owner, with new details.

## Path Parameters

<ParamField path="id" type="string" required>
  Owner UUID.
</ParamField>

## Body

<ParamField body="email" type="string">
  New email address. Must not already belong to another owner.
</ParamField>

<ParamField body="first_name" type="string">
  New first name.
</ParamField>

<ParamField body="last_name" type="string">
  New last name.
</ParamField>

## Response Fields

<ResponseField name="owner" type="object">
  The updated owner.
</ResponseField>

<ResponseField name="owner.id" type="string">
  Owner UUID.
</ResponseField>

<ResponseField name="owner.email" type="string">
  Email address.
</ResponseField>

<ResponseField name="owner.first_name" type="string">
  First name.
</ResponseField>

<ResponseField name="owner.last_name" type="string">
  Last name.
</ResponseField>

<ResponseField name="owner.avatar_url" type="string">
  Profile picture URL, empty when the owner has no picture.
</ResponseField>

<ResponseField name="owner.is_member" type="boolean">
  `true` when the owner is also a member of your workspace.
</ResponseField>

<ResponseField name="owner.opportunity_count" type="integer">
  How many opportunities this owner currently holds.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PUT "https://api.clustr-ai.com/api/public/owners/9c8e77d1-4b2a-4c8f-9a30-6e21d4f0aa57" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"first_name": "Samuel"}'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "owner": {
        "id": "9c8e77d1-4b2a-4c8f-9a30-6e21d4f0aa57",
        "email": "sam@northstar.vc",
        "first_name": "Samuel",
        "last_name": "Okafor",
        "avatar_url": "",
        "is_member": false,
        "opportunity_count": 3
      }
    }
  }
  ```

  ```json 404 theme={null}
  {
    "success": false,
    "error": { "message": "Owner not found", "code": "NOT_FOUND" }
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": { "message": "Invalid or missing API key", "code": "UNAUTHORIZED" }
  }
  ```
</ResponseExample>