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

# Segment LinkedIn sequences: Get a segment's LinkedIn sequence version

> **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.

One endpoint of [Segment LinkedIn sequences](/docs/api/segment-linkedin-sequences.md). Authentication, workspaces and errors: [/docs.md](/docs.md).

## Get a segment's LinkedIn sequence version

`GET /v1/segments/{segmentId}/linkedin-sequence/versions/{versionId}` - operationId `segment-linkedin-sequences.get-version`

| Permission | Rate limit |
| --- | --- |
| Campaigns view | 12,000 requests a minute per API key |

Returns one saved version with a copy of the LinkedIn steps as they were saved.

Errors:

- `404 not_found`: the segment does not exist in this workspace, or the version is not one of its LinkedIn sequence's versions.

Requires Campaigns view.

[Try it on developer.ken.so](https://developer.ken.so/reference/#kenso-api/tag/sequences/GET/v1/segments/%7BsegmentId%7D/linkedin-sequence/versions/%7BversionId%7D)

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `segmentId` | path | integer (int64) | yes | The segment's id. |
| `versionId` | path | integer (int64) | yes | The version's id, from the list of versions. |
| `Ken-Version` | header | string, one of: 2026-11-02, 1.1 | no | The API version, a date in `YYYY-MM-DD` form. `1.1` is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and `404` where the path exists only in this version. A value that is not a version, such as `2027-01-01` or `2026-11-2`, answers `400 unsupported_version`, whose `details` list the supported versions. |
| `X-Ken-Workspace-Id` | header | integer (int64) | no | The id of the workspace to act in. Leave it out when your API key reaches only one workspace. When the key reaches more than one, a request without this header answers `400 workspace_required`. A workspace you are not a member of answers `404 not_found`. |

### Response 200

`data` is a `LinkedInSequenceVersionDetail`.

| Field | Type | Description |
| --- | --- | --- |
| `id` | integer (int64) | The version's id. |
| `versionNumber` | integer (int32) | The version's number within its sequence. The first version is 1, and each new version gets the next number. |
| `createdAt` | string (date-time) | When Kenso saved the version, in UTC. |
| `createdByUserId` | integer (int64) | The id of the member who saved the version. Omitted when Kenso could not match the saver to a member. |
| `createdByEmail` | string | The email address of the member who saved the version. Omitted when none was recorded. |
| `isRevert` | boolean | True when the version records a restore of an earlier version. |
| `revertedFromVersionId` | integer (int64) | The id of the version that was restored. Omitted when `isRevert` is false. |
| `revertedFromVersionNumber` | integer (int32) | The number of the version that was restored. Omitted when `isRevert` is false. |
| `revertedFromCreatedAt` | string (date-time) | When the restored version was saved, in UTC. Omitted when `isRevert` is false. |
| `steps` | array of LinkedInSequenceSnapshotStep | Every step and variant of the LinkedIn sequence when the version was saved, inactive ones included. |

### Request

```bash
curl -X GET "https://api.ken.so/v1/segments/812/linkedin-sequence/versions/812" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"
```

### Example response

```json
{
  "success": true,
  "data": {
    "id": 3310,
    "versionNumber": 2,
    "createdAt": "2026-10-14T09:41:27Z",
    "createdByUserId": 1093,
    "createdByEmail": "jordan.patel@northwind-outbound.example.com",
    "isRevert": false,
    "steps": [
      {
        "stepOrder": 1,
        "stepType": "connection_request",
        "variant": "a",
        "body": "Hi {firstName}, I work with engineering leaders on onboarding. Glad to connect.",
        "waitDays": 1,
        "anchorEmailStepOrder": 1,
        "positionInGap": 0,
        "conditionType": "none",
        "isOptional": false,
        "openProfileOnly": false,
        "waitFromCondition": false,
        "isActive": true,
        "noteMode": "template"
      },
      {
        "stepOrder": 2,
        "stepType": "message",
        "variant": "a",
        "body": "Thanks for connecting, {firstName}. Did my email about onboarding new engineers reach you?",
        "waitDays": 2,
        "anchorEmailStepOrder": 1,
        "positionInGap": 1,
        "conditionType": "accepted",
        "isOptional": false,
        "openProfileOnly": false,
        "waitFromCondition": false,
        "isActive": true
      }
    ]
  }
}
```

## Types

Each named type the tables above use, nested ones included.

### LinkedInSequenceSnapshotStep

One LinkedIn step and variant in a saved version.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `stepOrder` | integer (int32) | no | The step's position in the LinkedIn sequence. Variants of one step share it. |
| `stepType` | string | no | The action: `profile_visit`, `connection_request`, `message`, `in_mail`, `follow`, `like_post`, `endorse_skill`, `comment_post` or `voice_note`. |
| `variant` | string | no | The variant: `a`, `b`, `c` or `d`. |
| `name` | string | no | A label for the variant. Kenso does not send it to LinkedIn. Omitted when it has none. |
| `subject` | string | no | The InMail subject line. Omitted when empty. |
| `body` | string | no | The text of the step, such as the connection request note or the message. Omitted when empty. |
| `waitDays` | integer (int32) | no | Days Kenso waits before it runs the step, counted from the send of the anchor email, or from when the contact entered the LinkedIn sequence when `anchorEmailStepOrder` is 0. |
| `anchorEmailStepOrder` | integer (int32) | no | The `stepOrder` of the email step this step follows. 0 places it before the first email. |
| `positionInGap` | integer (int32) | no | The step's order among the LinkedIn steps that follow the same email, from 0. |
| `conditionType` | string | no | What the contact must have done before the step runs: `none`, `clicked` (clicked an email link), `replied_positive` (replied with interest), `accepted` (accepted the invite or is already connected) or `engaged` (read or reacted to a LinkedIn message). Kenso skips the step when the condition is not met in time. |
| `conditionScopeStepOrder` | integer (int32) | no | For `clicked`, the `stepOrder` of the email whose link the contact must click. Omitted means any email so far. |
| `isOptional` | boolean | no | True when Kenso skips the step once the next email after its anchor is sent. |
| `openProfileOnly` | boolean | no | True when a message that falls back to a free InMail goes only to open profiles, and other contacts skip it. |
| `waitFromCondition` | boolean | no | True when the step's wait counted from the moment its accepted or not-accepted condition came true. |
| `isActive` | boolean | no | Whether the variant was on. |
| `noteMode` | string | no | For a connection request: `template` sends `body` as the note, and `ai` has Ken write each note. |
| `aiInstructions` | string | no | What Ken should write in each note when `noteMode` is `ai`, at most 1,000 characters. Omitted when empty. |
| `voice` | VoiceNoteSettings | no | The voice settings of a `voice_note` step. Omitted on every other step. |
| `requiresApproval` | boolean | no | For a `like_post`, `endorse_skill` or `comment_post` step, whether each action waited for a person's approval. Omitted on every other step, and in versions saved before Kenso recorded it. |

### VoiceNoteSettings

How Kenso records the voice note of a `voice_note` step for each contact.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `provider` | string | no | The voice provider: `deepgram` or `elevenlabs`. |
| `voiceId` | string | no | The voice's id, as `GET /v1/voices` lists it. |
| `speed` | number (double) | no | How fast the voice speaks, from 0.50 to 1.50. Only `deepgram` voices use it. Null means the voice's normal speed. |
| `wordsMode` | string | no | Who writes the words: `ken_writes` (Ken writes each note from `instructions`) or `script` (the voice reads `script`). |
| `instructions` | string | no | What Ken should say, when `wordsMode` is `ken_writes`. Null otherwise. |
| `script` | string | no | The words the voice reads, when `wordsMode` is `script`. Null otherwise. |
| `model` | string | no | The model Ken writes with when `wordsMode` is `ken_writes`: `haiku` or `sonnet`. Null means `haiku`. |
| `matchLeadLanguage` | boolean | no | Whether the note is spoken in each contact's outreach language instead of the voice's own. For a `deepgram` voice, Kenso picks a voice of the same gender in that language, and keeps the chosen voice and its language when there is none. |
