What manifest and licence metadata should come with a release for our platform?
A per-release manifest can describe files, formats, checksums, splits, generation status and licence flags so a reseller's ingestion and listing pipeline can validate it automatically.
Resellers usually need machine-readable metadata alongside the data. Ask for a `manifest.json` per release with fields such as:
- `release_id`, `version`, `generated_at`, `schema_version` - `workflow`, `domain`, `layers_included` - `files`: name, format (JSONL or Parquet), row count and checksum - `generation_note`: a statement that the content is generated and not real business records - `licence_ref`: a pointer to the agreed licence text, with `onward_licence_allowed`, `permitted_uses` and `redistribution_allowed` set to what is actually agreed - `split`: which files are train, validation or held-out evaluation - `known_limitations`: free text
Checksums let your platform verify delivery and detect silent changes between versions. Semantic versioning on the schema helps customers tell a new column from a breaking change. Keep `release_id` stable and bump `version` when files change, so customers on an earlier version can be identified and notified.
For a pilot sample, ask for the same manifest structure the full release would use, so your ingestion and listing pipeline is tested properly. Validate the manifest against a JSON Schema before publishing, and fail the listing if a licence field is empty. Delivery mechanics, such as object storage or an API, are a pilot decision.
A machine-readable manifest with checksums and licence flags lets your pipeline reject incomplete releases before they reach a listing.
- Audience:
- Licensed resellers
- Content type:
- Integration
- Buyer question:
- Scope and getting started
Content release: r-a220eb6e099b243b
Related questions
- How does reviewing a sample change the scope of a freight claims pilot?
- What limits apply when licensing generated approval datasets or environments?
- How do I load a first approval sample into my agent harness?
- How should we scope a first pilot for approval-handling agents?
- What should I ask for in a sample or pilot of approval material?
- What does a scoping session for an approvals pilot produce?