Server löschen

Nimmt einen Server aus dem Inventar.

Laufen darauf noch Sitzungen, antwortet der Endpunkt mit 409 und nennt ihre Zahl — ein Server verschwindet nicht unter einer offenen Shell.

DELETE https://servers.api.shellbase.artim-industries.com/v1/servers/{id}


Methode	`DELETE`
Basis	`servers.api.shellbase.artim-industries.com/v1`
Scope	`sb.servers:delete`
Antwort	`204`
Zugang	Developer Mitgliedschaft
Auth	`Authorization: Bearer sbapi_…`

Parameter

Parameter	Ort	Typ	Pflicht	Bedeutung
`id`	Pfad	`string`	ja	Kennung des Servers.

Dieser Endpunkt braucht keinen Körper.

curl -X DELETE "https://servers.api.shellbase.artim-industries.com/v1/servers/{id}" \
  -H "Authorization: Bearer sbapi_…"

204 No Content — die Antwort hat keinen Körper.

Status	`code`	Wann
`400`	`invalid_request`	Ein Pflichtfeld fehlt, ein Typ passt nicht, oder ein Verweis zeigt auf etwas, das es hier nicht gibt.
`401`	`invalid_token`	Bearer fehlt, ist unbekannt oder abgelaufen.
`403`	`missing_scope`	Das Token trägt den Scope dieses Endpunkts nicht.
`404`	`not_found`	Der Eintrag gehört nicht zum freigegebenen Team — oder die Anfrage kam auf der falschen Subdomain an.
`409`	`conflict`	Der Zustand verbietet die Änderung — der Fehlerkörper nennt den Grund.
`429`	`rate_limited`	Kontingent erschöpft, siehe `Retry-After`.

Jede Fehlerantwort trägt dieselbe Hülle: error.code benennt den Fehler, error.message sagt in einem Satz, was fehlt.

Das Limit gilt pro Team, nicht pro Token.

Zugang	Produktion	Sandbox
Hobby	60 Anfragen/Minute	ohne Limit
Developer Mitgliedschaft	10.000 Anfragen/Minute	ohne Limit

Bei 429 sagt der Retry-After-Header, wie lange du warten sollst.