---
title: "Give a member a VTC role"
method: PUT
path: "/vtcs/{id}/management/members/{userId}/roles/{roleId}"
tags: ["VTC Management"]
---

# Give a member a VTC role

`PUT /vtcs/{id}/management/members/{userId}/roles/{roleId}`

## Request

- Base URL: `https://api.trucklinemp.com`
- URL: `https://api.trucklinemp.com/vtcs/{id}/management/members/{userId}/roles/{roleId}`
- Auth: HTTP bearer

Idempotent: giving a role the member already has does nothing. The key's creator can only hand out roles whose permissions they hold, and a member can hold at most 10 roles. Fires `vtc.member_role_changed`. Needs the write scope `management.roles.manage`.

## Path parameters

- `id` string, required: VTC id or handle.
- `userId` string, required
- `roleId` integer, required

## Response `200`

OK

- object
  - `userId` string, required
  - `roleId` number, required
  - `assigned` boolean, required

## Changes

- **2026-10-11** `f480df65298f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trucklinemp/apis/trucklinemp-public-api/changes/vtcs/:id/management/members/:userId/roles/:roleId/put.md)

---

[API](https://skmtc.dev/trucklinemp/apis/trucklinemp-public-api.md) - [All operations](https://skmtc.dev/trucklinemp/apis/trucklinemp-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trucklinemp/apis/trucklinemp-public-api/revisions/98fe7178ea0e?raw)
