v19

latestOpenAPI 3.1.1raw.githubusercontent.com2026-08-017489931.2 KB

Delete a list

Moves a list to the trash. The list is soft-deleted and may be restored from the Lightfield UI. Member entities (accounts, contacts, or opportunities) are not affected.

Calling delete on an already-trashed list is a no-op and returns the existing record.

Required scope: lists:delete

Rate limit category: Write

delete/v1/lists/{id}

Path parameters

idstring required

Unique identifier of the list to delete.

Headers

Lightfield-Version'2026-03-01' required

Required API version header. Requests may error without it.

Request body

object required

Response

idstring required

Unique identifier for the list.

createdAtstring required

ISO 8601 timestamp of when the list was created.

httpLinkstring nullable required

URL to view the list in the Lightfield web app, or null.

fieldsobject required

Map of field names to their typed values. System fields are prefixed with $ (e.g. $name, $objectType).