Skip to content
PAASBOX PAASBOX PAASBOX

Adopt a server (WIPE-gated)

POST
/api/v1/teams/{team_slug}/connections/{ref}/adopted-servers/
 
curl --request POST \
  --url https://example.com/api/v1/teams/example/connections/example/adopted-servers/ \
  --header 'Content-Type: application/json' \
  --cookie sessionid=<sessionid> \
  --data '{ "spec": { "serverID": 1, "serverType": "example", "location": "example", "architecture": "amd64", "serverKind": "cloud" }, "acknowledge": { "additionalProperty": "example" } }'

/api/v1/teams/{team}/connections/{ref}/adopted-servers (docs/58 §3.8). DELETE deregisters; the grandfathered box is never deleted (P8).

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
ref
required
string
team_slug
required
string

Request Body required

Section titled “Request Body required ”

POST body to adopt a server (docs/58 §5.6c) — the typed WIPE ack is required (the OS is rebuilt, destroying data).

object
spec
required
object
serverID
required
integer
serverType
required
string
<= 20 characters
location
required
string
<= 20 characters
architecture
required
  • amd64 - amd64
  • arm64 - arm64
string
Allowed values: amd64 arm64
serverKind
string
Allowed values: cloud dedicated baremetal
acknowledge
object
key
additional properties

Responses

Section titled “ Responses ”

202

Section titled “202 ”
Media type application/json

An AdoptedServer resource (docs/58 §3.8).

object
apiVersion
required
string
kind
required
string
metadata
required
object
key
additional properties
spec
required
object
key
additional properties
status
required
object
key
additional properties
Example generated
{
  "apiVersion": "example",
  "kind": "example",
  "metadata": {
    "additionalProperty": "example"
  },
  "spec": {
    "additionalProperty": "example"
  },
  "status": {
    "additionalProperty": "example"
  }
}

409

Section titled “409 ”

RFC 7807 problem document

Media type application/json

RFC 7807 application/problem+json — every non-2xx response (docs/58 §5.10).

object
type
required
string format: uri
title
required
string
status
required
integer
detail
required
string
code
required

Stable machine code clients switch on

string
instance
required
string
nullable
operationId
required
string
nullable
Example generated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "instance": "example",
  "operationId": "example"
}

422

Section titled “422 ”

RFC 7807 problem document

Media type application/json

RFC 7807 application/problem+json — every non-2xx response (docs/58 §5.10).

object
type
required
string format: uri
title
required
string
status
required
integer
detail
required
string
code
required

Stable machine code clients switch on

string
instance
required
string
nullable
operationId
required
string
nullable
Example generated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "instance": "example",
  "operationId": "example"
}