---
title: "Share a vehicle with a user"
method: POST
path: "/api/v1/vehicles/{vehicleId}/users"
tags: ["Vehicles"]
---

# Share a vehicle with a user

`POST /api/v1/vehicles/{vehicleId}/users`

Required scope: `vehicles:write`. Shares the vehicle with the given user. The user must belong to the vehicle's team or already be a shared user. Idempotent.

## Path parameters

- `vehicleId` integer, required

## Query parameters

- `page` integer
- `perPage` integer

## Request body

- AddVehicleUser
  - `userId` integer, required — Id of the user to share the vehicle with. Must belong to the vehicle's team or already be a shared user.

## Response `200`

Updated list of users the vehicle is shared with

- OffsetBasedResponse44
  - `data` VehicleUser[], required
    - `id` integer — Id of the user the vehicle is shared with
    - `owner` boolean — Whether this user is the owner of the vehicle
    - `name` string, nullable — Display name of the user
    - `profileImageUrl` string, nullable — Profile image URL of the user
  - `meta` MontaPageMeta, required
    - `itemCount` integer, required
    - `currentPage` integer, required
    - `perPage` integer, required
    - `totalPageCount` integer, required
    - `totalItemCount` integer, required

## Other responses

- `400` — The request is invalid
- `401` — Consumer with provided credentials was not found
- `403` — Operator doesn't have access to resource
- `404` — Entity with the provided id was not found

---

[API](https://skmtc.net/monta/apis/monta-partner-api.md) · [All operations](https://skmtc.net/monta/apis/monta-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monta/monta-partner-api/revisions/517e18f11015/schema)