Teams API

Use Teams API to create and update organization teams. Teams help you organize users and assets inside an organization, apply role scopes, and control operational context such as location, timezone, and meter-increase limits.

📄️ List teams

Lists teams in the current organization. Returns a paginated response only when the `page` query parameter is provided.

📄️ Create a team

Creates a team in the current organization.

📄️ Get a team

Returns a team in the current organization by ID, including available timezone options for team settings.

📄️ Update a team

Updates a team in the current organization.

📄️ Delete a team

Deletes a team from the current organization. The default team cannot be deleted. When a non-default team is deleted, its assets (cars) are moved to the organization's default team.

📄️ Add users to a team

Adds users to a team in the current organization. The `users` field is a map where each key is a user ID and each value is the role ID to assign in the team. This updates team-level membership and team-level roles only; it does not change a user's global organization role.

📄️ Remove users from a team

Removes users from a team in the current organization. This removes the user's membership and role in that team only; it does not change the user's global organization role.

📄️ Add assets (cars) to a team

Adds assets (cars) to a team in the current organization. Provide a list of asset (car) IDs in `cars`. When an asset is added to a non-default team, the API removes that asset from the organization's default team if it is currently assigned there.

📄️ Remove assets (cars) from a team

Removes assets (cars) from a team in the current organization. Provide a list of asset (car) IDs in `cars`. If removing an asset would leave it with no team assignments, the API adds it back to the organization's default team.