Lists the caller's shares, newest first.

GET

/api/v1/shares

Why this is paged

One person's shares are bounded by what one person uploaded, which holds for the web page and not for a script. An account with fifty thousand shares made every visit read fifty thousand rows and build fifty thousand responses.

Errors

401 when nothing was signed in.

Authorization

cookietessera_session<token>

Set by POST /auth/login. A browser sends it automatically; it is HttpOnly, so page scripts cannot read or set it.

Query Parameters

limit?integer

How many to return. Capped, and defaulted when omitted.

Formatint64

Range0 <= value

offset?integer

How many to skip.

Formatint64

Range0 <= value

Response Body

A page of the caller's shares

application/json

response

A page of the caller's shares.

data*array<>

The shares on this page.

meta*

The collection they came from.

curl -X GET 'https://example.com/api/v1/shares'

{  "data": [    {      "code": "string",      "copy_count": 0,      "created_at": "string",      "disabled": true,      "encryption": "string",      "expires_at": "string",      "files": [        {          "filename": "string",          "position": 0,          "sealed_name": "string",          "size_bytes": 0        }      ],      "has_password": true,      "id": "string",      "key_salt": "string",      "kind": "string",      "language": "string",      "last_accessed_at": "string",      "management_token": "string",      "path": "string",      "scan_detail": "string",      "scan_state": "string",      "scanning": true,      "sealed_details": "string",      "size_bytes": 0,      "title": "string",      "use_count": 0,      "uses_remaining": 0,      "view_count": 0    }  ],  "meta": {    "limit": 0,    "offset": 0,    "total": 0  }}