{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"**This endpoint allows you to delete a specific recipient list with the given ID.**","properties":{"path":{"type":"object","properties":{"list_id":{"type":"integer"}},"required":["list_id"],"additionalProperties":false},"query":{"type":"object","properties":{"delete_contacts":{"allOf":[{"$ref":"#/definitions/DeleteContacts"},{"type":"boolean"}],"description":"Adds the ability to delete all contacts on the list in addition to deleting the list."}},"required":[],"additionalProperties":false},"headers":{"type":"object","properties":{"on-behalf-of":{"type":"string","description":"The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id <account-id>`). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: <subuser-username>`). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information."}},"required":[],"additionalProperties":false}},"required":["path"],"additionalProperties":false,"definitions":{"DeleteContacts":{"type":"boolean","enum":[true,false]}}},"name":"Delete a List","id":"sendgrid.lmc_contactdb.deletecontactdblist","example":{"path":{"list_id":1}},"maxRequests":1,"summary":false}}