MCP documentation | MCP docs for agents

ark_create_approval_request

ark.create_approval_request

Create a pending human approval request for one exact proposed operation without executing it.

Availability
Core preview
Scopes
agents:write
ARK permissions
None
Team visibility
Not entity-scoped
Approval policy
draft_only
ARK approval request
Not required
Idempotency
Required for external execution
Read-only
No
Destructive
No
External side effect
No
Rate limit
OAuth MCP credential and organization budgets

Input

sessionIdstring

format: uuid

operationIdstringrequired

one of: ark.create_load, ark.assign_carrier, ark.add_dispatch_note

expiresInMinutesinteger

default: 120; min: 5; max: 10080

Result

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