> ## Documentation Index
> Fetch the complete documentation index at: https://superofficeas-worktree-351-fix-webapi-escaped-anchors.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# How to delete a list item

> How to delete a list using web service APIs

To delete a list, use the `Lists` endpoint. These examples use the Category list for demonstration purposes.

<Danger>
  Do not delete built-in lists.
</Danger>

<Tabs>
  <Tab title="RESTful REST API">
    ```http theme={null}
    DELETE https://{{env}}.superoffice.com/{{tenant}}/api/v1/List/108 HTTP/1.1
    Authorization: Bearer {{token}}
    ```
  </Tab>

  <Tab title="HTTP RPC Agent API">
    For user-defined lists, use the list Id in the `ListEntityId` query string parameter.

    ```http theme={null}
    POST https://{{env}}.superoffice.com/{{tenant}}/api/v1/Agents/List/DeleteListEntity?ListEntityId=108 HTTP/1.1
    Authorization: Bearer {{token}}
    ```

    **Response:**

    HTTP Status 204
  </Tab>

  <Tab title="WebApi Proxy API">
    How to delete a list entity using the [SuperOffice.WebApi][1] proxy client.

    ## For user-defined lists, use the list Id

    ```csharp theme={null}
    var config = new WebApiOptions(tenant.WebApiUrl);
    config.Authorization = new AuthorizationAccessToken("8A:Cust12345.Example-Token", OnlineEnvironment.SOD);

    var listAgent = new ListAgent(config);
    await listAgent.DeleteListEntityAsync(108);
    ```
  </Tab>
</Tabs>

[Back](./index)

[1]: ../../../web-services/proxies/index