ReferenceHTTP APIAdmin

Sessions waiting for an owner to take them over

GET
/v1/takeovers

Sessions whose requester was offboarded. Each takes no further input until an owner takes it over. API keys are refused.

Auth: cookie session only; no scope.

Authorization

cookieSession
cookie__Host-werft_session<token>

For the web console: the browser session cookie set by POST /v1/auth/login. It holds the scopes of the user's workspace role (owner: all; admin and member: all but sessions:recover). Requests other than GET must also send X-Requested-With: werft-web.

Response Body

Success

application/json
  1. response
items*array<>
Itemsitems <= 200
Example Request
curl -X GET 'https://example.com/v1/takeovers'
Example Response
{  "items": [    {      "session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82",      "departed_user_id": "eb018c72-aad8-4421-88d6-007f9bb24d24",      "status": "queued",      "created_at": "2019-08-24T14:15:22Z",      "takeover_required_at": "2019-08-24T14:15:22Z"    }  ]}