---
title: "Mint an Order Stream Grant and Order Watch Link for an order"
method: POST
path: "/v1/orders/{orderId}/stream-grants"
tags: ["Order Stream Grants"]
---

# Mint an Order Stream Grant and Order Watch Link for an order

`POST /v1/orders/{orderId}/stream-grants`

Creates a revocable Order Stream Grant for the order and returns the raw token once. A retry with the same Idempotency-Key replays the stored grant without a token.

## Path parameters

- `orderId` string, uuid, required

## Headers

- `idempotency-key` string, required

## Request body

- object
  - `organizationId` string, uuid
  - `label` string, nullable
  - `expiresAt` string, date-time
  - `maxConcurrentViewers` integer
  - `postTerminalGraceSeconds` integer

## Response `200`

Default Response

## Other responses

- `default` — Unexpected error response

## Changes

- **2026-09-15** `5c8170e25e84` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/orders/:orderId/stream-grants/post.md)

---

[API](https://skmtc.dev/printhiv3d/apis/hive-api-documentation.md) · [All operations](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/revisions/3dea7fda80a8?raw)