> ## Documentation Index > Fetch the complete documentation index at: https://docs.unifygtm.com/llms.txt > Use this file to discover all available pages before exploring further. # Remove entries > Remove up to 100 records from a list. ## OpenAPI ````yaml POST /data/v1/lists/{list_id}/entries/remove openapi: 3.1.0 info: title: Unify Data API summary: Interact with objects, attributes, and records within the Unify platform. version: '1' termsOfService: https://www.unifygtm.com/legal/terms-and-conditions contact: name: Unify Support url: https://www.unifygtm.com/support email: support@unifygtm.com servers: - url: https://api.unifygtm.com variables: {} security: - ApiKeyAuth: [] tags: - name: Data - name: Object Record Query Jobs - name: Event Query Jobs - name: Lists - name: List Entries - name: Objects - name: Object Attributes - name: Object Attribute Options - name: Object Records paths: /data/v1/lists/{list_id}/entries/remove: post: tags: - Data - List Entries description: |- Remove records from a list. The records themselves are not deleted. Records absent from the list are unchanged. operationId: remove_list_entries parameters: - name: list_id in: path required: true description: ID of the list. schema: $ref: '#/components/schemas/UValues.UUuid' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/RemoveListEntriesRequest' responses: '200': description: Response for removing records from a list. content: application/json: schema: $ref: '#/components/schemas/RemoveListEntriesResponse' '400': description: Response for any operation that results in a bad request error. content: application/json: schema: type: object required: - status properties: status: type: string enum: - bad_request errors: type: array items: $ref: '#/components/schemas/UResponses.BadRequestError' message: type: string description: >- Response for any operation that results in a bad request error. '401': description: Response for any operation that results in an unauthorized error. content: application/json: schema: type: object required: - status - message properties: status: type: string enum: - unauthorized message: type: string description: >- Response for any operation that results in an unauthorized error. '403': description: Response for any operation that results in a forbidden error. content: application/json: schema: type: object required: - status - message properties: status: type: string enum: - forbidden message: type: string description: Response for any operation that results in a forbidden error. '404': description: Response for any operation that results in a not found error. content: application/json: schema: type: object required: - status - message properties: status: type: string enum: - list_not_found message: type: string description: Response for any operation that results in a not found error. '429': description: Response for any operation that exceeds a rate limit. content: application/json: schema: type: object required: - status - message properties: status: type: string enum: - rate_limited message: type: string description: Response for any operation that exceeds a rate limit. '500': description: Response for any operation that results in an internal server error. content: application/json: schema: type: object required: - status - message properties: status: type: string enum: - error message: type: string description: >- Response for any operation that results in an internal server error. components: schemas: UValues.UUuid: type: string description: String UUIDv4 value. title: UUuid RemoveListEntriesRequest: type: object required: - records properties: records: type: array items: $ref: '#/components/schemas/ListRecordIdentifier' minItems: 1 maxItems: 100 description: >- Up to 100 record identifiers to remove, processed in request order. ID and match identifiers may be mixed. Duplicate identifiers are not allowed. description: Request body for removing records from a list. RemoveListEntriesResponse: type: object required: - status - data - summary properties: status: type: string enum: - success data: type: array items: $ref: '#/components/schemas/RemoveListEntryResult' description: One result per requested record, in request order. summary: $ref: '#/components/schemas/RemoveListEntriesSummary' description: Response for removing records from a list. UResponses.BadRequestError: type: object required: - code properties: code: type: string path: type: array items: anyOf: - type: string - type: integer object_api_name: type: string attribute_api_name: type: string allOf: - type: object unevaluatedProperties: {} description: Validation error detail returned for bad request responses. ListRecordIdentifier: anyOf: - $ref: '#/components/schemas/ListRecordById' - $ref: '#/components/schemas/ListRecordByMatch' description: Record identifier using an ID or attribute values. RemoveListEntryResult: type: object oneOf: - $ref: '#/components/schemas/ListEntryRemovedResult' - $ref: '#/components/schemas/ListEntryNotInListResult' discriminator: propertyName: status mapping: removed: $ref: '#/components/schemas/ListEntryRemovedResult' not_in_list: $ref: '#/components/schemas/ListEntryNotInListResult' description: Per-record outcome of a remove request, discriminated by `status`. RemoveListEntriesSummary: type: object required: - total - removed - not_in_list properties: total: type: integer description: Number of requested records. Equal to the sum of the outcome counts. removed: type: integer not_in_list: type: integer description: Counts of remove outcomes by status. ListRecordById: type: object required: - id properties: id: $ref: '#/components/schemas/UValues.UUuid' description: ID of the record. description: Record identifier using an ID. ListRecordByMatch: type: object required: - match properties: match: type: object unevaluatedProperties: {} description: >- Attribute values used to find a record of the list's object. Include at least one unique attribute. Additional attributes narrow the match. description: Record identifier using attribute values. ListEntryRemovedResult: type: object required: - status - record - entry properties: status: type: string enum: - removed record: $ref: '#/components/schemas/ListRecordIdentifier' entry: $ref: '#/components/schemas/UListEntry' description: Result for a record removed from the list. ListEntryNotInListResult: type: object required: - status - record properties: status: type: string enum: - not_in_list record: $ref: '#/components/schemas/ListRecordIdentifier' description: Result for a record absent from the list or workspace. UListEntry: type: object required: - id - created_at - updated_at - list_id - object - record_id properties: id: $ref: '#/components/schemas/UValues.UUuid' description: Unique identifier for the entry. created_at: type: string format: date-time description: Date and time the entry was created. updated_at: type: string format: date-time description: Date and time the entry was last updated. list_id: $ref: '#/components/schemas/UValues.UUuid' description: ID of the list the entry belongs to. object: $ref: '#/components/schemas/UObjects.UObjectName' description: API name of the object the record belongs to. record_id: $ref: '#/components/schemas/UValues.UUuid' description: ID of the record in the list. description: A record's membership in a list. UObjects.UObjectName: type: string description: |- The API name of an object, e.g. `company`, `person`, `opportunity`, or a custom object's API name. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.