Logo
Search
Docs

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_id

Errors

StatusMeaningBody
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
}