SPsparkvault
sparklinks

GET /sparklinks

Changed on

Request

Query parameters

type'spark' | 'ingot'
asset_idstring

Only the grants of this one ingot or Spark (a file's durable share and its one-time links), in no order. Anything but an ingot or Spark id is 400 VALIDATION_ERROR.

limitinteger

A page-size hint: a value above 100 reads as 100, and a missing, zero, negative or non-numeric one as 50.

cursorstring

The next_cursor a previous page returned, with the same type and asset_id.

Headers

X-Vault-Access-Tokenstring

A VAT for one of your vaults. Ingot rows of that vault carry their link_code and link_url; every other ingot row carries null for both. A VAT that is expired, revoked, or another account's fails the request (401 or 403).

Response

Response

Changes

  • f5a2490ba087Revision changes
    • info

      added the new optional query request parameter asset_id

  • ddca8926a12fRevision changes
    • info

      added the new optional header request parameter X-Vault-Access-Token

    • info

      added the new optional query request parameter cursor

    • info

      added the new optional query request parameter limit

    • info

      added the new optional query request parameter type