Sluby
REST APIPlayback

Revoke every signed URL of an asset.

Raises the asset signing generation, so every signed url minted for it so far (and every child url signed from one) is refused from now on; new ones can be minted straight away. A pb_ id revokes for its whole asset. Copies of public objects a shared cache already holds are unaffected, and sia:// share maps run until their own expiry.

POST
/api/v1/playback/{id}/signed/revoke

Raises the asset signing generation, so every signed url minted for it so far (and every child url signed from one) is refused from now on; new ones can be minted straight away. A pb_ id revokes for its whole asset. Copies of public objects a shared cache already holds are unaffected, and sia:// share maps run until their own expiry.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A Sluby API key (sluby_...) sent as Authorization: Bearer <key>. Keys carry scopes: upload, read, manage.

Path Parameters

id*string

Asset UUID or pb_ playback ID.

Response Body

Revoked.

application/json
  1. response
success*unknown
signing_generation*integer

The asset signing generation now in force; every older url is void.

Example Request
curl -X POST 'https://sluby.example.com/api/v1/playback/string/signed/revoke'
Example Response
{  "success": true,  "signing_generation": 0}

Time-limited signed playback URL. GET

Signs the master manifest (and the first thumbnail as a poster) for the asset. The signature covers the asset signing generation, so every url minted so far stops working when the asset tier changes or POST /api/v1/playback/{id}/signed/revoke is called. A url never lasts longer than six hours.

Per-object sia:// share URLs for direct-from-Sia playback. GET

Next Page