Changelog

2020

FEB

FEATURE Add expiry attribute to user and admin token generation endpoint, allowing you to specify when/if a given token expires.

2019

DEC

FEATURE Update activation token permissions to be able to increment license usage (useful for incrementing usage in a client-side environment without an intermediary server).
FEATURE Add unassigned filter to licenses list endpoint.
FEATURE Add meta.tokenId to profile endpoint, containing the ID of the API token being used for the request.
FEATURE Add "whoami" headers to all responses: X-Keygen-Account-Id, X-Keygen-Bearer-Id, X-Keygen-Token-Id, representing the current account, the current user making the request, and the user's API token being used for the request, respectively.

NOV

FEATURE Add nonce parameter to license validation endpoints (which is then echoed back within the signed response body).

JUL

FEATURE Add additional rate limit headers: X-RateLimit-Window for the closest rate limiting window to being reached, X-RateLimit-Count for the request count within the current rate limiting window.
FIX Fix issue where machine deactivation was queued and performed asynchronously, which sometimes caused subsequent requests to the machines list endpoint to include the aforementioned deactivated machine (due to the deactivation process being async).

JUN

FIX Fix issue where the expired filter for the license list endpoint would not include licenses without an expiry when expired=false.
FEATURE Add ability to use a machine's fingerprint attribute within URL params in place of its ID (grated the fingerprint is a valid URL param).

MAY

FEATURE Add machine heartbeat system.
FEATURE Add active filter to users list endpoint.

APR

FEATURE Add license validation meta, which includes the validation result, to payloads of license.validation.* webhook events.
FEATURE Add expired filter to licenses list endpoint.

MAR

FEATURE Add ability for admins to manually update a user's password.
FEATURE Add total pages and resource count to pagination meta.

2018

DEC

FEATURE Add current timestamp to validation response: meta.ts.
FEATURE Add /v1/ping endpoint. Useful for testing if the Keygen API is reachable, e.g. firewall issues, lack of internet access, etc.
FEATURE Add support for webhook endpoints to subscribe to specific webhook events.

NOV

FEATURE Add request logging.

OCT

FEATURE Add support for named licenses.

SEP

FEATURE Add support for offline licensing using cryptographically signed/encrypted license keys.
FIX Fix issue causing some Accept headers to result in an HTTP 400 Bad Request response code.
FEATURE Add helpful error response and specific error code for requests containing: invalid JSON, invalid tokens, invalid encodings.
FIX Fix issue where machines without a user associated with it could contain invalid relationships.user linkage.
FEATURE Add ip and hostname filters to machines list endpoint.

AUG

FEATURE Add "protected" permission system to licenses.
FEATURE Add better debugging tools for webhook event delivery failures.

JUL

FIX Update license validation precedences, resolving an issue where machine-related validation-result codes would sometimes take precedence over invalid license state, such as the license being expired or suspended.
FEATURE Add policy filter to machines list endpoint.
FEATURE Add machine count to license payloads: relationships.machines.meta.count.

JUN

FEATURE Add permission for activation tokens to read machines of the license it belongs to.
FEATURE Add permission for activation tokens to validate the license it belongs to.
FIX Fix issue where password reset expiration date was incorrect within the email delivered to the user.

MAY

FIX Fix issue where regenerated tokens had an incorrect expiry value (was adding 2 weeks to the current expiry, when it should have been adding 2 weeks from the current datetime).
FIX Fix issue where license expiry could not be removed.
FEATURE Add ability to limit machine activation and deactivation counts for activation tokens.
FEATURE Update API token algorithm to v2.
FEATURE Add support for more detailed error pointers for resource relationship-related errors.
FIX Fix issue where a machine could be activated even after reaching the activation token's activation limit.
FIX Fix issue where nextCheckIn would display a non-null value for non-check-in licenses.

APR

FEATURE Add activation token support, allowing client-side machine activation workflows.
FEATURE Add search feature to the Dashboard.
FEATURE Add ability to delete webhook events for compliance.
FEATURE Add last response body and code to webhook events to aid in developer debugging.
FEATURE Add additional error codes to failed webhook events, e.g. DNS issues, request timeout, etc. to aid in developer debugging.
FEATURE Add ability to use a user's email attribute within URL params in place of their ID.

MAR

FEATURE Add X-Signature header to all API responses (signed using RSA cryptography).
FEATURE Add X-Signature header to webhook event delivery requests.
FEATURE Add webhook events for license expiration lifecycle: license.expiring-soon, license.expired.
FEATURE Add license usage count system.
FEATURE Add meta.increment and meta.decrement params for adjusting increment/decrement amount.
FEATURE Add ability for a license to transfer between users.

JAN

FEATURE Update behavior around Accept header to respond with a application/json content-type when requested, rather than always responding with application/vnd.api+json.
FEATURE Add ability for a license to transfer between policies.
FEATURE Add concurrent license support.
LAUNCH Add our distribution API, Keygen Dist, to the interwebs. 🎊

2017

DEC

FEATURE Add support for meta.scope to license validation endpoints.
FEATURE Add ability to use a license's key attribute within URL params in place of its ID (grated the key is a valid URL param).

NOV

FEATURE Add webhook event for password resets (for manual fulfillment).

OCT

FEATURE Add maxMachines attribute to license payload.
FEATURE Add validation result code to license validation payload meta.

MAY

FEATURE Add license check-in system.
FEATURE Add webhook events for license validations: license.validation.succeeded, license.validation.failed.

APR

FIX Fix issue where a duplicate license key could be created for an account (i.e. 2 licenses with the same key).
FEATURE Update product token permissions to read all users and webhook events to aid in server-side integrations.
FEATURE Add strict attribute to policies to remove the "hard" machine limit.
FEATURE Update floating attribute default value to false for policies.
FEATURE Update maxMachines attribute default value to 1 for policies.
FEATURE Add "protected" permission system to policies.

FEB

FEATURE Add validation detail message to license validation payload meta.
FEATURE Add events[] filter to webhook events list endpoint.

JAN

FEATURE Add action to suspend and reinstate licenses.
FEATURE Add suspended filter to licenses list endpoint.
FEATURE Add account-related webhook events, e.g. account.updated, account.billing.updated, etc.
FEATURE Add JSON-API linkage to singular relationships within response payloads.
FIX Fix issue where rate limited response used incorrect JSON content type.
FEATURE Add product filter to keys list endpoint.
FEATURE Allow user metadata attribute to be specified during user creation for non-authenticated requests.
FEATURE Add support for specifying your own license key attribute during license creation.
FEATURE Add v1 version suffix to API tokens.
FEATURE Add "protected" permission system to accounts.
LAUNCH Add the Keygen Dashboard to the interwebs. 🍻

2016

DEC

FEATURE Add idempotency token to webhook events.
FEATURE Add status to webhook events.

NOV

FEATURE Add webhook system.

OCT

LAUNCH Add our licensing API, Keygen, to the interwebs. 🎉