Dispose (create + commit)
disposeRecord a firearm disposition (sale, FFL transfer) and commit it in one step; previews changes by default until confirm:true.
Instructions
Record a disposition and commit it in one step (sale, FFL transfer, etc.). Items reference firearms already in inventory by GUID. For FFL transfers set requestType=Regular and otherTransfereeEmails; FastBound may auto-create the receiving FFL's acquisition (reported back via headers). Commits a regulated record: dry-run by default, pass confirm:true. Write.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"requestType": "<requestType>",
"date": "<date>",
"items": "<items>"
},
"name": "dispose"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | Disposition date (ISO, required) — when the firearm left the premises. | |
| note | No | ||
| otsn | No | ||
| ttsn | No | Set by FastBound when a 4473 completes — leave unset at creation (same for otsn / generateTTSN). | |
| type | No | Disposition type label. See list_smartlists DisposeType. | |
| items | Yes | Inventory items being disposed. | |
| account | No | Which configured FastBound account to use for this one call — an alias or account number (see list_accounts). Omit to use the active account. | |
| confirm | No | Set true to actually execute. Omit or false returns a DRY RUN preview that sends nothing. | |
| contact | No | Inline new recipient contact (alternative to contactId). | |
| auditUser | No | Email recorded as X-AuditUser for the ATF audit trail. Overrides the account's default audit user (FASTBOUND_<ALIAS>_AUDIT_USER, else FASTBOUND_AUDIT_USER) for this call. Must be an active user on the account. | |
| contactId | No | Existing recipient/buyer contact GUID. | |
| requestType | Yes | Disposition request type. Use Regular for sales/FFL transfers. | |
| generateTTSN | No | Have FastBound generate the TTSN. | |
| invoiceNumber | No | ||
| contactExternalId | No | ||
| purchaseOrderNumber | No | ||
| otherTransfereeEmails | No | Recipient FFL user emails for an FFL transfer; FastBound notifies them and may auto-create their acquisition. | |
| shipmentTrackingNumber | No |