Sluby
REST APIMembers

Change a member's role.

Applies to their sessions and keys on their next request. The last admin who can sign in stays an admin (409 `last_admin`).

PATCH
/api/v1/members/{id}

Applies to their sessions and keys on their next request. The last admin who can sign in stays an admin (409 last_admin).

Authorization

headerAuthorizationBearer <token>

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

Path Parameters

id*string

Member id.

Request Body

application/json
  1. body
role*string
Value in"admin""member"

Response Body

The member with the new role.

application/json
  1. response
id*string
Formatuuid
name*string
role*string
Value in"admin""member"
status*string

removed: an admin removed the member, who cannot sign in and whose keys stop until they are restored.

Value in"active""removed"
sign_in*array<>
created_at*string
Formatdate-time
last_sign_in_at*|

The latest sign-in by any method, null when the member has none.

Formatdate-time
Example Request
curl -X PATCH 'https://sluby.example.com/api/v1/members/string' \  -H 'Content-Type: application/json' \  -d '{  "role": "admin"}'
Example Response
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "name": "string",  "role": "admin",  "status": "active",  "sign_in": [    {      "provider": "string",      "username": "string"    }  ],  "created_at": "2019-08-24T14:15:22Z",  "last_sign_in_at": "2019-08-24T14:15:22Z"}