--- updatedAt: 2026-02-12T12:24:36.000Z --- # Delete List Item Delete an item to the list, if the acting user is the author or the owner of the list. > 🛠️ Public Beta Feature > > This documentation covers a feature currently in Public Beta. Access is available to anyone interested in building personalized experiences for their end-users. > > This feature is subject to the [Personalization API (Self-Service) Public Beta End user License Agreement](https://location.foursquare.com/legal/terms/personalization-apis-self-service-eula/) 📄. # OpenAPI definition ```json { "components": { "securitySchemes": { "ManagedUserTokenAuth": { "description": "Enter the oauth token associated with the individual user. Learn about [user-ful authentication and how to create Foursquare managed users](https://location.foursquare.com/developer/reference/personalization-apis-authentication#user-ful-authentication)", "in": "query", "name": "oauth_token", "type": "apiKey" } } }, "info": { "title": "Personalization APIs", "version": "1.0" }, "openapi": "3.1.0", "paths": { "/lists/{list_id}/deleteitem": { "post": { "deprecated": false, "description": "Delete an item to the list, if the acting user is the author or the owner of the list.", "operationId": "delete-item-from-list", "parameters": [ { "description": "The ID of the list to be acted upon.", "in": "path", "name": "list_id", "required": true, "schema": { "type": "string" } }, { "description": "The API version date as documented [here](/reference/versioning); e.g. 20231010", "in": "query", "name": "v", "required": true, "schema": { "type": "string" } }, { "description": "The venue you want to add to the list; e.g., Foursquare HQ's venue_id = 5a187743ccad6b307315e6fe", "in": "query", "name": "venueId", "required": true, "schema": { "type": "string" } }, { "description": "Optional text provided as a tip; applicable only when specifying a venue ID.", "in": "query", "name": "text", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "examples": { "Result": { "value": "{\n \"meta\": {\n \"code\": 200,\n \"requestId\": \"6418ef863b62b02d0473f813\"\n },\n \"notifications\": [\n {\n \"type\": \"notificationTray\",\n \"item\": {\n \"unreadCount\": 0\n }\n }\n ],\n \"response\": {\n \"items\": {\n \"count\": 1,\n \"items\": [\n {\n \"id\": \"v552327e9498e46856f3ed445\",\n \"venue\": {\n \"id\": \"552327e9498e46856f3ed445\",\n \"name\": \"Conto's Pizza & Pasta\"}\n }\n ]\n }\n }\n}" } }, "schema": { "description": "Deletes an item from a list successfully.", "properties": { "description": "Delete item from a list success response.", "meta": { "description": "Response metadata for successful deletion of an item from a list.", "properties": { "code": { "default": 0, "description": "Status code indicating the result of the list item deletion API request.", "example": 200, "type": "integer" }, "description": "Response object containing the metadata for the success of deleting an item from a list.", "requestId": { "description": "The unique identifier for the API request.", "example": "6418ef863b62b02d0473f813", "type": "string" } }, "type": "object" }, "notifications": { "description": "Array of notification objects for successful deletion of an item from a list.", "items": { "description": "Array of notification objects for the deleted item.", "properties": { "description": "Array of notification objects for a successful deletion of an item from a list in the notification tray.", "item": { "description": "Array of notification objects containing information about deleted items in the specified list.", "properties": { "description": "Delete item from a specific list and return a 200 response with notification and item properties.", "unreadCount": { "default": 0, "description": "Number of unread items in the notification for a successful response when deleting an item from a specific list.", "example": 0, "type": "integer" } }, "type": "object" }, "type": { "description": "Notification type.", "example": "notificationTray", "type": "string" } }, "type": "object" }, "type": "array" }, "response": { "description": "Response object for successful deletion of an item from a specified list.", "properties": { "description": "Properties of the response object for a successful deletion of an item from a list.", "items": { "description": "Item deletion response for the specified list, with information on the deleted items.", "properties": { "count": { "default": 0, "description": "Number of items deleted from the specified list.", "example": 1, "type": "integer" }, "description": "Array of properties for the items in the response of deleting an item from a list.", "items": { "description": "Array of items that were successfully deleted from the specified list.", "items": { "description": "The response from deleting an item from a list contains an array of items.", "properties": { "description": "List of items that were successfully deleted from the specified list.", "id": { "description": "The unique identifier for each deleted item.", "example": "v552327e9498e46856f3ed445", "type": "string" }, "venue": { "description": "Array of venue objects associated with the deleted item.", "properties": { "description": "Array of venues associated with the deleted item in the specified list.", "id": { "description": "Venue ID.", "example": "552327e9498e46856f3ed445", "type": "string" }, "name": { "description": "Venue name.", "example": "Conto's Pizza & Pasta", "type": "string" } }, "type": "object" } }, "type": "object" }, "type": "array" } }, "type": "object" } }, "type": "object" } }, "type": "object" } } }, "description": "200" }, "400": { "content": { "application/json": { "examples": { "Result": { "value": "{}" } }, "schema": { "description": "Bad request error response for deleting an item from a specific list.", "properties": { "description": "Delete item from a list." }, "type": "object" } } }, "description": "400" } }, "security": [ { "ManagedUserTokenAuth": [] } ], "summary": "Delete List Item", "tags": [ "Lists" ] } } }, "security": [ { "sec0": [] } ], "servers": [ { "url": "https://api.foursquare.com/v2/" } ], "tags": [ { "description": "Make it easy for users to curate custom lists of Places, like travel wishlists, trip itineraries, and local favorites.", "name": "Lists" } ], "x-readme": { "explorer-enabled": true, "headers": [], "proxy-enabled": true, "samples-enabled": true } } ```