Hermos API

Upload Licence Keys

Verify and seal up to 500 SAY1 keys in one transaction. Upload larger lists in several requests; each request is limited to 1 MiB and 500 keys; re-uploading a key is a no-op. The pool must be active; otherwise returns 409 conflict with rule pool_not_active. Per-key rejections contain only indexes and reason codes. Re-uploading identical keys counts duplicates. Key text is accepted only in the JSON body.

POST/licence_key_pools/{id}/keys

Verify and seal up to 500 SAY1 keys in one transaction. Upload larger lists in several requests; each request is limited to 1 MiB and 500 keys; re-uploading a key is a no-op. The pool must be active; otherwise returns 409 conflict with rule pool_not_active. Per-key rejections contain only indexes and reason codes. Re-uploading identical keys counts duplicates. Key text is accepted only in the JSON body.

Authorization

__Host-hms_session<token>

In: cookie

Path Parameters

id*string

Opaque licence key pool ID.

Match^lkp_[0-7][0-9abcdefghjkmnpqrstvwxyz]{25}$(?![\s\S])

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Upload larger lists in several requests; each request is limited to 1 MiB and 500 keys; re-uploading a key is a no-op.

Response Body

application/json

application/json

curl -X POST "https://example.com/licence_key_pools/string/keys" \  -H "Content-Type: application/json" \  -d '{    "keys": [      "string"    ]  }'
{  "object": "licence_key_upload",  "accepted": 0,  "duplicates": 0,  "rejected": [    {      "index": 0,      "reason": "malformed"    }  ]}