Fill an AcroForm's fields, keeping it interactive.
Use describe("pdf.transform.form-fill") when your code needs the complete live JSON Schemas.
At a glance
| Property | Value |
|---|---|
| Package | @runstamp/forms |
| Domain / verb | pdf / transform |
| Customer jobs | transform |
| Deterministic | Yes |
| Side effects | none |
Availability
| Local | SDK | CLI | MCP | Managed API |
|---|---|---|---|---|
| public ga | public ga | public ga | public ga | public ga |
Managed API route: POST /api/v2/operations/pdf/transform/form-fill. Managed execution requires a free-trial workspace or an active Platform or Enterprise workspace, and an environment-bound API key.
Input and result
| Schema | Required fields | Optional fields |
|---|---|---|
| Input | artifactId, bytesBase64, sha256, tenantId, version | values, appearance |
| Options | none | operation, deterministic, deterministicSeed, timeoutMs, limits, locale, lossPolicy |
| Result value | output, artifacts | none |
Every success also carries losses, diagnostics, and a hash-bound receipt.
Defaults, limits, and format constraints
Defaults
| Path | Default |
|---|---|
$.deterministic | default=true |
$.lossPolicy | default="collect" |
Formats and profiles
| Path | Constraint |
|---|---|
$.version | minLength=1maxLength=16384 |
Other limits
| Path | Constraint |
|---|---|
$.artifactId | pattern="^[a-f0-9]{64}$" |
$.bytesBase64 | minLength=4maxLength=89478492pattern="^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$" |
$.sha256 | pattern="^[a-f0-9]{64}$" |
$.tenantId | minLength=1maxLength=16384 |
$.deterministicSeed | minLength=1maxLength=1024 |
$.timeoutMs | minimum=1 |
$.limits.maxInputBytes | minimum=1 |
$.limits.maxOutputBytes | minimum=1 |
$.limits.maxPages | minimum=1 |
$.limits.maxElements | minimum=1 |
$.limits.maxArchiveEntries | minimum=1 |
$.limits.maxExpansionRatio | minimum=1 |
$.limits.maxDurationMs | exclusiveMinimum=0maximum=2147483647 |
$.locale | minLength=1maxLength=128 |
Invoke
const input = await fetch("https://runstamp.com/demo-evidence/operation-evidence/forms/pdf.transform.form-fill/input.json").then((response) => response.json());
const result = await runstamp.run("pdf.transform.form-fill", input);
if (!result.ok) throw new Error(`${result.error.code}: ${result.error.remediation}`);
console.log(result.value, result.losses, result.diagnostics, result.receipt);curl -fsS https://runstamp.com/demo-evidence/operation-evidence/forms/pdf.transform.form-fill/input.json -o input.json
npx -p @runstamp/sdk runstamp ops invoke pdf.transform.form-fill --input input.json{
"tool": "runstamp_invoke_operation",
"arguments": {
"operation": "pdf.transform.form-fill",
"input": "<JSON from https://runstamp.com/demo-evidence/operation-evidence/forms/pdf.transform.form-fill/input.json>",
"execution_mode": "local"
}
}Errors and losses
Declared errors (27)
pdf/A03_BINDING_MISMATCHpdf/ABORTEDpdf/ACTIVE_ACTIONpdf/BINDING_MISMATCHpdf/DUPLICATE_FIELD_NAMEpdf/FIELD_UNKNOWNpdf/FIELD_UNSUPPORTEDpdf/FLATTEN_FAILEDpdf/FORM_INVALIDpdf/INVALID_INPUTpdf/INVALID_VALUEpdf/MALFORMED_APPEARANCEpdf/MALFORMED_WIDGETpdf/OUTPUT_HASH_MISMATCHpdf/POST_MUTATION_CHECK_FAILEDpdf/PROTECTED_FORMpdf/RESOURCE_LIMITpdf/SIGNED_INPUTpdf/SIGNING_PROVIDER_REQUIREDpdf/TIMEOUTpdf/WIDGET_COUNT_MISMATCHpdf/SCHEMA_REJECTEDcommon/SCHEMA_REJECTEDcommon/OPERATION_CANCELLEDcommon/OPERATION_TIMEOUTcommon/CONTRACT_VIOLATIONpdf/LOSS_POLICY_VIOLATED
Declared losses (2)
pdf/FORM_INTERACTIVITY_REMOVEDpdf/FORM_APPEARANCE_DEFERRED
SDK AbortSignal, CLI exit 130, and MCP cancellation return the typed common/OPERATION_CANCELLED failure envelope.
Verified example and exact contract
- Fixture:
icp-workflow(Employee onboarding EMP-2027-00418). - Example input — SHA-256
d0d8de38ebf616f30e1ed09d269dbecab43337b05456fd9927433441fa6ac30b. - Example result — SHA-256
0ed7815b3b8c430b7a6a3baf35695051f7572adf19a23580cc88aef702f84952. - Verified result SHA-256:
66c1bff957e5e293bc74c4326482ba9e58cfb4b1a79d6edb7c1706f1959f9295. - Qualification lane:
12-approval-forms-review.
Contract fingerprints
- Descriptor:
2151e28d42677526c3a4a926e7774037cd5a905b766bacad5eaee24c92f48b5b. - Input schema:
d68215702c9d3f2c266ff647203ac0728eb77562507dbb91edf184c7cbe083b0. - Options schema:
6aa77bb03ebb33fdb22b02e92e2ad11d29fde12d7d75af2b898a2b0d20bd54ea. - Result value schema:
d969ddb7f9b537eb420d24b5307265da69011b581b5e5fe5cc0498118287b061.
The machine-readable operation reference publishes the complete schemas, qualification results, and evidence bindings for every operation.