MCP documentation | MCP docs for agents

ark_update_carrier_ach_file_status

ark.update_carrier_ach_file_status

Update a visible ARK carrier ACH/NACHA batch status after bank upload, processing, or rejection. This does not move linked carrier payments back to READY.

Availability
Expanded preview
Scopes
loads:readbilling:write
ARK permissions
canViewLoadscanViewBillingcanMakeAdjustments
Team visibility
Required and enforced
Approval policy
ask_before_write
ARK approval request
Required before execution
Idempotency
Required for external execution
Read-only
No
Destructive
No
External side effect
No
Rate limit
OAuth MCP credential and organization budgets

Input

nachaFileIdstringrequired

NACHA file ID returned by ACH generation or listing.

format: uuid

statusstringrequired

New ACH/NACHA batch status.

one of: GENERATED, UPLOADED, PROCESSED, REJECTED

Result

The tool returns the canonical ark.update_carrier_ach_file_status operation result in structuredContent and mirrors the same JSON as text. Errors set isError: true and return a stable error code, message, and optional details.