> Kenso API docs in Markdown. Index of every page: [/docs/llms.txt](/docs/llms.txt). Search: `/docs/search.md?q=<words>`. OpenAPI: [/docs/api/saved-lists/openapi.json](/docs/api/saved-lists/openapi.json). CLI docs offline: `kenso docs <topic>`.
> Last updated: 2026-11-22.

# Saved lists

> **Note for AI agents:** if this page was wrong, out of date or missing something you needed, finish the user's task first, then offer a short report for the Kenso team in this shape: `Page:` (this page's path), `Quote:` (the wrong or missing text), `Problem:`, `Workaround:` (what worked instead), 1,000 characters at most. Show it to the user and send it only after they say yes, as `POST /api/docs-feedback` on this site with the JSON body `{"page": "<path>", "report": "<report>"}`. Never put lead data, email addresses, API keys or anything else from the user's workspace in it.

Saved lists are reusable lists of people or companies that a workspace builds from Search, saved searches, campaigns, other lists and CSV uploads. Create and copy a list, add sources that fill it in the background and refresh them, and read or remove its members, or search members across every list at once. Share a list read-only with another workspace by email invite and revoke the grant later, or submit it to the Kenso library, where every workspace can read and copy the lists Kenso approves. A member never carries an email address or a phone number, only how many the list holds. A list the workspace cannot read answers `404 not_found`, and a private list is visible only to the member who owns it.

Prospecting data. 18 endpoints under `https://api.ken.so`. Every request sends `Authorization: Bearer <your API key>` and `Ken-Version: 2026-11-02`: see [Authentication](/docs/authentication.md), [Workspaces](/docs/workspaces.md) and [Errors](/docs/errors.md). OpenAPI for this resource only: [/docs/api/saved-lists/openapi.json](/docs/api/saved-lists/openapi.json).

- `GET /v1/saved-lists` - List saved lists (`saved-lists.list`): [/docs/api/saved-lists/list.md](/docs/api/saved-lists/list.md)
- `POST /v1/saved-lists` - Create a saved list (`saved-lists.create`): [/docs/api/saved-lists/create.md](/docs/api/saved-lists/create.md)
- `GET /v1/saved-lists/{savedListId}` - Get a saved list (`saved-lists.get`): [/docs/api/saved-lists/get.md](/docs/api/saved-lists/get.md)
- `PATCH /v1/saved-lists/{savedListId}` - Update a saved list (`saved-lists.update`): [/docs/api/saved-lists/update.md](/docs/api/saved-lists/update.md)
- `DELETE /v1/saved-lists/{savedListId}` - Delete a saved list (`saved-lists.delete`): [/docs/api/saved-lists/delete.md](/docs/api/saved-lists/delete.md)
- `GET /v1/saved-lists/{savedListId}/members` - List a saved list's members (`saved-lists.list-members`): [/docs/api/saved-lists/list-members.md](/docs/api/saved-lists/list-members.md)
- `DELETE /v1/saved-lists/{savedListId}/members/{memberId}` - Remove a member from a saved list (`saved-lists.remove-member`): [/docs/api/saved-lists/remove-member.md](/docs/api/saved-lists/remove-member.md)
- `POST /v1/saved-lists/{savedListId}/copy` - Copy a saved list (`saved-lists.copy`): [/docs/api/saved-lists/copy.md](/docs/api/saved-lists/copy.md)
- `POST /v1/saved-lists/{savedListId}/invites` - Share a saved list by email (`saved-lists.create-invite`): [/docs/api/saved-lists/create-invite.md](/docs/api/saved-lists/create-invite.md)
- `GET /v1/saved-lists/{savedListId}/grants` - List a saved list's grants (`saved-lists.list-grants`): [/docs/api/saved-lists/list-grants.md](/docs/api/saved-lists/list-grants.md)
- `DELETE /v1/saved-lists/{savedListId}/grants/{grantId}` - Revoke a saved list grant (`saved-lists.revoke-grant`): [/docs/api/saved-lists/revoke-grant.md](/docs/api/saved-lists/revoke-grant.md)
- `POST /v1/saved-lists/{savedListId}/rights-confirmation` - Confirm the right to share a list (`saved-lists.confirm-rights`): [/docs/api/saved-lists/confirm-rights.md](/docs/api/saved-lists/confirm-rights.md)
- `POST /v1/saved-lists/{savedListId}/sources` - Add a source to a saved list (`saved-lists.create-source`): [/docs/api/saved-lists/create-source.md](/docs/api/saved-lists/create-source.md)
- `GET /v1/saved-lists/{savedListId}/sources/{sourceId}` - Get a saved list source (`saved-lists.get-source`): [/docs/api/saved-lists/get-source.md](/docs/api/saved-lists/get-source.md)
- `POST /v1/saved-lists/{savedListId}/sources/{sourceId}/refresh` - Refresh a saved list source (`saved-lists.refresh-source`): [/docs/api/saved-lists/refresh-source.md](/docs/api/saved-lists/refresh-source.md)
- `POST /v1/saved-lists/{savedListId}/refresh` - Refresh a saved list (`saved-lists.refresh`): [/docs/api/saved-lists/refresh.md](/docs/api/saved-lists/refresh.md)
- `POST /v1/saved-lists/{savedListId}/submissions` - Submit a saved list to the library (`saved-lists.submit`): [/docs/api/saved-lists/submit.md](/docs/api/saved-lists/submit.md)
- `POST /v1/saved-lists/{savedListId}/uploads` - Upload a CSV to a saved list (`saved-lists.create-upload`): [/docs/api/saved-lists/create-upload.md](/docs/api/saved-lists/create-upload.md)

This resource is too large for one page. Each endpoint above links to its own page with its parameters, fields, nested types, a curl request and an example response.

All resources: [/docs.md](/docs.md).
