---
title: "Grant User License"
method: POST
path: "/v1/users/{id}/licenses"
tags: ["Licenses"]
---

# Grant User License

`POST /v1/users/{id}/licenses`

Grants a license to a user from a specified subscription. If the user already has a license on the given subscription, the existing license is returned.

## Path parameters

- `id` integer, required

## Request body

- GrantLicenseRequest — Request body for granting a license to a user
  - `subscriptionId` string, uuid, required — The subscription ID to grant the license from

## Response `201`

Created. Returns the granted license, or the existing license if the user already has one on this subscription.

- License — A license resource representing a user's license on a subscription
  - `userId` integer, required — User ID
  - `subscriptionId` string, uuid, required — Subscription ID
  - `created` string, date-time, required — Date and time when the license was granted

## Other responses

- `403` — Forbidden. Occurs when the user is not authorized to grant licenses.
- `409` — Conflict. Occurs when there are no available licenses to grant, or the user is restricted from being granted a license.

---

[API](https://skmtc.net/lucid/apis/lucid-rest-api.md) · [All operations](https://skmtc.net/lucid/apis/lucid-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lucid/lucid-rest-api/revisions/6a32cb9e1aa7/schema)