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.
List type: "leads", "companies", or "custom"
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.
Response
List updated
Generic success response
Human-readable success message (typically "Success")

