Changes the name of a vehicle group of the organization the API key belongs to, and returns the group.
Input. groupId in the path. name in the body: 1 to 100 characters once leading and trailing spaces are removed, and different from the name of every other vehicle group of the organization that created the group, ignoring case. A group may take its own name again, in another case.
Response. 200 with the renamed group.
Notes. The organization must have created the group, or have the admin role on a group another organization shares with it; otherwise 403. Delete a vehicle group has the same rule. A name that is already used answers 409 with code: VEHICLE_GROUP_NAME_EXISTS.
Side effects. The group is sent again to the Cores that use it. Undo with another rename.
Request examples
PUT /v1/vehicle-api/groups/6512bd43d9caa6e02c990b0a
{ "name": "Contractors" }| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
400groupId is not a 24-character id, or name is missing, empty or longer than 100 characters.
401Missing or invalid API key.
403Another organization shares the vehicle group with this one without the admin role.
404Vehicle group not found in this organization.
429Too many requests. Try again later.
500Internal server error.
