Skip to content

License Artifact Too Large

URI: https://docs.ankatech.co/errors/license-artifact-too-large
HTTP Status: 413 Payload Too Large

When you see this

The submitted license artifact exceeds the maximum accepted size of 65536 bytes. Valid license artifacts are well under the limit; an oversized upload is rejected before processing.

Common Causes

  • Uploading a file far larger than a real license artifact (often the wrong file).
  • A corrupted artifact padded with unexpected content.
  • Submitting something other than a license.ankalic artifact.

Response Example

{
  "type": "https://docs.ankatech.co/errors/license-artifact-too-large",
  "title": "License Artifact Too Large",
  "status": 413,
  "detail": "The license artifact exceeds the maximum accepted size of 65536 bytes.",
  "instance": "/api/v3/admin/platform/license/import",
  "extensions": { "requestId": "8b0c2d4e-6f1a-4b3c-9d5e-2a7f8c1b0d3e" }
}

Content-Type: application/problem+json — the response follows RFC 9457 Problem Details.

Raised by the Admin API, before the licence server is called

The import is POST /api/v3/admin/platform/license/import. The Admin API reads at most one byte past the 65536-byte bound (LicenseArtifactLimits in ankasecure-common-license-contract) and refuses a larger body itself, so the licence server never receives it and no audit event is written. Correlate a request by extensions.requestId.

How to Resolve

  1. Confirm you are uploading the correct license.ankalic artifact.
  2. Re-obtain the artifact from ANKATech if the file appears corrupted or oversized.
  3. Re-submit the correctly-sized license artifact.

For full schema definitions, examples, and interactive testing, see the Developer Hub Reference.