Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Keygen Policies API

Licensing rules that govern licenses.

Keygen Policies API is one of 12 APIs that Keygen publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Policies. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 5 operations across 2 paths, and defines 6 schemas. It is described by OpenAPI 3.0.3, at version 1.0.

Requests are made against a single base URL, https://api.keygen.sh/v1/accounts/{account}.

5 operations 2 paths 6 schemas 1 DELETE2 GET1 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0
Base URL
https://api.keygen.sh/v1/accounts/{account}
Authentication
HTTP Bearer, HTTP Bearer, HTTP Basic
Terms of Service
Resource Areas
1

Authentication & Security 3

Keygen Policies API declares 3 security schemes for authenticating requests. It accepts HTTP bearer tokens (token) (bearerAuth). It accepts HTTP bearer tokens (license-key) (licenseKeyAuth). It accepts HTTP basic authentication (basicAuth). By default, every request must be authenticated.

  • bearerAuth — Admin, environment, product, user, or license bearer token in the Authorization: Bearer header.
  • licenseKeyAuth — A license key passed as Authorization: License for license validation and self-service actions.
  • basicAuth — HTTP Basic (email:password) used only to generate a user token.

Paths & Operations 5

Across 2 paths, the API surfaces 5 operations — 1 DELETE, 2 GET, 1 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Policies 5

Licensing rules that govern licenses.

POST
/policies
Create a policy
createPolicy body → 201
GET
/policies
List all policies
listPolicies → 200
GET
/policies/{id}
Retrieve a policy
retrievePolicy 1 param → 200
PATCH
/policies/{id}
Update a policy
updatePolicy 1 param → 200
DELETE
/policies/{id}
Delete a policy
deletePolicy 1 param → 204

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are PageLinks (5 properties), PolicyResource (4 properties), ResourceIdentifier (2 properties), PolicyCollectionDocument (2 properties). Each schema is shown below with its type and property counts.

PolicyResource
object
4 properties
PolicyDocument
object
1 property
Relationship
object
2 properties
PolicyCollectionDocument
object
2 properties
ResourceIdentifier
object
2 properties 2 required
PageLinks
object
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

keygen-policies-api-openapi.yml Raw ↑

Other APIs Keygen publishes across the network.

Keygen Artifacts API
Keygen Components API
Keygen Entitlements API
Keygen Licenses API
Keygen Machines API
Keygen Processes API
Keygen Products API
Keygen Releases API
Keygen Tokens API
Keygen Users API
Keygen Webhooks API