Update an existing smart list.
Lists
Update an existing smart list.
The request body is the list object — include id plus any fields to change.
Only the list owner can change name or sharing. Set sharing to:
- "Private": only the owner can view or modify.
- "Shared": anyone in the owner's company can view and modify.
- "Public": anyone with the list ID can read it via the unauthenticated
/public/lists/<listId> endpoints.
PUT
Update an existing smart list.
Authorizations
Company API key - scoped to a specific company. Generate from the Integrations page in your dashboard.
Body
application/json
List data to update
Request body for updating a smart list. The body is the list object itself — include id plus only the fields you want to change. To publish/unpublish a list, set sharing — see field description for the three modes.
List ID (UUID) to update
New list name. Only the list owner can change this.
Visibility of the list. Only the list owner can change this value. Allowed values:
- "Private": only the owner can view or modify the list.
- "Shared": any user in the owner's company can view and modify the list.
- "Public": anyone (no auth required) can read the list and its rows via GET /public/lists/ and GET /public/lists//rows. Other endpoints still require auth.
List type: "leads", "companies", or "custom"
Response
List updated
Generic success response
Human-readable success message (typically "Success")

