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

# LinkedIn accounts: Restart a LinkedIn account's ramp

> **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 [LinkedIn accounts](/docs/api/linkedin-accounts.md). Authentication, workspaces and errors: [/docs.md](/docs.md).

## Restart a LinkedIn account's ramp

`POST /v1/linkedin-accounts/{linkedinAccountId}/ramp/reset` - operationId `linkedin-accounts.reset-ramp`

| Permission | Rate limit |
| --- | --- |
| Delivery edit | 4,800 requests a minute per API key |

Restarts the account's per-action ramp from today. Each action keeps its start, weekly step and ceiling, and
`rampStartedAt` moves to now, so every action is back at its start value today. Returns the account.

Errors:

- `404 not_found`: no LinkedIn account with this id in the workspace.
- `409 invalid_state`: LinkedIn caps still follow the ramp stages (`rampPlansEnabled` is false), so
there is no ramp to restart.

Requires Delivery edit.

[Try it on developer.ken.so](https://developer.ken.so/reference/#kenso-api/tag/linkedin-accounts/POST/v1/linkedin-accounts/%7BlinkedinAccountId%7D/ramp/reset)

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `linkedinAccountId` | path | integer (int64) | yes | The LinkedIn account's id. |
| `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 `LinkedInAccount`.

| Field | Type | Description |
| --- | --- | --- |
| `id` | integer (int64) | The LinkedIn account id. |
| `displayName` | string | The account's name as Kenso shows it. Omitted when not set. |
| `publicIdentifier` | string | The profile's public id, the last part of its LinkedIn URL. Omitted when not known. |
| `profileUrl` | string | The LinkedIn profile URL. Omitted when not known. |
| `profileImageUrl` | string | The URL of the profile photo. Omitted when there is none. |
| `headline` | string | The profile headline. Omitted when there is none. |
| `status` | string | The connection state: `connecting` (the connect session has not finished), `connected`, `credentials_error` (sign in again through a reconnect), `restricted` (LinkedIn restricted the profile), `disconnected`, `deleted` or `connect_failed`. A pause shows in `pausedAt`, not here. |
| `timezone` | string | The account's IANA time zone, such as `Europe/London`. Omitted when not set, which means UTC. |
| `workingHours` | string | The stored working hours, as a JSON string. Omitted when not set. `workingHoursSchedule` gives the same hours as an object, with the defaults filled in. |
| `dailyInviteCap` | integer (int32) | The most connection invites the account sends per day. |
| `dailyMessageCap` | integer (int32) | The most messages and InMails the account sends per day. |
| `dailyVisitCap` | integer (int32) | The most profile visits the account makes per day. |
| `createdAt` | string (date-time) | When the account was added to Kenso, in UTC. |
| `createdDatetime` | string (date-time) | The same value as `createdAt`. Use `createdAt`. |
| `updatedAt` | string (date-time) | When Kenso last synced the account's profile, in UTC. Omitted when it never has. |
| `unipileAccountId` | string | The id Kenso's LinkedIn connection uses for the account. Kenso support may ask for it. Omitted until the account connects. |
| `statusChangedAt` | string (date-time) | When `status` last changed, in UTC. Omitted when it never has. |
| `invitesToday` | integer (int32) | Invites sent today, since the start of the account's day or over the last 24 hours, depending on how Kenso counts the account's limits. Compare with `dailyInviteCap`. Omitted when Kenso could not read the counts. |
| `messagesToday` | integer (int32) | Messages and InMails sent today, counted the same way as `invitesToday`. |
| `visitsToday` | integer (int32) | Profile visits made today, counted the same way as `invitesToday`. |
| `invitesSent30d` | integer (int32) | Invites sent in the last 30 days. Omitted when Kenso could not read it. |
| `acceptRate` | number (double) | The share of `invitesSent30d` that were accepted, from 0 to 1. Omitted when no invite was sent in that time. |
| `usedBy` | UsedBy | The live campaigns that use this account, and whether Accounts uses it for one-to-one outreach. Omitted when Kenso could not read it. |
| `lastActionAt` | string (date-time) | When the account last finished an outreach action, in UTC: the newest confirmed campaign step or Accounts touch. A person's replies from the Inbox do not count. Omitted when there is none, or Kenso could not read it. |
| `lastActionType` | string | The action at `lastActionAt`: `visit`, `invite`, `message`, `inmail`, `voice_message`, `withdraw`, `follow`, `reaction`, `comment` or `endorse`. Omitted when `lastActionAt` is. |
| `pausedAt` | string (date-time) | When a member paused the account, in UTC. Omitted when it is not paused. A paused account sends no outreach (invites, messages, InMails, profile visits, withdrawals and approved Accounts notes), and neither do Ken's autonomous replies. They wait and go out after a resume. A person's replies from the Inbox and inbox sync keep running. Separate from `status`. |
| `connectedByMemberId` | integer (int64) | The member who connected the account. Outreach from it that needs approval waits for this member. Omitted for an account connected before Kenso recorded this. |
| `importConnections` | boolean | True when Kenso imports the account's LinkedIn connections into Accounts as people and companies. Only the member who connected the account or a workspace admin can change it. |
| `handoffsMutedAt` | string (date-time) | When the account's owner muted warm path handoffs on it, in UTC. Omitted when not muted. While any account an owner connected is muted, no teammate's warm path hands that owner a hop. |
| `researchReadsEnabledAt` | string (date-time) | When the account's owner turned on research reads, in UTC. Omitted when off. While it is set, Kenso may read public LinkedIn posts on the account a few times a day, inside its working hours. |
| `importConnectionsChangedAt` | string (date-time) | When `importConnections` last changed, in UTC. Omitted when it never has. |
| `networkOnly` | boolean | True when the account only lends its owner's LinkedIn network to the workspace. Kenso syncs its connections and chats, but never adds it to a campaign, never picks it as an account's sending account and never sends from it on its own. Set when the account connects; a workspace admin can change it. |
| `removedFromCampaignIds` | array of integer (int64) | Only on the update that made the account network-only: the ids of the campaigns it sent for and was taken out of, ascending. Omitted otherwise. |
| `workingHoursSchedule` | LinkedInWeeklySchedule | The account's working hours for each day of the week as Kenso applies them, in the account's `timezone`. Days not set use the defaults: Monday to Friday open 08:00 to 18:00, Saturday and Sunday closed. A closed day still shows 08:00 to 18:00. |
| `products` | LinkedInAccountProducts | The paid LinkedIn products on the account, as LinkedIn last reported them. Omitted until Kenso first checks. |
| `invitesLast7Days` | integer (int32) | Invites sent in the last 7 days. Compare with `weeklyInviteCap`. This field and the other safety fields (`weeklyInviteCap`, `pendingInvites`, `pendingInviteCap`, `health`, `rampStage`, `rampInviteCap` and `safetyEnabled`) are omitted together when Kenso could not read them. |
| `weeklyInviteCap` | integer (int32) | The most invites the account sends in any 7 days, at most 100. |
| `pendingInvites` | integer (int32) | Invites still waiting for an answer, as the higher of Kenso's count and LinkedIn's. |
| `pendingInviteCap` | integer (int32) | The account sends no new invites while `pendingInvites` is at or above this number. |
| `health` | LinkedInAccountHealth | How well the account's invites are being accepted, over invites sent 3 to 30 days ago. |
| `rampStage` | integer (int32) | The account's ramp stage: 0, 1 and 2 in its first three weeks, while Kenso raises a new account's invite volume week by week, then 3 at full volume. It stops moving while `rampPlansEnabled` is true. |
| `rampInviteCap` | integer (int32) | Today's invite cap from the ramp: 5, 10, then 20, then the account's `dailyInviteCap`. While `rampPlansEnabled` is true, today's cap of the invite row of `ramp`. |
| `safetyEnabled` | boolean | False while Kenso shows the safety values but does not apply the weekly, pending and low acceptance caps yet. |
| `rampPlansEnabled` | boolean | True once Kenso runs LinkedIn on the per-action ramp: the account's daily caps come from `ramp`. False while the caps still follow `rampStage` and `rampInviteCap`. Omitted when Kenso could not read it. |
| `rampStartedAt` | string (date-time) | When the ramp's week 0 started, UTC. Only while `rampPlansEnabled` is true. |
| `ramp` | array of LinkedInRampAction | One row per action (invite, message, visit, follow, reaction, comment, endorse, accept): today's cap, the plan's start, weekly step and ceiling, the week index and the date today's cap reaches the ceiling. Only while `rampPlansEnabled` is true. Edit it with `ramp` in `PATCH /v1/linkedin-accounts/{linkedinAccountId}` and restart it with `POST /v1/linkedin-accounts/{linkedinAccountId}/ramp/reset`. |
| `tagIds` | array of integer (int64) | Ids of the workspace's tags on the account, in ascending order. Empty when it has none. Set them with `POST /v1/tags/{tagId}/assignments` and `entityType` `linkedin_account`. Only `GET /v1/linkedin-accounts`, `GET /v1/linkedin-accounts/{linkedinAccountId}` and `PATCH /v1/linkedin-accounts/{linkedinAccountId}` carry it, and they omit it when Kenso could not read the tags. Other lists of LinkedIn accounts, such as a campaign's, never carry it. |
| `safetyHolds` | array of LinkedInAccountSafetyHold | The safety holds Kenso has on the account right now, at most one per `scope`, ordered `all_writes`, `invites`, `invite_notes`. Empty when it has none, or when Kenso could not read them. Only `GET /v1/linkedin-accounts`, `GET /v1/linkedin-accounts/{linkedinAccountId}`, `PATCH /v1/linkedin-accounts/{linkedinAccountId}` and its ramp reset carry it. Other lists of LinkedIn accounts, such as a campaign's, never carry it. |

### Request

```bash
curl -X POST "https://api.ken.so/v1/linkedin-accounts/812/ramp/reset" \
  -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": 2207,
    "displayName": "Alex Rivera",
    "publicIdentifier": "alex-rivera-northwind",
    "profileUrl": "https://www.linkedin.com/in/alex-rivera-northwind",
    "headline": "Partnerships at Northwind Outbound",
    "status": "connected",
    "timezone": "America/New_York",
    "dailyInviteCap": 20,
    "dailyMessageCap": 40,
    "dailyVisitCap": 60,
    "createdAt": "2026-09-23T15:02:11Z",
    "createdDatetime": "2026-09-23T15:02:11Z",
    "invitesToday": 8,
    "messagesToday": 14,
    "visitsToday": 21,
    "invitesSent30d": 312,
    "acceptRate": 0.34,
    "lastActionAt": "2026-10-14T09:12:48Z",
    "lastActionType": "invite",
    "connectedByMemberId": 1093,
    "importConnections": true,
    "networkOnly": false,
    "tagIds": []
  }
}
```

## Types

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

### UsedBy

What an inbox or LinkedIn account is used for: the live campaigns that send through it, and whether Accounts uses it for one-to-one outreach.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `campaigns` | array of UsedByCampaign | no | The live campaigns (scheduled, launching or sending) that use this inbox or LinkedIn account, ordered by id. Empty when there are none. |
| `accounts` | boolean | no | True when Accounts uses it for one-to-one outreach. An inbox counts when it is its member's primary inbox (`isPrimary`). A LinkedIn account counts when the member who connected it owns at least one live account in Accounts, because an account's LinkedIn steps go out from the LinkedIn account its owner connected. |

### LinkedInWeeklySchedule

A LinkedIn account's working hours, one entry per day from `mon` to `sun`, in the account's time zone. Kenso runs the account's LinkedIn actions only inside these hours. A day with no entry uses the default: 08:00 to 18:00 on weekdays, closed on weekends. An update must include all seven days.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `mon` | LinkedInWorkingDay | no | One day of a LinkedIn account's working hours. Times are `HH:mm` in the account's time zone. |
| `tue` | LinkedInWorkingDay | no | One day of a LinkedIn account's working hours. Times are `HH:mm` in the account's time zone. |
| `wed` | LinkedInWorkingDay | no | One day of a LinkedIn account's working hours. Times are `HH:mm` in the account's time zone. |
| `thu` | LinkedInWorkingDay | no | One day of a LinkedIn account's working hours. Times are `HH:mm` in the account's time zone. |
| `fri` | LinkedInWorkingDay | no | One day of a LinkedIn account's working hours. Times are `HH:mm` in the account's time zone. |
| `sat` | LinkedInWorkingDay | no | One day of a LinkedIn account's working hours. Times are `HH:mm` in the account's time zone. |
| `sun` | LinkedInWorkingDay | no | One day of a LinkedIn account's working hours. Times are `HH:mm` in the account's time zone. |

### LinkedInAccountProducts

The paid LinkedIn products on a LinkedIn account.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `premium` | boolean | no | True when the account has LinkedIn Premium. |
| `salesNavigator` | boolean | no | True when the account has Sales Navigator. |
| `recruiter` | boolean | no | True when the account has LinkedIn Recruiter. |
| `checkedAt` | string (date-time) | no | When Kenso last checked the products, in UTC. |

### LinkedInAccountHealth

How well a LinkedIn account's connection invites are being accepted.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `status` | string | no | Either `healthy` or `low_acceptance`. An account becomes `low_acceptance` when under 20% of at least 40 invites were accepted, and goes back to `healthy` at 25%. While it is `low_acceptance`, it sends at most 5 invites a day. |
| `acceptRate` | number (double) | no | The share of the `sample` invites that were accepted, from 0 to 1. Omitted when `sample` is 0. |
| `sample` | integer (int32) | no | How many invites were sent 3 to 30 days ago. |
| `changedAt` | string (date-time) | no | When `status` last changed, in UTC. Omitted when it never has. |

### LinkedInRampAction

One action's row of a LinkedIn account's ramp.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `action` | string | no | invite, message, visit, follow, reaction, comment, endorse or accept. |
| `todayCap` | integer (int32) | no | Today's cap: `min(ceiling, start + stepPerWeek * weekIndex)`, then the action's hard ceiling. |
| `start` | integer (int32) | no | The cap in week 0. |
| `stepPerWeek` | integer (int32) | no | How much the cap rises each full week. |
| `ceiling` | integer (int32) | no | The cap the ramp stops at, at most the action's hard ceiling. |
| `weekIndex` | integer (int32) | no | Full weeks since `rampStartedAt`, in the account's time zone. |
| `fullVolumeOn` | string (date) | no | The date the action reaches its ceiling (YYYY-MM-DD), in the account's time zone. `9999-12-31` when it never does (no weekly step and a start below the ceiling). |

### LinkedInAccountSafetyHold

A safety hold Kenso placed on a LinkedIn account: until `until`, the account sends none of the writes `scope` names. Kenso places and lifts holds on its own; a member cannot.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `scope` | string, one of: all_writes, invites, invite_notes | no | The writes the hold stops: `all_writes` (every invite, message, InMail, profile visit and other outreach action), `invites` (new connection invites) or `invite_notes` (the note on an invite; the invite still goes out without it). |
| `until` | string (date-time) | no | When the hold ends, in UTC. |
| `reason` | string | no | Why Kenso placed the hold, in words a member can read. |
| `source` | string | no | The check that placed the hold, as a short code such as `account_warning`, `invite_streak`, `provider_streak`, `note_quota` or `reconnect_quiet`. New codes may be added. |

### UsedByCampaign

A live campaign that uses an inbox or LinkedIn account.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | integer (int64) | no | The campaign id. |
| `name` | string | no | The campaign's name. |
| `status` | string | no | The campaign's status, with the same values as `GET /v1/campaigns`. |

### LinkedInWorkingDay

One day of a LinkedIn account's working hours. Times are `HH:mm` in the account's time zone.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `open` | boolean | no | True when the account works on this day; false when it takes the day off. |
| `start` | string | no | When the working day starts, such as `09:00`. |
| `end` | string | no | When the working day ends, such as `17:30`. |
