Sluby
REST APIKeys

List API keys.

Usable keys of the workspace, newest first, with who made each, including rotated-out keys still in their grace period. Pages hold up to 1000 keys; follow next_cursor while has_more is true.

GET
/api/v1/keys

Usable keys of the workspace, newest first, with who made each, including rotated-out keys still in their grace period. Pages hold up to 1000 keys; follow next_cursor while has_more is true.

Authorization

bearerAuth
headerAuthorizationBearer <token>

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

Query Parameters

limit?integer
Range1 <= value <= 1000
Default1000
cursor?string

Keyset pagination cursor. Pass the next_cursor from the previous page to fetch the next one. A cursor that does not decode is a 400.

Response Body

A page of keys.

application/json
  1. response
data*array<>
has_more*boolean
next_cursor*string|null
limits*

This server’s limits on keys, to check a new key against.

Example Request
curl -X GET 'https://sluby.example.com/api/v1/keys'
Example Response
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "scopes": [        "upload"      ],      "rate_limit": 0,      "is_active": true,      "created_at": "2019-08-24T14:15:22Z",      "expires_at": "2019-08-24T14:15:22Z",      "prefix": "string",      "last_used_at": "2019-08-24T14:15:22Z",      "created_by": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "name": "string"      }    }  ],  "has_more": true,  "next_cursor": "string",  "limits": {    "max_keys": 0,    "max_rate_limit": 0  }}

Withdraw a pending invite. DELETE

Previous Page

Create an API key. POST

The key belongs to the workspace and is made by the calling member, whose role it acts with (`created_by`); a key with no creator makes keys with no creator. The answer has the shape of a listed key plus `key`, the secret, which is never shown again.