zulip/templates/zerver/api/remove-user-group.md
Kartik Srivastava 7677ba2d2b api docs: Rename 'group_id' to 'user_group_id'.
This renames 'group_id' to 'user_group_id' in the api docs to remove
the naming mismatch between the url config and the docs and eventually
remove the 'user_groups' endpoints from 'pending_endpoints' in
test_openapi.py.
2020-08-26 15:40:19 -07:00

700 B

Delete a user group

{generate_api_description(/user_groups/{user_group_id}:delete)}

Usage examples

{start_tabs} {tab|python}

{generate_code_example(python)|/user_groups/{user_group_id}:delete|example}

{tab|curl}

{generate_code_example(curl)|/user_groups/{user_group_id}:delete|example}

{end_tabs}

Parameters

{generate_api_arguments_table|zulip.yaml|/user_groups/{user_group_id}:delete}

Response

Example response

A typical successful JSON response may look like:

{generate_code_example|/user_groups/{user_group_id}:delete|fixture(200)}

An example JSON error response for an invalid user group id:

{generate_code_example|/user_groups/{user_group_id}:delete|fixture(400)}