{ "opencollection": "1.0.0", "info": { "name": "Keygen Artifacts Licenses API", "version": "1.0" }, "request": { "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "items": [ { "info": { "name": "Licenses", "type": "folder" }, "items": [ { "info": { "name": "List all licenses", "type": "http" }, "http": { "method": "GET", "url": "https://api.keygen.sh/v1/accounts/{account}/licenses", "params": [ { "name": "page[size]", "value": "", "type": "query", "description": "Number of resources per page (1-100)." }, { "name": "page[number]", "value": "", "type": "query", "description": "The page of resources to return." }, { "name": "status", "value": "", "type": "query", "description": "Filter by license status." } ] }, "docs": "List all licenses" }, { "info": { "name": "Create a license", "type": "http" }, "http": { "method": "POST", "url": "https://api.keygen.sh/v1/accounts/{account}/licenses", "body": { "type": "json", "data": "{}" } }, "docs": "Create a license" }, { "info": { "name": "Retrieve a license", "type": "http" }, "http": { "method": "GET", "url": "https://api.keygen.sh/v1/accounts/{account}/licenses/:id", "params": [ { "name": "id", "value": "", "type": "path", "description": "The identifier (UUID) of the resource." } ] }, "docs": "Retrieve a license" }, { "info": { "name": "Update a license", "type": "http" }, "http": { "method": "PATCH", "url": "https://api.keygen.sh/v1/accounts/{account}/licenses/:id", "params": [ { "name": "id", "value": "", "type": "path", "description": "The identifier (UUID) of the resource." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Update a license" }, { "info": { "name": "Delete a license", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.keygen.sh/v1/accounts/{account}/licenses/:id", "params": [ { "name": "id", "value": "", "type": "path", "description": "The identifier (UUID) of the resource." } ] }, "docs": "Delete a license" }, { "info": { "name": "Validate a license (by ID)", "type": "http" }, "http": { "method": "POST", "url": "https://api.keygen.sh/v1/accounts/{account}/licenses/:id/actions/validate", "params": [ { "name": "id", "value": "", "type": "path", "description": "The identifier (UUID) of the resource." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Validate a license by ID, optionally scoped to a machine fingerprint, product, or entitlements. Returns a `meta` object with `valid`, `detail`, and `code`." }, { "info": { "name": "Validate a license (by key)", "type": "http" }, "http": { "method": "POST", "url": "https://api.keygen.sh/v1/accounts/{account}/licenses/actions/validate-key", "body": { "type": "json", "data": "{}" } }, "docs": "Validate a license using its key without prior authentication - the primary offline/online validation entry point for clients." }, { "info": { "name": "Check-out a license", "type": "http" }, "http": { "method": "POST", "url": "https://api.keygen.sh/v1/accounts/{account}/licenses/:id/actions/check-out", "params": [ { "name": "id", "value": "", "type": "path", "description": "The identifier (UUID) of the resource." } ] }, "docs": "Check out a signed, encrypted license file for offline validation." }, { "info": { "name": "Check-in a license", "type": "http" }, "http": { "method": "POST", "url": "https://api.keygen.sh/v1/accounts/{account}/licenses/:id/actions/check-in", "params": [ { "name": "id", "value": "", "type": "path", "description": "The identifier (UUID) of the resource." } ] }, "docs": "Perform a required license check-in to reset the check-in window." } ] } ], "bundled": true }