Generate a tokenized Bill of Lading URL
Mints a short-lived signed URL pointing at the order’s tokenized BOL document.
Two gates apply: (1) the order must be flagged as freight, and (2) at least
one freight quote must be accepted. The default token TTL is 24 hours; pass
ttl_seconds to override within the 300-second .. 7-day band. The returned
URL is the canonical document share path (rendered by the Lambda’s document
token handler); it requires no further authentication beyond the token. The
canonical handler emits an freight.bol_generated activity log entry and a
freight.bol_generated realtime broadcast. Idempotent on Idempotency-Key.
Requires the orders:write scope.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_
Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Headers
Client-generated unique key for idempotent POST/PATCH/DELETE operations. Alias for the Idempotency parameter. Max 255 chars. On retry with the same key, the original response is returned without re-executing the operation. Keys expire after 24 hours.
255Path Parameters
Body
Token lifetime in seconds (5 minutes .. 7 days).
300 <= x <= 60480086400
Response
BOL share URL

