MCP documentation | MCP docs for agents

ark_finalize_load_file_upload

ark.finalize_load_file_upload

Finalize a prepared load file upload, attach the file to the load, update POD signature comments, and trigger POD upload notifications when applicable.

Availability
Expanded preview
Scopes
loads:write
ARK permissions
canEditLoad
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
Yes
Rate limit
OAuth MCP credential and organization budgets

Input

loadIdstringrequired

Visible ARK load ID.

format: uuid

filePathstringrequired

Storage path returned by ark_prepare_load_file_upload.

min length: 1; max length: 2000

fileNamestring

min length: 1; max length: 255

fileTypestringrequired

Document type such as POD, BOL, Load Tender, or Other.

min length: 1; max length: 100

mimeTypestringrequired

min length: 1; max length: 255

dispatchIdstring

Optional dispatch ID when the file belongs to a dispatch-specific document.

format: uuid

podSignedBystring | null

max length: 200

Result

The tool returns the canonical ark.finalize_load_file_upload 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.