> ## 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@example.com",
      "status_label": "Available",
      "phone": "+14155551234",
      "email": "newemail@example.com",
      "name": "Updated Name",
      "role": "dispatcher",
      "teams": [1, 2, 3],
      "vehicle_capacity": 500,
      "color": "#FF5733"
   }
}
```

### Identifying the Member

**account** `string`

**One of `account` or `uid` is required** to identify which member to edit.

The username (email) of the member to edit.

Example: `"worker@example.com"`

**uid** `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"`

### Editable Properties

You can update writable fields from the [Member API Object](https://api-docs.hellotracks.com/api-reference/member-object.md). 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 as HHMM (e.g., 800 = 8:00 AM)

#### 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](https://api-docs.hellotracks.com/api-reference/member-object.md) 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@example.com",
    "name": "Updated Name",
    "status_label": "Available",
    // ... complete updated member object
  }
}
```

**status** `integer` *required*

Status code. `0` indicates success.

**account** `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](https://api-docs.hellotracks.com/api-reference/member-object.md) for complete structure.

### Examples

```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@example.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@example.com",
      "name": "John Smith",
      "phone": "+14155559999",
      "email": "john.smith@example.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": 800, "end": 1700},
        "tuesday": {"start": 800, "end": 1700},
        "wednesday": {"start": 800, "end": 1700},
        "thursday": {"start": 800, "end": 1700},
        "friday": {"start": 800, "end": 1700},
        "saturday": {"start": 0, "end": 0},
        "sunday": {"start": 0, "end": 0}
      }
    }
  }'
```

> [!NOTE]
>
> **Partial Updates:** Only include the fields you want to change. Omitted fields will remain unchanged.

> [!NOTE]
>
> **Complete Field Reference:** See the [Member API Object](https://api-docs.hellotracks.com/api-reference/member-object.md) for documentation of all editable properties, their types, valid values, and descriptions.

### Related Endpoints

* [Get Members](https://api-docs.hellotracks.com/api-reference/endpoint/getaccounts.md) - Retrieve member information
* [Create Member](https://api-docs.hellotracks.com/api-reference/endpoint/createaccount.md) - Add new members
* [Delete Member](https://api-docs.hellotracks.com/api-reference/endpoint/deleteaccount.md) - Remove members


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.