Delete a workspace group

delete/v1/workspace-groups/{workspace_group_id}

Soft-deletes the group and every join + membership row in one transaction. Actor must be owner/admin.

Requires a bearer token: Authorization: Bearer <token>.

Path parameters

NameTypeRequiredDescription
workspace_group_idstring <uuid>YesGroup ID.e.g. 00000000-0000-4000-8000-000000000000

Request

cURL
curl -X DELETE https://api.wellapp.ai/v1/workspace-groups/{workspace_group_id} \
  -H "Authorization: Bearer $WELL_API_TOKEN"

Responses

204 — Deleted.

401 — Unauthorized.

{
  "code": "UNAUTHORIZED",
  "status": 401,
  "title": "Unauthorized",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

403 — Not owner/admin.

{
  "code": "FORBIDDEN",
  "status": 403,
  "title": "Forbidden",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

404 — Not found.

{
  "code": "NOT_FOUND",
  "status": 404,
  "title": "Not Found",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}