# docx.transform.fill-sign

docx.transform.fill-sign: Fill a Word file's fields, sign it, and return the signed Word file, its PDF and a hash-bound signing record.

Fill a Word file's fields, sign it, and return the signed Word file, its PDF and a hash-bound signing record.

Use `describe("docx.transform.fill-sign")` when your code needs the complete live JSON Schemas.

## At a glance

| Property | Value |
| --- | --- |
| Package | `@runstamp/registry` |
| Domain / verb | `docx` / `transform` |
| Customer jobs | transform |
| Deterministic | No |
| Side effects | none |

## Availability

| Local | SDK | CLI | MCP | Managed API |
| --- | --- | --- | --- | --- |
| unavailable | unavailable | unavailable | unavailable | public ga |

Managed API route: `POST /api/v2/operations/docx/transform/fill-sign`. 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 | none | none |
| Options | `signer` | `operation`, `values`, `field`, `anchor`, `documentName`, `deterministic`, `deterministicSeed`, `timeoutMs`, `locale`, `lossPolicy`, `limits` |
| Result value | `docx`, `pdf`, `pageCount`, `filled`, `unknown`, `rejected`, `record` | none |

Every success also carries `losses`, `diagnostics`, and a hash-bound `receipt`.

<Accordion title="Defaults, limits, and format constraints">

### Defaults

| Path | Default |
| --- | --- |
| `$.deterministic` | `default=true` |
| `$.lossPolicy` | `default="collect"` |

### Formats and profiles

No separate format selector is declared. Accepted artifacts are bounded by the exact input schema.

### Other limits

| Path | Constraint |
| --- | --- |
| `$.signer.name` | `minLength=1`<br />`maxLength=256` |
| `$.signer.email` | `maxLength=320` |
| `$.signer.reason` | `maxLength=512` |
| `$.documentName` | `maxLength=256` |
| `$.timeoutMs` | `minimum=1` |

</Accordion>

## Invoke

<CodeGroup>

```ts TypeScript docs-verify=skip docs-verify-reason="Generated example uses the published, hash-verified operation input."
const input = await fetch("https://runstamp.com/demo-evidence/operation-evidence/docx/docx.transform.fill-sign/input.json").then((response) => response.json());
const result = await runstamp.run("docx.transform.fill-sign", input);
if (!result.ok) throw new Error(`${result.error.code}: ${result.error.remediation}`);
console.log(result.value, result.losses, result.diagnostics, result.receipt);
```

```bash CLI
curl -fsS https://runstamp.com/demo-evidence/operation-evidence/docx/docx.transform.fill-sign/input.json -o input.json
npx -p @runstamp/sdk runstamp ops invoke docx.transform.fill-sign --input input.json
```

```json MCP
{
  "tool": "runstamp_invoke_operation",
  "arguments": {
    "operation": "docx.transform.fill-sign",
    "input": "<JSON from https://runstamp.com/demo-evidence/operation-evidence/docx/docx.transform.fill-sign/input.json>",
    "execution_mode": "local"
  }
}
```

</CodeGroup>

## Errors and losses

<Accordion title="Declared errors (7)">

- `common/SCHEMA_REJECTED`
- `common/CONTRACT_VIOLATION`
- `common/OPERATION_CANCELLED`
- `common/OPERATION_TIMEOUT`
- `common/RESOURCE_LIMIT_EXCEEDED`
- `common/INPUT_CORRUPT`
- `common/STEP_REJECTED`

</Accordion>

<Accordion title="Declared losses (0)">

- None.

</Accordion>

SDK `AbortSignal`, CLI exit 130, and MCP cancellation return the typed `common/OPERATION_CANCELLED` failure envelope.

## Verified example and exact contract

- Fixture: `icp-workflow` (U.S. District Court (E.D.N.C.) certificate of service, a public court form).
- [Example input](/demo-evidence/operation-evidence/docx/docx.transform.fill-sign/input.json) — SHA-256 `82d649b98a2c92b102426df2e212afe9dbbc7aeb3f7a1469c20241207b28a7fa`.
- [Example result](/demo-evidence/operation-evidence/docx/docx.transform.fill-sign/result.json) — SHA-256 `20ca9eb530ae47f36ee1aac61e482f83453ccc955a4b1a0de60af5f5462f56a2`.
- Verified result SHA-256: `767aac58efe060f2d957bc848503a76296df23c8e190fb2644a36a613f526400`.
- Qualification lane: `10-pptx-docx`.

<Accordion title="Contract fingerprints">

- Descriptor: `46d2759e41064811ad084658e7c519e35075928d6fab7a909255c8efebdaacb4`.
- Input schema: `0bb36436e54b003beee60d7402dda9a111fe5aa7de52e909698c9c528e782917`.
- Options schema: `ef8adf3f53e9ec03eab7f34970e4f454a7f370029be6a241cf812f7326cf1e4c`.
- Result value schema: `1274f053eecb6447aa4abe96e1d9b10ac6252a32b54b501246bbc8f109595db0`.

</Accordion>

The [machine-readable operation reference](/operation-reference.json) publishes the complete schemas, qualification results, and evidence bindings for every operation.