Sign in
file-search

Mint Asset URLs

Mint short-lived presigned URLs for a document's figure crops.

Supply the figure ids (regions[].figure_id) to mint URLs for. When batch requested, each item degrades on its own: a figure with no crop does not fail the whole request.

post/v3/collections/{collection_name}/documents/{document_id}/asset-urls

Path parameters

collection_namestring required
document_idstring required

Request body

asset_idsstring[] required

Figure ids to mint URLs for, from regions[].figure_id. Stable and safe to store, unlike the URLs they mint. Up to 100; duplicates each return their own item.

ttl_secondsinteger nullable

How long each URL stays valid, in seconds. Default 900 (15 min); min 60, max 604800 (7 days).

Response

Successful Response

collection_namestring required
document_idstring required
expires_atstring nullable

Earliest expiry across all signed items, so a client can schedule a single refresh instead of one timer per image. Null when nothing was signed.

expires_in_secondsinteger nullable

Same deadline as a duration. Provided because browser clocks are routinely wrong, which makes an absolute-only expiry unreliable.

signed_countinteger
unavailable_countinteger
warningsstring[]

Changes

No recorded changes to this endpoint across all 1 revision of this API.