---
title: "Activates a license key."
method: POST
path: "/v1/licenses/activate"
tags: ["Licenses"]
---

# Activates a license key.

`POST /v1/licenses/activate`

Activate a license key for a specific device or instance. Register new activations and track usage limits.

## Request body

- ActivateLicenseRequestEntity
  - `key` string, required — The license key to activate.
  - `instance_name` string, required — A label for the new instance to identify it in Creem.

## Response `200`

Successfully activated a license key

- LicenseEntity
  - `id` string, required — Unique identifier for the object.
  - `mode` 'test' | 'prod' | 'sandbox', required — String representing the environment.
  - `object` string, required — A string representing the object's type. Objects of the same type share the same value.
  - `product_id` string, required — The ID of the product this license belongs to.
  - `status` 'inactive' | 'active' | 'expired' | 'disabled', required — The current status of the license key.
  - `key` string, required — The license key.
  - `activation` number, required — The number of instances that this license key was activated.
  - `activation_limit` number, nullable — The activation limit. Null if activations are unlimited.
  - `expires_at` string, date-time, nullable — The date the license key expires. Null if it does not have an expiration date.
  - `created_at` string, date-time, required — The creation date of the license key.
  - `instance` LicenseInstanceEntity
    - `id` string, required — Unique identifier for the object.
    - `mode` 'test' | 'prod' | 'sandbox', required — String representing the environment.
    - `object` string, required — A string representing the object’s type. Objects of the same type share the same value.
    - `name` string, required — The name of the license instance.
    - `status` 'active' | 'deactivated', required — The status of the license instance.
    - `created_at` string, date-time, required — The creation date of the license instance.

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing API key
- `404` — Not Found - Resource does not exist

---

[API](https://skmtc.net/creem/apis/creem-api.md) · [All operations](https://skmtc.net/creem/apis/creem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/creem/creem-api/versions/aa593160d96c/schema)