Delete squad
DELETE
https://app.sulus.ai/api/squads/{id}
Delete a squad (live first for published; drafts are local-only)
Authentication
Send a bearer token created on your dashboard's Developer page:
Authorization: Bearer <YOUR_API_KEY>
Path parameters
id
string
Required
The squad's public id.
Validation:
the squad's external_squad_id (UUID, or draft_… slug for drafts)Stored in
squads.external_squad_idErrors
| Status | Meaning | Body |
|---|---|---|
404 |
Squad not found, or outside your account scope | {"success":false,"message":"Squad not found"} |
403 |
Workspace permission denied | |
401 |
Missing or invalid bearer token | |
403 |
Feature squads not enabled for the account |
Notes
- The local row is removed even if the live delete fails, so a squad can never get stuck. The response carries no message key.
curl --request DELETE \
--url https://app.sulus.ai/api/squads/{id} \
--header 'Authorization: Bearer <YOUR_API_KEY>'
import requests
url = "https://app.sulus.ai/api/squads/{id}"
headers = {"Authorization": "Bearer <YOUR_API_KEY>"}
response = requests.delete(url, headers=headers)
print(response.json())
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://app.sulus.ai/api/squads/{id}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "Bearer <YOUR_API_KEY>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
Response
200
{
"success": true
}
Response — DELETE
/squads/{id}
200
{
"success": true
}