Skip to content

docs: note 1MB payload limit for custom attestations #381

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sami-alajrami merged 4 commits into from
Sep 3, 2026
Merged

docs: note 1MB payload limit for custom attestations #381

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
710e437
docs: note 1MB payload limit for custom attestations
sami-alajrami Sep 3, 2026
285f865
docs: tighten payload limit note per review
sami-alajrami Sep 3, 2026
89b59f1
docs: mention 400 error for oversized attestation-data
sami-alajrami Sep 3, 2026
3e7ab80
Update getting_started/attestations.md
sami-alajrami Sep 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions getting_started/attestations.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -203,6 +203,10 @@ Use **`--attestation-data`** on `kosli attest custom` to provide the JSON data t
attestation type's jq expression evaluates. This is what determines the compliance status of the
attestation. See the [Custom](#custom) attestation type below for details.

The `--attestation-data` JSON payload sent to Kosli is limited to 1 MB; larger payloads fail with a
400 error. For larger reports, distill the data you need into a summary and attach the full document
separately — see [Attesting large documents](/tutorials/attest_large_documents).

```shell
kosli attest custom \
--type coverage-metrics \
Expand Down
4 changes: 4 additions & 0 deletions tutorials/attest_large_documents.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,10 @@ By the end, you will have a Kosli attestation that captures the key facts from y

This two-part approach keeps attestation payloads focused on what compliance rules need to evaluate, while ensuring the raw evidence remains available.

<Note>
The `--attestation-data` JSON payload sent by `kosli attest custom` is limited to 1 MB — exceeding it returns a 400 error. Distill larger reports into a summary and attach the full document with `--attachments`, as described below.
</Note>
Comment thread
sami-alajrami marked this conversation as resolved.

## Prerequisites

* [Install Kosli CLI](/getting_started/install).
Expand Down