Lists every share on the instance, newest first.

GET

/api/v1/admin/shares

Errors

401 when nothing was signed in, 403 when the caller may not read every share or used a bearer token, 404 when this instance has no administration.

Authorization

session

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 shares

application/json

response

A page of shares.

data*array<>

The shares on this page.

meta*

The collection they came from.

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

{  "data": [    {      "active": true,      "bytes_redirected": 0,      "bytes_served": 0,      "content_removed": true,      "created_at": "string",      "expires_at": "string",      "file_count": 0,      "filename": "string",      "id": "string",      "kind": "string",      "owner_id": "string",      "owner_username": "string",      "purges_at": "string",      "scan_detail": "string",      "scan_state": "string",      "size_bytes": 0,      "status": "available"    }  ],  "meta": {    "limit": 0,    "offset": 0,    "total": 0  }}