Skip to main content

Delete Contact Group (v1)

Method & Path

DELETE /api/v1/workspace/:workspaceId/sms/contact-groups/:groupId

Description

Deletes a contact group.

Authentication

Required: Workspace auth.

Persona Access:

  • Workspace Owner: Allowed
  • Staff (role-based): Requires sms.send
  • Customer(client): Not allowed

Headers

  • Authorization: Bearer <workspaceToken>
  • X-Staff-Id: <staffId> (optional; required when acting as Staff)

Path Parameters

NameTypeRequiredDescription
workspaceIdstringYesWorkspace ID
groupIdstringYesGroup ID

Response 204 No Content

Common Errors

  • 400 Bad Request: Invalid identifiers
  • 401 Unauthorized: Missing/invalid workspace token
  • 403 Forbidden: Staff missing sms.send
  • 404 Not Found: Group not found
  • 500 Internal Server Error: Unexpected error