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

# Edit Member

> Update properties of an existing member.

Update one or more properties of an existing member. You can modify profile information, status, role, team assignments, working hours, preferences, and more.

### REQUEST

```shell theme={null}
POST https://api.hellotracks.com/api/editaccount

{
   "data": {
      "account": "worker@company.com",
      "status_label": "Available",
      "phone": "+14155551234",
      "email": "newemail@company.com",
      "name": "Updated Name",
      "role": "dispatcher",
      "teams": [1, 2, 3],
      "vehicle_capacity": 500,
      "color": "#FF5733"
   }
}
```

### Identifying the Member

<ParamField body="account" type="string">
  **One of `account` or `uid` is required** to identify which member to edit.

  The username (email) of the member to edit.

  Example: `"worker@company.com"`
</ParamField>

<ParamField body="uid" type="string">
  **One of `account` or `uid` is required** to identify which member to edit.

  The unique identifier of the member to edit. Alternative to `account`.

  Example: `"abc123"`
</ParamField>

### Editable Properties

You can update writable fields from the [Member API Object](/api-reference/member-object). Common editable properties include:

#### Core Information

* `name` - Full name
* `phone` - Phone number
* `email` - Email address
* `color` - Display color (hex format)

#### Role & Permissions

* `role` - User role: "worker", "operator"/"dispatcher", or "administrator"
* `teams` - Array of team numbers (integers)

#### Status & Availability

* `status_label` - Custom status text (e.g., "Available", "On break")

#### Vehicle & Capacity

* `vehicle_capacity` - Vehicle capacity (weight/volume)
* `travel_mode` - "car", "bicycle", "pedestrian", "truck", "van", "motorcycle"

#### Working Hours

* `working_hours` - Object with day-specific schedules. Include all seven day keys (`monday` through `sunday`) when updating.
* `working_hours_overrides` - Date-specific working-hours overrides
* `ignore_working_hours_until_ts` - Temporary availability override

#### Route & Navigation

* `route_start_lat`, `route_start_lng` - Daily route start location
* `route_end_lat`, `route_end_lng` - Daily route end location
* `route_start_time` - Daily start time in minutes from midnight

#### Preferences

* `unit_distance` - "SI" (metric) or "US" (imperial)
* `unit_time` - "12" or "24" hour format
* `unit_date` - Date format string (e.g., "dd.MM.yyyy", "MM/dd/yyyy")
* `timezone` - Timezone string (e.g., "America/New\_York")
* `language` - Language code (e.g., "en", "de", "fr")

#### Skills & Capabilities

* `skills` - Array of skill tags for job matching
* `expertise` - Expertise level or specialty

See the [Member API Object](/api-reference/member-object) for the complete list of 55+ properties and their descriptions.

### Permissions

* **Administrators:** Can edit all members
* **Dispatchers:** Can edit workers (limited permissions)
* **Workers:** Can only edit their own profile (limited fields)
* You must have appropriate permissions for the target member

### RESPONSE

```shell theme={null}
{
  "status": 0,
  "account": {
    "uid": "abc123",
    "username": "worker@company.com",
    "name": "Updated Name",
    "status_label": "Available",
    // ... complete updated member object
  }
}
```

<ResponseField name="status" type="integer" required>
  Status code. `0` indicates success.
</ResponseField>

<ResponseField name="account" type="object">
  Updated member object with all current properties. May be `null` if member was not found or no changes were made.

  See the [Member API Object](/api-reference/member-object) for complete structure.
</ResponseField>

### Examples

<RequestExample>
  ```bash Update Status Label theme={null}
  curl -X POST https://api.hellotracks.com/api/editaccount \
    --header 'API-Key: YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    -d '{
      "data": {
        "account": "worker@company.com",
        "status_label": "On Lunch Break"
      }
    }'
  ```

  ```bash Assign to Teams theme={null}
  curl -X POST https://api.hellotracks.com/api/editaccount \
    --header 'API-Key: YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    -d '{
      "data": {
        "uid": "abc123",
        "teams": [1, 2, 5],
        "role": "worker"
      }
    }'
  ```

  ```bash Update Contact Info theme={null}
  curl -X POST https://api.hellotracks.com/api/editaccount \
    --header 'API-Key: YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    -d '{
      "data": {
        "account": "worker@company.com",
        "name": "John Smith",
        "phone": "+14155559999",
        "email": "john.smith@company.com"
      }
    }'
  ```

  ```bash Set Working Hours theme={null}
  curl -X POST https://api.hellotracks.com/api/editaccount \
    --header 'API-Key: YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    -d '{
      "data": {
        "uid": "abc123",
        "working_hours": {
          "monday": {"start": 480, "end": 1020},
          "tuesday": {"start": 480, "end": 1020},
          "wednesday": {"start": 480, "end": 1020},
          "thursday": {"start": 480, "end": 1020},
          "friday": {"start": 480, "end": 1020},
          "saturday": {"start": 0, "end": 0},
          "sunday": {"start": 0, "end": 0}
        }
      }
    }'
  ```
</RequestExample>

<Note>
  **Partial Updates:** Only include the fields you want to change. Omitted fields will remain unchanged.
</Note>

<Note>
  **Complete Field Reference:** See the [Member API Object](/api-reference/member-object) for documentation of all editable properties, their types, valid values, and descriptions.
</Note>

### Related Endpoints

* [Get Members](/api-reference/endpoint/getaccounts) - Retrieve member information
* [Create Member](/api-reference/endpoint/createaccount) - Add new members
* [Delete Member](/api-reference/endpoint/deleteaccount) - Remove members