Releases an order that is currently on hold (is_on_hold: true). Clears the hold
fields (is_on_hold, hold_type, hold_reason), stamps released_at, logs a
hold_released timeline event, and fires an order.hold_released broadcast.
Holds are placed automatically by POST /v1/orders/{id}/confirm when the account
exceeds its credit limit. This endpoint is the programmatic complement to the
“Release Hold” button in the Arcus UI.
A user_id is required for the audit trail. API key callers may pass user_id in
the body; if omitted, the API key’s owner user is used as the released-by actor.
Idempotent via Idempotency-Key header. Requires orders:write scope.
Industry parallel: Shopify Admin GraphQL orderReleaseHold mutation.
Documentation Index
Fetch the complete documentation index at: https://docs.arcuserp.com/llms.txt
Use this file to discover all available pages before exploring further.
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.
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.
255UUID of the order to release from hold.
Hold released successfully.