# NewTransferLaneInput

input type

Create-input for a TransferLane. The tenant (org group) is derived SERVER-SIDE from the principal; sourceLfId and destinationLfId are tenant-scoped server-side, must BOTH be ACTIVE (CONFLICT/REF_STATE), and must DIFFER; rank is REQUIRED iff mode is ranked (strict both ways); the ordered-pair marker reserves in the SAME transaction (a LIVE holder refuses CONFLICT/IDENTITY_TAKEN naming it; a DOOMED holder is taken over).

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `caption` | [String](/types/#scalars) | no | Optional: when omitted the per-type default applies — the mode coordinate ('Transfer lane (<mode>)'); when supplied it must be non-blank. |
| `sourceLfId` | [ID](/types/#scalars) `ID!` | yes | The donor LF (the directed pair is immutable after birth). |
| `destinationLfId` | [ID](/types/#scalars) `ID!` | yes | The receiving LF (must differ from sourceLfId). |
| `mode` | [TransferLaneMode](/types/TransferLaneMode/) `TransferLaneMode!` | yes | No further notes. |
| `rank` | [Int](/types/#scalars) | no | REQUIRED iff mode is ranked, REFUSED otherwise. |
| `typicalLeadTimeDays` | [Int](/types/#scalars) | no | No further notes. |
| `weightClass` | [TransferLaneWeightClass](/types/TransferLaneWeightClass/) | no | No further notes. |
| `costHint` | [MoneyEntryInput](/types/MoneyEntryInput/) | no | No further notes. |

## Used by

- [createTransferLane](/reference/transfer-lane/createTransferLane/)