Kenso
Get early access

Saved list invites

The Saved list invites endpoints of the Kenso API.

Search and data2 endpointsKen-Version: 2026-11-02AuthenticationWorkspacesErrors

Read a saved-list invite

GET/v1/saved-list-invites/{token}saved-list-invites.get

Needs the saved_lists feature on your workspace. Until it is on, calls answer 404.

Try it on developer.ken.so

The list's name, kind and member count, the owner workspace's name and the invite status (pending, accepted or revoked). No X-Ken-Workspace-Id needed. An unknown token or a deleted list is 404.

Parameters

Name
In
Type
Required
Description
token
In: path
string
required
Ken-Version
In: header
string, one of: 2026-11-02, 1.1
required
The API version: a dated version (YYYY-MM-DD), or 1.1, another name for the first dated version. Without it the request uses your API key's pinned version; an unpinned key reaches the legacy shape of the same path. 1.0 selects the legacy shape explicitly.

Response 200

data is a SavedListInviteModel.

Field
Type
Description
token
string
listName
string
kind
string, one of: people, companies
memberCount
integer (int32)
ownerWorkspaceName
string
status
string, one of: pending, accepted, revoked
Request
curl -X GET "https://api.ken.so/v1/saved-list-invites/string" \
  -H "Authorization: Bearer $KEN_API_KEY" \
  -H "Ken-Version: 2026-11-02"
Response 200
{
  "success": true,
  "data": {
    "token": "string",
    "listName": "string",
    "kind": "people",
    "memberCount": 1,
    "ownerWorkspaceName": "string",
    "status": "pending"
  }
}

Accept a saved-list invite into a workspace

POST/v1/saved-list-invites/{token}/acceptsaved-list-invites.accept

Needs the saved_lists feature on your workspace. Until it is on, calls answer 404.

Try it on developer.ken.so

No body. The list becomes readable (read-only) in the X-Ken-Workspace-Id workspace. The signed-in user's email must be the invited address (403 otherwise). An invite is accepted once (409 invalid_state); the owner workspace cannot accept its own list (409 invalid_state); a workspace that already holds the list gets 409 conflict; a revoked invite is 404. Requires the Search page at edit in that workspace.

Parameters

Name
In
Type
Required
Description
token
In: path
string
required
Ken-Version
In: header
string, one of: 2026-11-02, 1.1
required
The API version: a dated version (YYYY-MM-DD), or 1.1, another name for the first dated version. Without it the request uses your API key's pinned version; an unpinned key reaches the legacy shape of the same path. 1.0 selects the legacy shape explicitly.
X-Ken-Workspace-Id
In: header
integer (int64)
optional
Workspace to act in. Required when your credential can reach more than one workspace (otherwise 400 workspace_required).

Response 200

data is a SavedListGrantModel.

Field
Type
Description
id
integer (int64)
savedListId
integer (int64)
inviteeEmail
string
status
string, one of: pending, accepted, revoked
receivingWorkspaceId
integer (int64)
receivingWorkspaceName
string
invitedByUserId
integer (int64)
acceptedAt
string (date-time)
revokedAt
string (date-time)
createdAt
string (date-time)
Request
curl -X POST "https://api.ken.so/v1/saved-list-invites/string/accept" \
  -H "Authorization: Bearer $KEN_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID"
Response 200
{
  "success": true,
  "data": {
    "id": 812,
    "savedListId": 812,
    "inviteeEmail": "[email protected]",
    "status": "pending",
    "receivingWorkspaceId": 812,
    "receivingWorkspaceName": "string",
    "invitedByUserId": 812,
    "acceptedAt": "2026-09-23T15:02:11Z",
    "revokedAt": "2026-09-23T15:02:11Z",
    "createdAt": "2026-09-23T15:02:11Z"
  }
}
More in Search and data:SearchSaved searchesFunding roundsJob postingsJob post searchesSignalsScrapingCompany dataEmail findsSaved listsAll resources