Skip to main content
DELETE

Delete Team

Permanently delete a team from your organization. This action cannot be undone.
Caution: Deleting a team is permanent and cannot be undone. All team data and member associations will be removed.

Authentication

Requires Console API authentication with bearer token and x-source: console header.

Path Parameters

string
required
Unique identifier of the team to delete.

Response Fields

string
required
Human-readable message confirming the deletion.
string
required
Operation status. Always “success” for successful deletion.

Error Responses

Usage Examples

Best Practices

Confirm Action

Always implement confirmation dialogs before deleting teams.

Check Dependencies

Verify that no critical resources depend on this team.

Notify Members

Notify team members before deletion if possible.

Archive Option

Consider implementing an archive feature instead of permanent deletion.
Pro Tip: Consider implementing a soft delete mechanism where teams are marked as inactive rather than permanently deleted, allowing for potential recovery.