{"openapi":"3.0.4","info":{"title":"Kenso API: LinkedIn accounts","version":"1.1","description":"The LinkedIn accounts endpoints of the Kenso API, with every component they use. The full spec is https://api.ken.so/v1/docs/openapi.json. Every request sends `Authorization: Bearer <your API key>` and `Ken-Version: 2026-11-02`."},"servers":[{"url":"https://api.ken.so"}],"security":[{"Bearer":[]}],"tags":[{"name":"linkedin-accounts","description":"A LinkedIn account is a LinkedIn profile connected to your workspace, one seat on your plan, that sends campaign\ninvites, messages and profile visits. Connect or reconnect an account through a hosted connect session, then set\nits daily limits, working hours and time zone, or pause it. Each account you read also carries today's usage and\nthe safety caps Kenso applies to protect the profile.","x-displayName":"LinkedIn accounts"}],"paths":{"/v1/linkedin-accounts":{"get":{"tags":["linkedin-accounts"],"summary":"List LinkedIn accounts","description":"Returns the workspace's LinkedIn accounts, a page at a time with `limit` and `cursor`. Each account\ncarries today's usage, its safety caps and holds, its tags and the live campaigns that use it.\n            \nErrors:\n            \n- `400 validation_failed`: `limit` is not from 1 to 200, or `cursor` is invalid.\n            \nRequires Delivery view.\n\nRate limit: 12,000 calls a minute per API key, on top of the workspace limits.","operationId":"linkedin-accounts.list","parameters":[{"name":"cursor","in":"query","description":"The `pagination.nextCursor` value from the previous page. Omit it for the first page.","schema":{"type":"string"}},{"name":"limit","in":"query","description":"How many LinkedIn accounts to return, from 1 to 200. Defaults to 50.","schema":{"maximum":200,"minimum":1,"type":"integer","format":"int32","default":50}},{"name":"Ken-Version","in":"header","description":"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.","schema":{"enum":["2026-11-02","1.1"],"type":"string"},"examples":{"default":{"value":"2026-11-02","x-disabled":false}}},{"name":"X-Ken-Workspace-Id","in":"header","description":"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`.","schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInAccountListResponse"}}}},"400":{"description":"Bad Request","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["unsupported_version","validation_failed","workspace_required"]},"401":{"description":"Unauthorized","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"x-ken-error-codes":["unauthenticated"]},"404":{"description":"Not Found","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["not_found"]},"429":{"description":"Too Many Requests","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsError"}},"text/plain":{"schema":{"$ref":"#/components/schemas/RateLimitedText"}}},"x-ken-error-codes":["rate_limited"]}},"x-ken-permission":{"kind":"page","page":"delivery","access":"view","summary":"Delivery view"},"x-ken-rate-limit":{"limit":12000,"windowSeconds":60,"per":"api_key"}}},"/v1/linkedin-accounts/{linkedinAccountId}":{"get":{"tags":["linkedin-accounts"],"summary":"Get a LinkedIn account","description":"Returns one LinkedIn account with today's usage, its safety caps and holds, its tags and the live campaigns that use it.\n            \nErrors:\n            \n- `404 not_found`: no LinkedIn account with this id in the workspace.\n            \nRequires Delivery view.\n\nRate limit: 12,000 calls a minute per API key, on top of the workspace limits.","operationId":"linkedin-accounts.get","parameters":[{"name":"linkedinAccountId","in":"path","description":"The LinkedIn account's id.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Ken-Version","in":"header","description":"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.","schema":{"enum":["2026-11-02","1.1"],"type":"string"},"examples":{"default":{"value":"2026-11-02","x-disabled":false}}},{"name":"X-Ken-Workspace-Id","in":"header","description":"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`.","schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInAccountResponse"}}}},"400":{"description":"Bad Request","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["unsupported_version","workspace_required"]},"401":{"description":"Unauthorized","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"x-ken-error-codes":["unauthenticated"]},"404":{"description":"Not Found","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["not_found"]},"429":{"description":"Too Many Requests","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsError"}},"text/plain":{"schema":{"$ref":"#/components/schemas/RateLimitedText"}}},"x-ken-error-codes":["rate_limited"]}},"x-ken-permission":{"kind":"page","page":"delivery","access":"view","summary":"Delivery view"},"x-ken-rate-limit":{"limit":12000,"windowSeconds":60,"per":"api_key"}},"patch":{"tags":["linkedin-accounts"],"summary":"Update a LinkedIn account","description":"Changes the fields you send and leaves the others unchanged.\n            \n- `displayName`: at most 255 characters.\n- `timezone`: an IANA time zone such as `Europe/Bucharest`. An empty string clears it, and the\naccount then works in UTC.\n- `workingHoursSchedule`: the account's hours for each of the seven days, in its time zone. Send it or\n`workingHours`, not both.\n- `dailyInviteCap`, `dailyMessageCap`, `dailyVisitCap`: daily limits. Kenso clamps each value\nto at least 1 and at most the platform maximum, which is at most 20 invites, 50 messages and 80 visits a day.\n- `paused`: `true` pauses outreach from the account and sets `pausedAt`, or keeps it when the\naccount is already paused. Campaign invites, messages, InMails, profile visits, withdrawals, approved Accounts\nnotes and Ken's autonomous replies wait. Kenso never fails them or moves them to email. `false` resumes the\naccount and clears `pausedAt`. Replies a member sends from the Inbox and inbox sync keep running.\n- `importConnections`: turns the import of the account's LinkedIn connections into Accounts on or off.\nOnly the member who connected the account or a workspace admin may change it. `importConnectionsChangedAt`\nmoves only when the value changes.\n- `networkOnly`: `true` makes the account network-only. Kenso keeps syncing its connections and chats,\ntakes it out of every campaign it sends for and lists those campaigns in `removedFromCampaignIds`, and never\nsends from it on its own. `false` makes it a full account again, in no campaign until one adds it. Only the\nmember who connected the account or a workspace admin may change it. An account a Network member connected stays\nnetwork-only while they have that role: change their role to a team role first.\n- `researchReads`: `true` lets Kenso read public LinkedIn posts on the account a few times a day, inside\nits working hours, and sets `researchReadsEnabledAt`. `false` turns that off. Only the member who\nconnected the account may turn it on; that member or a workspace admin may turn it off.\n- `ramp`: edits the per-action ramp while `rampPlansEnabled` is true, an object keyed by action\n(invite, message, visit, follow, reaction, comment, endorse, accept) whose values take `start`,\n`stepPerWeek` and `ceiling`. Absent numbers keep the current value, and values are clamped to each\naction's hard ceiling. While `rampPlansEnabled` is true the three daily caps also set the invite, message\nand visit ceilings, and a `ramp` entry for the same action wins.\n            \nErrors:\n            \n- `400 validation_failed`: a value is invalid, and the error names the field. Detail code\n`feature_off` on `importConnections` when the workspace does not have the\n`linkedin_connections_import` feature, on `networkOnly: true` when it does not have `warm_paths_v2`, and on\n`ramp` while `rampPlansEnabled` is false. Detail\ncode `invalid` or `duplicate` on `ramp.<key>` for an unknown or repeated action. Kenso writes\nnothing.\n- `403 forbidden`: `importConnections`, `networkOnly` or `researchReads: false` from a member\nwho did not connect the account and is not a workspace admin, `researchReads: true` from anyone but the\nmember who connected it, or detail code `network_member` on `networkOnly: false` for an\naccount a Network member connected. Kenso writes nothing.\n- `404 not_found`: no LinkedIn account with this id in the workspace.\n            \nRequires Delivery edit.\n\nRate limit: 4,800 calls a minute per API key, on top of the workspace limits.","operationId":"linkedin-accounts.update","parameters":[{"name":"linkedinAccountId","in":"path","description":"The LinkedIn account's id.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Ken-Version","in":"header","description":"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.","schema":{"enum":["2026-11-02","1.1"],"type":"string"},"examples":{"default":{"value":"2026-11-02","x-disabled":false}}},{"name":"X-Ken-Workspace-Id","in":"header","description":"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`.","schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateLinkedInAccountBody"}}}},"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInAccountResponse"}}}},"400":{"description":"Bad Request","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["unsupported_version","validation_failed","workspace_required"]},"401":{"description":"Unauthorized","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"x-ken-error-codes":["unauthenticated"]},"403":{"description":"Forbidden","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["forbidden"]},"404":{"description":"Not Found","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["not_found"]},"429":{"description":"Too Many Requests","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsError"}},"text/plain":{"schema":{"$ref":"#/components/schemas/RateLimitedText"}}},"x-ken-error-codes":["rate_limited"]}},"x-ken-permission":{"kind":"page","page":"delivery","access":"edit","summary":"Delivery edit"},"x-ken-rate-limit":{"limit":4800,"windowSeconds":60,"per":"api_key"}},"delete":{"tags":["linkedin-accounts"],"summary":"Delete a LinkedIn account","description":"Disconnects the account from LinkedIn, removes it from the workspace and frees its LinkedIn seat on your plan.\nReturns `204`.\n            \nErrors:\n            \n- `404 not_found`: no LinkedIn account with this id in the workspace, including one you already deleted.\n- `503 service_unavailable`: LinkedIn is rate limited and Kenso removed nothing. Try again shortly.\n            \nRequires Delivery edit.\n\nRate limit: 4,800 calls a minute per API key, on top of the workspace limits.","operationId":"linkedin-accounts.delete","parameters":[{"name":"linkedinAccountId","in":"path","description":"The LinkedIn account's id.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Ken-Version","in":"header","description":"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.","schema":{"enum":["2026-11-02","1.1"],"type":"string"},"examples":{"default":{"value":"2026-11-02","x-disabled":false}}},{"name":"X-Ken-Workspace-Id","in":"header","description":"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`.","schema":{"type":"integer","format":"int64"}}],"responses":{"204":{"description":"No Content","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"description":"Bad Request","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["unsupported_version","workspace_required"]},"401":{"description":"Unauthorized","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"x-ken-error-codes":["unauthenticated"]},"404":{"description":"Not Found","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["not_found"]},"429":{"description":"Too Many Requests","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsError"}},"text/plain":{"schema":{"$ref":"#/components/schemas/RateLimitedText"}}},"x-ken-error-codes":["rate_limited"]},"503":{"description":"Service Unavailable","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableError"}}},"x-ken-error-codes":["service_unavailable"]}},"x-ken-permission":{"kind":"page","page":"delivery","access":"edit","summary":"Delivery edit"},"x-ken-rate-limit":{"limit":4800,"windowSeconds":60,"per":"api_key"}}},"/v1/linkedin-accounts/connect-sessions":{"post":{"tags":["linkedin-accounts"],"summary":"Start a LinkedIn connect session","description":"Returns a hosted link where the member signs in to LinkedIn to connect a new account or reconnect an existing\none. Open `url` within one hour.\n            \nOmit `linkedInAccountId` to connect a new account. Kenso creates the account with `status`\n`connecting` and returns its id. Send `linkedInAccountId` (or `linkedinAccountId`) to reconnect\nthat account, for example when its `status` is `credentials_error` or `disconnected`.\n`importConnections: true` on a new account imports its LinkedIn connections into Accounts once it\nconnects. It needs the `linkedin_connections_import` feature and is ignored without it. A reconnect ignores\n`importConnections` and keeps the account's setting.\n`networkOnly: true` connects a network-only account: Kenso syncs its connections and chats but never adds it\nto a campaign or sends from it on its own. It needs the `warm_paths_v2` feature. A reconnect ignores\n`networkOnly` and keeps the account's setting.\nA Network member's account is always network-only: Kenso connects it network-only whatever `networkOnly`\nsays, and a reconnect makes an account they connected network-only. It still takes a LinkedIn seat on your plan.\n            \nAny member may call it, Network members included. A member with Delivery edit can connect a new account and\nreconnect any account. A member with only the `approve_own_sends` permission, a Network member among them,\ncan connect one account of their own and reconnect only that one.\n            \nErrors:\n            \n- `400 validation_failed`: LinkedIn outreach is not on for this workspace, or detail code\n`feature_off` on `networkOnly` when the workspace does not have the `warm_paths_v2` feature.\n- `402 plan_limit_reached`: the plan has no LinkedIn seat left, or the workspace's credits do not cover the\naccount's first month.\n- `402 trial_cap_reached`: the workspace is on the Growth trial and already holds its one LinkedIn or\nWhatsApp account. `error.refusal` names the cap (`linkedin_accounts`) and offers Upgrade.\n- `403 permission_denied`: the caller has neither Delivery edit nor `approve_own_sends`.\n- `403 forbidden`, detail code `not_your_linkedin`: a member with only `approve_own_sends` asked\nto reconnect another member's account.\n- `403 forbidden`: the caller is a workspace key. A LinkedIn seat is a person's own, and a workspace key is\nnot a person.\n- `404 not_found`: `linkedInAccountId` is not an account in this workspace.\n- `409 conflict`, detail code `reconnect_instead`: a member with only `approve_own_sends` already\nhas an account here. The message names the id to reconnect.\n- `503 service_unavailable`: LinkedIn is rate limited. Try again shortly.\n            \nOpen to any workspace member.\n\nRate limit: 10 calls a minute per API key, on top of the workspace limits.","operationId":"linkedin-accounts.create-connect-session","parameters":[{"name":"Ken-Version","in":"header","description":"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.","schema":{"enum":["2026-11-02","1.1"],"type":"string"},"examples":{"default":{"value":"2026-11-02","x-disabled":false}}},{"name":"X-Ken-Workspace-Id","in":"header","description":"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`.","schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateLinkedInConnectSessionRequest"}}}},"responses":{"201":{"description":"Created","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInConnectSessionResponse"}}}},"400":{"description":"Bad Request","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["unsupported_version","validation_failed","workspace_required"]},"401":{"description":"Unauthorized","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"x-ken-error-codes":["unauthenticated"]},"402":{"description":"Payment Required","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["plan_limit_reached","trial_cap_reached"]},"403":{"description":"Forbidden","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["forbidden","permission_denied"]},"404":{"description":"Not Found","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["not_found"]},"409":{"description":"Conflict","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["conflict"]},"429":{"description":"Too Many Requests","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsError"}},"text/plain":{"schema":{"$ref":"#/components/schemas/RateLimitedText"}}},"x-ken-error-codes":["rate_limited"]},"503":{"description":"Service Unavailable","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableError"}}},"x-ken-error-codes":["service_unavailable"]}},"x-ken-permission":{"kind":"workspace_member","allowsNetworkMember":true,"summary":"Any workspace member, Network members included"},"x-ken-credits":[{"action":"linkedin_account_monthly","pricing":"fixed","unit":"linkedin_account","unitSize":1,"millicreditsPerUnit":1500000,"billing":"monthly"}],"x-ken-rate-limit":{"limit":10,"windowSeconds":60,"per":"api_key"}}},"/v1/linkedin-accounts/{linkedinAccountId}/ramp/reset":{"post":{"tags":["linkedin-accounts"],"summary":"Restart a LinkedIn account's ramp","description":"Restarts the account's per-action ramp from today. Each action keeps its start, weekly step and ceiling, and\n`rampStartedAt` moves to now, so every action is back at its start value today. Returns the account.\n            \nErrors:\n            \n- `404 not_found`: no LinkedIn account with this id in the workspace.\n- `409 invalid_state`: LinkedIn caps still follow the ramp stages (`rampPlansEnabled` is false), so\nthere is no ramp to restart.\n            \nRequires Delivery edit.\n\nRate limit: 4,800 calls a minute per API key, on top of the workspace limits.","operationId":"linkedin-accounts.reset-ramp","parameters":[{"name":"linkedinAccountId","in":"path","description":"The LinkedIn account's id.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"Ken-Version","in":"header","description":"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.","schema":{"enum":["2026-11-02","1.1"],"type":"string"},"examples":{"default":{"value":"2026-11-02","x-disabled":false}}},{"name":"X-Ken-Workspace-Id","in":"header","description":"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`.","schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInAccountResponse"}}}},"400":{"description":"Bad Request","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["unsupported_version","workspace_required"]},"401":{"description":"Unauthorized","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"x-ken-error-codes":["unauthenticated"]},"404":{"description":"Not Found","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["not_found"]},"409":{"description":"Conflict","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["invalid_state"]},"429":{"description":"Too Many Requests","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsError"}},"text/plain":{"schema":{"$ref":"#/components/schemas/RateLimitedText"}}},"x-ken-error-codes":["rate_limited"]}},"x-ken-permission":{"kind":"page","page":"delivery","access":"edit","summary":"Delivery edit"},"x-ken-rate-limit":{"limit":4800,"windowSeconds":60,"per":"api_key"}}}},"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Enter: Bearer {your Kenso API key}. Create one in the Kenso app under Settings > Integrations > API Keys.","scheme":"bearer","bearerFormat":"Opaque API key"}},"headers":{"RateLimit-Limit":{"description":"The request limit of the rate limit this request is closest to reaching: your plan's limit for this kind of call, your API key's own limit, or the operation's own limit, whichever has the fewest requests left.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"The requests left under that limit. `0` on a `429`.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"The seconds until that limit resets.","schema":{"type":"integer"}}},"schemas":{"ApiKeyError":{"required":["error"],"type":"object","properties":{"error":{"type":"string","description":"A sentence for people that says what went wrong. It can change, so do not parse it."}},"additionalProperties":false,"description":"The body the API key check in front of the operations answered until November 2026, instead of the error body (`Failure`): `{ \"error\": \"Invalid or revoked API key\" }` on a `401`, `{ \"error\": \"Rate limit exceeded\" }` on a `429` and `{ \"error\": \"Authentication is temporarily unavailable\" }` on a `503`. It has no `code`, so branch on the HTTP status."},"CreateLinkedInConnectSessionRequest":{"type":"object","properties":{"linkedInAccountId":{"type":"integer","description":"The LinkedIn account to reconnect. Omit it to connect a new account. `linkedinAccountId` is accepted too,\nand both must match when you send both.","format":"int64","nullable":true},"importConnections":{"type":"boolean","description":"Set to `true` to import the new account's LinkedIn connections into Accounts once it connects. It needs the\n`linkedin_connections_import` feature and is ignored without it. A reconnect ignores it and keeps the\naccount's setting.","nullable":true},"networkOnly":{"type":"boolean","description":"Set to `true` to connect a network-only account: Kenso syncs its LinkedIn connections and chats so the\nworkspace can find warm paths through them, but never adds it to a campaign or sends from it on its own. It needs\nthe `warm_paths_v2` feature: without it `true` is refused. A reconnect ignores it and keeps the\naccount's setting. A Network member's account is network-only whatever this says.","nullable":true}},"additionalProperties":false,"description":"The LinkedIn account to connect or reconnect. Send an empty body to connect a new account."},"ErrorAccount":{"type":"object","properties":{"accountId":{"type":"integer","description":"The account's id.","format":"int64"},"name":{"type":"string","description":"The account's name."},"stakeholderId":{"type":"integer","description":"The person's stakeholder id on this account.","format":"int64"}},"additionalProperties":false,"description":"An account named in an error detail."},"ErrorBody":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code, such as `validation_failed` or `not_found`. Branch on this value."},"message":{"type":"string","description":"A sentence for people that explains the error. It can change, so do not parse it."},"details":{"type":"array","items":{"$ref":"#/components/schemas/ErrorDetail"},"description":"One entry per problem, naming the field or limit it is about. Omitted when there are none.","nullable":true},"requestId":{"type":"string","description":"The id of this request: the same value as the `X-Correlation-Id` response header. Quote it when you write\nto contact@ken.so."},"docUrl":{"type":"string","description":"The page on this code in the developer docs, which says what it means and how to fix it. The errors guide for a\ncode that has no page of its own.","readOnly":true},"refusal":{"allOf":[{"$ref":"#/components/schemas/Refusal"}],"description":"On a `402`, the plan rule or usage limit that refused the request and how to lift it. Omitted otherwise."},"impact":{"allOf":[{"$ref":"#/components/schemas/InvalidationImpact"}],"description":"On a `409` that refuses a change because it would clear stored AI output (a prompt edit, a restore or a\nreset), how much the change would clear. Omitted otherwise."},"surface":{"type":"string","description":"Set only by the voice ticket's `409` (code `voice_conversation_active`): the chat the person's other\nvoice conversation runs in, `support`, `ken` or `onboarding`. Omitted on every other error.","nullable":true}},"additionalProperties":false,"description":"What went wrong in a request."},"ErrorDetail":{"type":"object","properties":{"field":{"type":"string","description":"The request field, header or limit the problem is about, such as `name` or `Ken-Version`."},"code":{"type":"string","description":"Stable code for this problem, such as `required` or `invalid`."},"message":{"type":"string","description":"A sentence for people that explains this problem."},"count":{"type":"integer","description":"On `export_limit_exceeded`, how many rows match the export. Omitted otherwise.","format":"int32","nullable":true},"index":{"type":"integer","description":"The position of the refused item in the request's list. Omitted otherwise.","format":"int32","nullable":true},"limit":{"type":"integer","description":"On `export_limit_exceeded`, the row limit the export ran with. On a `quota_exceeded` detail whose\n`field` names a quota, that quota's limit. On a `rate_limited` detail from your workspace's rate\nlimits, the limit that was hit. Omitted otherwise.","format":"int32","nullable":true},"resetAt":{"type":"string","description":"On some `quota_exceeded` details, when the quota frees up, in UTC. It is the same instant as the top-level\n`quotaResetAt`. On a `rate_limited` detail from your workspace's rate limits, when that limit resets.\nOmitted otherwise.","format":"date-time","nullable":true},"retryAfterSeconds":{"type":"integer","description":"On those `quota_exceeded` details and on most `rate_limited` details, the seconds to wait. It is the\nsame value as the `Retry-After` header. Omitted otherwise.","format":"int32","nullable":true},"inboxId":{"type":"integer","description":"The inbox the problem is about. Omitted otherwise.","format":"int64","nullable":true},"domainId":{"type":"integer","description":"The domain the problem is about. Omitted otherwise.","format":"int64","nullable":true},"domainName":{"type":"string","description":"The name of that domain, or the domain name the request gave. Omitted otherwise.","nullable":true},"accountId":{"type":"integer","description":"On `domain_taken`, `already_stakeholder` and `previously_removed`, the existing account to use\ninstead. Omitted otherwise.","format":"int64","nullable":true},"personId":{"type":"integer","description":"On `email_taken` and `linkedin_url_taken`, the existing person to use instead. Omitted otherwise.","format":"int64","nullable":true},"stakeholderId":{"type":"integer","description":"The account stakeholder the problem is about. Omitted otherwise.","format":"int64","nullable":true},"championId":{"type":"integer","description":"Not used. Always omitted.","format":"int64","nullable":true},"callTaskId":{"type":"integer","description":"On `call_task_exists`, the open call task that already holds the person's slot. Omitted otherwise.","format":"int64","nullable":true},"status":{"type":"string","description":"On `invalid_transition`, the current status. Omitted otherwise.","nullable":true},"allowed":{"type":"array","items":{"type":"string"},"description":"On `out_of_range`, the allowed values. On `invalid_transition`, the statuses the change is allowed\nfrom. Omitted otherwise.","nullable":true},"scope":{"type":"string","description":"On a `permission_denied` for an account owner change, the account scope the call needs (`all`). On\n`sending_paused`, what the pause covers: `inbox`, `domain` or `workspace`. Omitted otherwise.","nullable":true},"removedAt":{"type":"string","description":"On `previously_removed`, when a person removed the stakeholder, in UTC. Omitted otherwise.","format":"date-time","nullable":true},"page":{"type":"string","description":"On `permission_denied`, the page the call needs, such as `campaigns`. Omitted otherwise.","nullable":true},"required":{"type":"string","description":"On `permission_denied`, the access `page` needs: `view` or `edit`. Omitted otherwise.","nullable":true},"feature":{"type":"string","description":"On `permission_denied`, the permission the call needs, such as `launch`. Omitted otherwise.","nullable":true},"runId":{"type":"integer","description":"On `committee_run_active` and `run_not_finding`, the committee run the problem is about. Omitted\notherwise.","format":"int64","nullable":true},"mergedIntoId":{"type":"integer","description":"On `person_merged`, the person the merged person now lives on. On `account_merged`, the account the\nmerged account now lives on. Omitted otherwise.","format":"int64","nullable":true},"accounts":{"type":"array","items":{"$ref":"#/components/schemas/ErrorAccount"},"description":"On `person_on_accounts`, the accounts that block the change. Omitted otherwise.","nullable":true},"stage":{"type":"string","description":"On `stage_in_use` and `system_stage`, the opportunity stage key the problem is about. Omitted otherwise.","nullable":true},"opportunityCount":{"type":"integer","description":"On `stage_in_use`, how many opportunities are in that stage. Omitted otherwise.","format":"int32","nullable":true},"rule":{"type":"string","description":"On `guardrail_violation`, the contact limit rule the change breaks. Omitted otherwise.","nullable":true},"nextAllowedAt":{"type":"string","description":"On `guardrail_violation`, the first `dueAt` that passes every contact limit, in UTC. On a refused\nsend, when to retry. Omitted otherwise, and when waiting does not clear it.","format":"date-time","nullable":true},"fix":{"type":"string","description":"On a refused send, what to do next, in plain words. Omitted otherwise.","nullable":true},"opensAt":{"type":"string","description":"On `outside_calling_hours`, when the person's calling window opens, in UTC. Omitted otherwise.","format":"date-time","nullable":true},"currentVersion":{"type":"integer","description":"On a knowledge file's `version_conflict`, the file's current version. Omitted otherwise.","format":"int32","nullable":true},"provider":{"type":"string","description":"On a CRM connection error (`provider_error`, `exchange_failed`, `already_connected`,\n`account_mismatch` or `provider_unavailable`), the CRM it is about. Omitted otherwise.","nullable":true},"sharedWithMaster":{"type":"boolean","description":"True on a `quota_exceeded` detail when the shared limit of the white-label master workspace was hit, so\n`limit` is the limit of the whole white-label account. Omitted otherwise. The master's id is never sent.","nullable":true},"stepId":{"type":"integer","description":"On `link_reputation_blocked`, the saved sequence step that holds the blocked link. Omitted otherwise, and\nfor a step the save would have created.","format":"int64","nullable":true},"stepOrder":{"type":"integer","description":"On `link_reputation_blocked`, the `stepOrder` of that step. Omitted otherwise.","format":"int32","nullable":true},"url":{"type":"string","description":"On `link_reputation_blocked`, the blocked link as the step's copy writes it. Omitted otherwise.","nullable":true},"key":{"type":"string","description":"On `unfilled_template_key`, the template key the text still holds, such as `first_name` for\n`{first_name}`. Omitted otherwise.","nullable":true},"marker":{"type":"string","description":"On `unfilled_template_key`, that key as the text writes it, such as `{first_name}` or `[company]`.\nOmitted otherwise.","nullable":true},"retryAt":{"type":"string","description":"On a warm path Start's `guardrail_connector_monthly`, `guardrail_account_monthly`,\n`guardrail_connector_cooldown` and `guardrail_handoff_weekly`, when the limit frees up, in UTC. Omitted\notherwise.","format":"date-time","nullable":true},"workspaceId":{"type":"integer","description":"On `last_admin`, a workspace that needs a new admin before the account can be deleted. On\n`new_admin_not_found`, the workspace of the refused choice. Omitted otherwise.","format":"int64","nullable":true},"workspaceName":{"type":"string","description":"On `last_admin`, the name of that workspace. Omitted otherwise.","nullable":true},"class":{"type":"string","description":"On a `rate_limited` detail from your workspace's rate limits, the class of call that hit its limit:\n`read`, `write`, `bulk`, `heavy` or `sensitive`. Omitted otherwise.","nullable":true},"window":{"type":"string","description":"On that detail, the window whose limit was hit: `minute`, `day` or `bulkItemsDay`. Omitted\notherwise.","nullable":true}},"additionalProperties":false,"description":"One problem in an error: the field or limit it is about, a stable `code` and a `message`. The other fields\nappear only with the codes their descriptions name."},"Failure":{"type":"object","properties":{"success":{"type":"boolean","description":"Always false on an error."},"error":{"allOf":[{"$ref":"#/components/schemas/ErrorBody"}],"description":"What went wrong."},"quotaResetAt":{"type":"string","description":"When the quota that refused the request frees up, in UTC. Set on some quota refusals. Omitted otherwise.","format":"date-time","nullable":true},"currentVersion":{"type":"integer","description":"The current revision of a workflow draft, on a draft save's `409 version_conflict`. Read the workflow\nagain, then send this value as `baseVersion`. Omitted otherwise.","format":"int32","nullable":true},"current":{"allOf":[{"$ref":"#/components/schemas/MeetingRepNotesCurrent"}],"description":"Your meeting notes and their version as stored now, on a meeting notes save's `409 version_conflict`.\nMerge your change, then save again with `baseVersion` set to `current.repNotesVersion`. Omitted\notherwise."},"refusal":{"allOf":[{"$ref":"#/components/schemas/Refusal"}],"description":"A copy of `error.refusal`, set on some billing refusals. Omitted otherwise."},"message":{"type":"string","description":"A copy of `error.message`, set together with `refusal`. Omitted otherwise.","nullable":true},"lookalikeSeeds":{"description":"How Kenso read each seed of a lookalike search, on its `422 no_usable_seeds`:\n`{resolved: [{input, companyId, personId, name, domain}], unresolved: [{input, reason}]}`. Use it to show\nwhy no seed was usable. Omitted otherwise."}},"additionalProperties":false,"description":"The body of every error, with a 4xx or 5xx status. Branch on `error.code`."},"InvalidationImpact":{"type":"object","properties":{"qualificationResponses":{"type":"integer","description":"Stored qualification answers the change would clear.","format":"int32"},"qualifiedFlags":{"type":"integer","description":"Contacts whose qualified result the change would clear.","format":"int32"},"segmentationReasoning":{"type":"integer","description":"Stored segmentation explanations the change would clear.","format":"int32"},"segmentationAssignmentsKept":{"type":"integer","description":"Contacts that keep their segment.","format":"int32"},"segmentationAssignmentsReset":{"type":"integer","description":"Contacts that go back to the default segment.","format":"int32"},"personalizationLines":{"type":"integer","description":"Personalized lines the change would clear.","format":"int32"},"personalizationLeads":{"type":"integer","description":"Contacts that would lose their personalized lines.","format":"int32"},"rewritingLines":{"type":"integer","description":"Rewritten lines the change would clear.","format":"int32"},"rewritingLeads":{"type":"integer","description":"Contacts that would lose their rewritten lines.","format":"int32"}},"additionalProperties":false,"description":"How much stored AI output a change would clear in each AI step of a campaign, and how many segment assignments it\nkeeps or resets."},"LinkedInAccount":{"type":"object","properties":{"id":{"type":"integer","description":"The LinkedIn account id.","format":"int64"},"displayName":{"type":"string","description":"The account's name as Kenso shows it. Omitted when not set.","nullable":true},"publicIdentifier":{"type":"string","description":"The profile's public id, the last part of its LinkedIn URL. Omitted when not known.","nullable":true},"profileUrl":{"type":"string","description":"The LinkedIn profile URL. Omitted when not known.","nullable":true},"profileImageUrl":{"type":"string","description":"The URL of the profile photo. Omitted when there is none.","nullable":true},"headline":{"type":"string","description":"The profile headline. Omitted when there is none.","nullable":true},"status":{"type":"string","description":"The connection state: `connecting` (the connect session has not finished), `connected`,\n`credentials_error` (sign in again through a reconnect), `restricted` (LinkedIn restricted the\nprofile), `disconnected`, `deleted` or `connect_failed`. A pause shows in `pausedAt`, not\nhere."},"timezone":{"type":"string","description":"The account's IANA time zone, such as `Europe/London`. Omitted when not set, which means UTC.","nullable":true},"workingHours":{"type":"string","description":"The stored working hours, as a JSON string. Omitted when not set. `workingHoursSchedule` gives the same\nhours as an object, with the defaults filled in.","nullable":true},"dailyInviteCap":{"type":"integer","description":"The most connection invites the account sends per day.","format":"int32"},"dailyMessageCap":{"type":"integer","description":"The most messages and InMails the account sends per day.","format":"int32"},"dailyVisitCap":{"type":"integer","description":"The most profile visits the account makes per day.","format":"int32"},"createdAt":{"type":"string","description":"When the account was added to Kenso, in UTC.","format":"date-time"},"createdDatetime":{"type":"string","description":"The same value as `createdAt`. Use `createdAt`.","format":"date-time"},"updatedAt":{"type":"string","description":"When Kenso last synced the account's profile, in UTC. Omitted when it never has.","format":"date-time","nullable":true},"unipileAccountId":{"type":"string","description":"The id Kenso's LinkedIn connection uses for the account. Kenso support may ask for it. Omitted until the account\nconnects.","nullable":true},"statusChangedAt":{"type":"string","description":"When `status` last changed, in UTC. Omitted when it never has.","format":"date-time","nullable":true},"invitesToday":{"type":"integer","description":"Invites sent today, since the start of the account's day or over the last 24 hours, depending on how Kenso\ncounts the account's limits. Compare with `dailyInviteCap`. Omitted when Kenso could not read the counts.","format":"int32","nullable":true},"messagesToday":{"type":"integer","description":"Messages and InMails sent today, counted the same way as `invitesToday`.","format":"int32","nullable":true},"visitsToday":{"type":"integer","description":"Profile visits made today, counted the same way as `invitesToday`.","format":"int32","nullable":true},"invitesSent30d":{"type":"integer","description":"Invites sent in the last 30 days. Omitted when Kenso could not read it.","format":"int32","nullable":true},"acceptRate":{"type":"number","description":"The share of `invitesSent30d` that were accepted, from 0 to 1. Omitted when no invite was sent in that\ntime.","format":"double","nullable":true},"usedBy":{"allOf":[{"$ref":"#/components/schemas/UsedBy"}],"description":"The live campaigns that use this account, and whether Accounts uses it for one-to-one outreach. Omitted when\nKenso could not read it."},"lastActionAt":{"type":"string","description":"When the account last finished an outreach action, in UTC: the newest confirmed campaign step or Accounts\ntouch. A person's replies from the Inbox do not count. Omitted when there is none, or Kenso could not read it.","format":"date-time","nullable":true},"lastActionType":{"type":"string","description":"The action at `lastActionAt`: `visit`, `invite`, `message`, `inmail`,\n`voice_message`, `withdraw`, `follow`, `reaction`, `comment` or `endorse`.\nOmitted when `lastActionAt` is.","nullable":true},"pausedAt":{"type":"string","description":"When a member paused the account, in UTC. Omitted when it is not paused. A paused account sends no outreach\n(invites, messages, InMails, profile visits, withdrawals and approved Accounts notes), and neither do Ken's\nautonomous replies. They wait and go out after a resume. A person's replies from the Inbox and inbox sync keep\nrunning. Separate from `status`.","format":"date-time","nullable":true},"connectedByMemberId":{"type":"integer","description":"The member who connected the account. Outreach from it that needs approval waits for this member. Omitted for\nan account connected before Kenso recorded this.","format":"int64","nullable":true},"importConnections":{"type":"boolean","description":"True when Kenso imports the account's LinkedIn connections into Accounts as people and companies. Only the\nmember who connected the account or a workspace admin can change it."},"handoffsMutedAt":{"type":"string","description":"When the account's owner muted warm path handoffs on it, in UTC. Omitted when not muted. While any account an owner\nconnected is muted, no teammate's warm path hands that owner a hop.","format":"date-time","nullable":true},"researchReadsEnabledAt":{"type":"string","description":"When the account's owner turned on research reads, in UTC. Omitted when off. While it is set, Kenso may read public\nLinkedIn posts on the account a few times a day, inside its working hours.","format":"date-time","nullable":true},"importConnectionsChangedAt":{"type":"string","description":"When `importConnections` last changed, in UTC. Omitted when it never has.","format":"date-time","nullable":true},"networkOnly":{"type":"boolean","description":"True when the account only lends its owner's LinkedIn network to the workspace. Kenso syncs its connections and\nchats, but never adds it to a campaign, never picks it as an account's sending account and never sends from it\non its own. Set when the account connects; a workspace admin can change it."},"removedFromCampaignIds":{"type":"array","items":{"type":"integer","format":"int64"},"description":"Only on the update that made the account network-only: the ids of the campaigns it sent for and was taken out\nof, ascending. Omitted otherwise.","nullable":true},"workingHoursSchedule":{"allOf":[{"$ref":"#/components/schemas/LinkedInWeeklySchedule"}],"description":"The account's working hours for each day of the week as Kenso applies them, in the account's\n`timezone`. Days not set use the defaults: Monday to Friday open 08:00 to 18:00, Saturday and Sunday\nclosed. A closed day still shows 08:00 to 18:00."},"products":{"allOf":[{"$ref":"#/components/schemas/LinkedInAccountProducts"}],"description":"The paid LinkedIn products on the account, as LinkedIn last reported them. Omitted until Kenso first checks."},"invitesLast7Days":{"type":"integer","description":"Invites sent in the last 7 days. Compare with `weeklyInviteCap`. This field and the other safety fields\n(`weeklyInviteCap`, `pendingInvites`, `pendingInviteCap`, `health`, `rampStage`,\n`rampInviteCap` and `safetyEnabled`) are omitted together when Kenso could not read them.","format":"int32","nullable":true},"weeklyInviteCap":{"type":"integer","description":"The most invites the account sends in any 7 days, at most 100.","format":"int32","nullable":true},"pendingInvites":{"type":"integer","description":"Invites still waiting for an answer, as the higher of Kenso's count and LinkedIn's.","format":"int32","nullable":true},"pendingInviteCap":{"type":"integer","description":"The account sends no new invites while `pendingInvites` is at or above this number.","format":"int32","nullable":true},"health":{"allOf":[{"$ref":"#/components/schemas/LinkedInAccountHealth"}],"description":"How well the account's invites are being accepted, over invites sent 3 to 30 days ago."},"rampStage":{"type":"integer","description":"The account's ramp stage: 0, 1 and 2 in its first three weeks, while Kenso raises a new account's invite\nvolume week by week, then 3 at full volume. It stops moving while `rampPlansEnabled` is true.","format":"int32","nullable":true},"rampInviteCap":{"type":"integer","description":"Today's invite cap from the ramp: 5, 10, then 20, then the account's `dailyInviteCap`. While\n`rampPlansEnabled` is true, today's cap of the invite row of `ramp`.","format":"int32","nullable":true},"safetyEnabled":{"type":"boolean","description":"False while Kenso shows the safety values but does not apply the weekly, pending and low acceptance caps yet.","nullable":true},"rampPlansEnabled":{"type":"boolean","description":"True once Kenso runs LinkedIn on the per-action ramp: the account's daily caps come from `ramp`. False\nwhile the caps still follow `rampStage` and `rampInviteCap`. Omitted when Kenso could not read it.","nullable":true},"rampStartedAt":{"type":"string","description":"When the ramp's week 0 started, UTC. Only while `rampPlansEnabled` is true.","format":"date-time","nullable":true},"ramp":{"type":"array","items":{"$ref":"#/components/schemas/LinkedInRampAction"},"description":"One row per action (invite, message, visit, follow, reaction, comment, endorse, accept): today's cap, the plan's\nstart, weekly step and ceiling, the week index and the date today's cap reaches the ceiling. Only while\n`rampPlansEnabled` is true. Edit it with `ramp` in `PATCH /v1/linkedin-accounts/{linkedinAccountId}`\nand restart it with `POST /v1/linkedin-accounts/{linkedinAccountId}/ramp/reset`.","nullable":true},"tagIds":{"type":"array","items":{"type":"integer","format":"int64"},"description":"Ids of the workspace's tags on the account, in ascending order. Empty when it has none. Set them with\n`POST /v1/tags/{tagId}/assignments` and `entityType` `linkedin_account`. Only\n`GET /v1/linkedin-accounts`, `GET /v1/linkedin-accounts/{linkedinAccountId}` and\n`PATCH /v1/linkedin-accounts/{linkedinAccountId}` carry it, and they omit it when Kenso could not read the\ntags. Other lists of LinkedIn accounts, such as a campaign's, never carry it.","nullable":true},"safetyHolds":{"type":"array","items":{"$ref":"#/components/schemas/LinkedInAccountSafetyHold"},"description":"The safety holds Kenso has on the account right now, at most one per `scope`, ordered `all_writes`,\n`invites`, `invite_notes`. Empty when it has none, or when Kenso could not read them. Only\n`GET /v1/linkedin-accounts`, `GET /v1/linkedin-accounts/{linkedinAccountId}`,\n`PATCH /v1/linkedin-accounts/{linkedinAccountId}` and its ramp reset carry it. Other lists of LinkedIn\naccounts, such as a campaign's, never carry it.","nullable":true}},"additionalProperties":false,"description":"A LinkedIn account connected to the workspace, with its limits, today's usage and the safety caps Kenso applies.\nWhich fields a response carries depends on the call.","example":{"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":[]}},"LinkedInAccountHealth":{"type":"object","properties":{"status":{"type":"string","description":"Either `healthy` or `low_acceptance`. An account becomes `low_acceptance` when under 20% of at\nleast 40 invites were accepted, and goes back to `healthy` at 25%. While it is `low_acceptance`, it\nsends at most 5 invites a day."},"acceptRate":{"type":"number","description":"The share of the `sample` invites that were accepted, from 0 to 1. Omitted when `sample` is 0.","format":"double","nullable":true},"sample":{"type":"integer","description":"How many invites were sent 3 to 30 days ago.","format":"int32"},"changedAt":{"type":"string","description":"When `status` last changed, in UTC. Omitted when it never has.","format":"date-time","nullable":true}},"additionalProperties":false,"description":"How well a LinkedIn account's connection invites are being accepted."},"LinkedInAccountListResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"Always true on a success."},"data":{"type":"array","items":{"$ref":"#/components/schemas/LinkedInAccount"},"description":"The items on this page."},"pagination":{"allOf":[{"$ref":"#/components/schemas/Pagination"}],"description":"Where this page ends and how to get the next one."}},"additionalProperties":false,"description":"The body of a successful list operation: one page of results in `data`, and `pagination` to get the next\npage."},"LinkedInAccountProducts":{"type":"object","properties":{"premium":{"type":"boolean","description":"True when the account has LinkedIn Premium."},"salesNavigator":{"type":"boolean","description":"True when the account has Sales Navigator."},"recruiter":{"type":"boolean","description":"True when the account has LinkedIn Recruiter."},"checkedAt":{"type":"string","description":"When Kenso last checked the products, in UTC.","format":"date-time"}},"additionalProperties":false,"description":"The paid LinkedIn products on a LinkedIn account."},"LinkedInAccountResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"Always true on a success."},"data":{"allOf":[{"$ref":"#/components/schemas/LinkedInAccount"}],"description":"The result of the operation."}},"additionalProperties":false,"description":"The body of a successful operation that returns one result. The result is in `data`."},"LinkedInAccountSafetyHold":{"type":"object","properties":{"scope":{"allOf":[{"$ref":"#/components/schemas/LinkedInAccountSafetyHoldScope"}],"description":"The writes the hold stops: `all_writes` (every invite, message, InMail, profile visit and other outreach\naction), `invites` (new connection invites) or `invite_notes` (the note on an invite; the invite still\ngoes out without it)."},"until":{"type":"string","description":"When the hold ends, in UTC.","format":"date-time"},"reason":{"type":"string","description":"Why Kenso placed the hold, in words a member can read."},"source":{"type":"string","description":"The check that placed the hold, as a short code such as `account_warning`, `invite_streak`,\n`provider_streak`, `note_quota` or `reconnect_quiet`. New codes may be added."}},"additionalProperties":false,"description":"A safety hold Kenso placed on a LinkedIn account: until `until`, the account sends none of the writes\n`scope` names. Kenso places and lifts holds on its own; a member cannot."},"LinkedInAccountSafetyHoldScope":{"enum":["all_writes","invites","invite_notes"],"type":"string","description":"Which writes a LinkedIn account's safety hold stops."},"LinkedInConnectSession":{"type":"object","properties":{"linkedInAccountId":{"type":"integer","description":"The LinkedIn account the session connects: a new account with status `connecting`, or the account being\nreconnected.","format":"int64"},"url":{"type":"string","description":"The hosted page where the user signs in to LinkedIn. Open it within one hour."}},"additionalProperties":false,"description":"A LinkedIn connect session: the page where the user signs in to connect or reconnect a LinkedIn account."},"LinkedInConnectSessionResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"Always true on a success."},"data":{"allOf":[{"$ref":"#/components/schemas/LinkedInConnectSession"}],"description":"The result of the operation."}},"additionalProperties":false,"description":"The body of a successful operation that returns one result. The result is in `data`."},"LinkedInRampAction":{"type":"object","properties":{"action":{"type":"string","description":"invite, message, visit, follow, reaction, comment, endorse or accept."},"todayCap":{"type":"integer","description":"Today's cap: `min(ceiling, start + stepPerWeek * weekIndex)`, then the action's hard ceiling.","format":"int32"},"start":{"type":"integer","description":"The cap in week 0.","format":"int32"},"stepPerWeek":{"type":"integer","description":"How much the cap rises each full week.","format":"int32"},"ceiling":{"type":"integer","description":"The cap the ramp stops at, at most the action's hard ceiling.","format":"int32"},"weekIndex":{"type":"integer","description":"Full weeks since `rampStartedAt`, in the account's time zone.","format":"int32"},"fullVolumeOn":{"type":"string","description":"The date the action reaches its ceiling (YYYY-MM-DD), in the account's time zone. `9999-12-31` when it\nnever does (no weekly step and a start below the ceiling).","format":"date"}},"additionalProperties":false,"description":"One action's row of a LinkedIn account's ramp."},"LinkedInRampActionEdit":{"type":"object","properties":{"start":{"type":"integer","description":"The cap in week 0.","format":"int32","nullable":true},"stepPerWeek":{"type":"integer","description":"How much the cap rises each full week.","format":"int32","nullable":true},"ceiling":{"type":"integer","description":"The cap the ramp stops at.","format":"int32","nullable":true}},"additionalProperties":false,"description":"One action's ramp in `PATCH /v1/linkedin-accounts/{linkedinAccountId}`, the value under its action key. Absent\nnumbers keep the current value."},"LinkedInWeeklySchedule":{"type":"object","properties":{"mon":{"allOf":[{"$ref":"#/components/schemas/LinkedInWorkingDay"}],"description":"One day of a LinkedIn account's working hours. Times are `HH:mm` in the account's time zone."},"tue":{"allOf":[{"$ref":"#/components/schemas/LinkedInWorkingDay"}],"description":"One day of a LinkedIn account's working hours. Times are `HH:mm` in the account's time zone."},"wed":{"allOf":[{"$ref":"#/components/schemas/LinkedInWorkingDay"}],"description":"One day of a LinkedIn account's working hours. Times are `HH:mm` in the account's time zone."},"thu":{"allOf":[{"$ref":"#/components/schemas/LinkedInWorkingDay"}],"description":"One day of a LinkedIn account's working hours. Times are `HH:mm` in the account's time zone."},"fri":{"allOf":[{"$ref":"#/components/schemas/LinkedInWorkingDay"}],"description":"One day of a LinkedIn account's working hours. Times are `HH:mm` in the account's time zone."},"sat":{"allOf":[{"$ref":"#/components/schemas/LinkedInWorkingDay"}],"description":"One day of a LinkedIn account's working hours. Times are `HH:mm` in the account's time zone."},"sun":{"allOf":[{"$ref":"#/components/schemas/LinkedInWorkingDay"}],"description":"One day of a LinkedIn account's working hours. Times are `HH:mm` in the account's time zone."}},"additionalProperties":false,"description":"A LinkedIn account's working hours, one entry per day from `mon` to `sun`, in the account's time zone.\nKenso runs the account's LinkedIn actions only inside these hours. A day with no entry uses the default: 08:00 to\n18:00 on weekdays, closed on weekends. An update must include all seven days."},"LinkedInWorkingDay":{"type":"object","properties":{"open":{"type":"boolean","description":"True when the account works on this day; false when it takes the day off.","nullable":true},"start":{"type":"string","description":"When the working day starts, such as `09:00`.","nullable":true},"end":{"type":"string","description":"When the working day ends, such as `17:30`.","nullable":true}},"additionalProperties":false,"description":"One day of a LinkedIn account's working hours. Times are `HH:mm` in the account's time zone."},"MeetingRepNotesCurrent":{"type":"object","properties":{"repNotes":{"type":"string","description":"Your notes as stored now. Empty before your first save."},"repNotesVersion":{"type":"integer","description":"The stored notes' version. Send it as `baseVersion` when you save again.","format":"int32"}},"additionalProperties":false,"description":"Your meeting notes as Kenso stores them now, sent with a `409 version_conflict` on a notes save."},"Pagination":{"type":"object","properties":{"nextCursor":{"type":"string","description":"Send this value as `cursor` to get the next page. Omitted on the last page.","nullable":true},"hasMore":{"type":"boolean","description":"True when more items follow this page. Stop paging when it is false."},"total":{"type":"integer","description":"Deprecated: the same number as `totalCount`. Read `totalCount`.","format":"int32","nullable":true,"deprecated":true},"totalCount":{"type":"integer","description":"The number of items that match the list's filters, across all pages. Omitted when the list does not count them.","format":"int32","nullable":true},"isTotalCapped":{"type":"boolean","description":"True when `totalCount` stopped counting at its cap, so more items match than it says. Keep paging with\n`hasMore`. Omitted when `totalCount` is exact. Only `GET /v1/threads` with `q` caps its total.","nullable":true}},"additionalProperties":false,"description":"Where a list page ends and how to get the next page."},"RateLimitedText":{"type":"string","description":"The gateway's plain-text body of a `429` over the operation's own limit, until November 2026: `Number of requests exceeded. Please try again later.`","example":"Number of requests exceeded. Please try again later."},"Refusal":{"type":"object","properties":{"code":{"type":"string","description":"Stable refusal code in upper case, such as `CAMPAIGN_LIMIT_REACHED` or `INSUFFICIENT_CREDITS`."},"metric":{"type":"string","description":"What the limit counts: `Campaigns`, `Leads`, `Emails`, `LinkedInSeats` or `AiCredits`,\n`jobs_export_rows` or `funding_export_rows` for an export allowance, `credit_pack_credits`,\n`credit_spend_usd_7d`, `domains` or `mailboxes` for a limit on a new paying workspace, or for a\nKenso Lifetime cap its key: `workspaces`, `inboxes`, `contacts`, `email_verifications_day`,\n`email_verifications_month`, `people_results_day`, `company_results_day`,\n`funding_results_day`, `job_post_results_day`, `website_visits_month` or\n`visitor_lookups_day`. Omitted when a plan rule, not a count, refused the request.","nullable":true},"used":{"type":"integer","description":"How much of the limit is used, in the unit of `metric`. Omitted when the refusal has no count.","format":"int32","nullable":true},"limit":{"type":"integer","description":"The limit, in the unit of `metric`. Omitted when the refusal has no count.","format":"int32","nullable":true},"remaining":{"type":"integer","description":"How much of the limit is left, in the unit of `metric`. Omitted when the refusal has no count.","format":"int32","nullable":true},"planType":{"type":"string","description":"The workspace's plan as its snake plan id, for example `free`, `legacy_core` or `growth`."},"remedy":{"type":"string","description":"What lifts the refusal: `Upgrade`, `BuyAddOn`, `UpdatePaymentMethod` or `ContactSupport`.\n`None` means no action of yours lifts it."},"unlocksAt":{"type":"string","description":"When the limit lifts by itself, in UTC: for a limit on a new paying workspace once it has paid an invoice, and for\na Kenso Lifetime daily or monthly cap its reset (00:00 UTC, or the 1st of the month). Omitted on every other\nrefusal.","format":"date-time","nullable":true},"requiredMillicredits":{"type":"integer","description":"On a credit refusal, the millicredits the action needed. 1,000 millicredits are one credit. Omitted on every\nother refusal.","format":"int64","nullable":true},"availableMillicredits":{"type":"integer","description":"On a credit refusal, the millicredits available. On `FREE_CREDITS_NOT_ELIGIBLE`, only the credits that may\npay for inboxes and domains. Omitted on every other refusal.","format":"int64","nullable":true},"restrictedMillicredits":{"type":"integer","description":"On `FREE_CREDITS_NOT_ELIGIBLE`, the free and bonus millicredits in the balance that cannot pay for inboxes\nand domains. Omitted on every other refusal.","format":"int64","nullable":true},"feature":{"type":"string","description":"On `PLAN_FEATURE_NOT_AVAILABLE`, the plan feature the plan does not include, in snake case (for example\n`website_visitor_id`). Omitted on every other refusal.","nullable":true},"requiredPlan":{"type":"string","description":"On `PLAN_FEATURE_NOT_AVAILABLE`, the cheapest plan that includes `feature`, in snake case (for example\n`growth`). For a feature the self-serve trial locks (`browser_runs`), the trial's own plan,\nwhich paying for unlocks it. Omitted on every other refusal.","nullable":true},"requiredTier":{"type":"integer","description":"On a Kenso Lifetime refusal, the lowest tier that lifts it: the next tier with a higher cap, or the lowest tier\nthat includes `feature`. Omitted at the top tier, when no tier includes the feature, and on every other\nrefusal.","format":"int32","nullable":true},"upgradeUrl":{"type":"string","description":"On a Kenso Lifetime refusal that a higher tier lifts, the AppSumo page where the buyer upgrades their license.\nOmitted until Kenso has read that page from AppSumo, when no tier lifts the refusal, and on every other refusal.","nullable":true}},"additionalProperties":false,"description":"Why a plan rule or usage limit refused the request, and how to lift it."},"ServiceUnavailableError":{"oneOf":[{"$ref":"#/components/schemas/Failure"},{"$ref":"#/components/schemas/ApiKeyError"}],"description":"The body of a `503`: the error body (`Failure`). When Kenso cannot check the API key, its code is `auth_unavailable`, with `Retry-After: 5`. Until November 2026 the API key check in front of the operations answered `{ \"error\": \"Authentication is temporarily unavailable\" }` (`ApiKeyError`) there instead, so handle both shapes. Retry after the `Retry-After` seconds."},"TooManyRequestsError":{"oneOf":[{"$ref":"#/components/schemas/Failure"},{"$ref":"#/components/schemas/ApiKeyError"}],"description":"The JSON body of a `429`: the error body (`Failure`), with code `rate_limited` or `quota_exceeded`, over your workspace's rate limits, your API key's own limit, the operation's own limit or a usage quota. Until November 2026, over your API key's own limit the API key check answered `{ \"error\": \"Rate limit exceeded\" }` (`ApiKeyError`), and over the operation's own limit the gateway answered plain text (`RateLimitedText`): `Number of requests exceeded. Please try again later.` A client built against those answers keeps working: handle each shape. Wait the `Retry-After` seconds."},"UnauthorizedError":{"oneOf":[{"$ref":"#/components/schemas/Failure"},{"$ref":"#/components/schemas/ApiKeyError"}],"description":"The body of a `401`: the error body (`Failure`), whose `code` says what is wrong with the credential. Until November 2026, when the API key was not valid (unknown, expired or revoked, or its member no longer active), the API key check in front of the operations answered `{ \"error\": \"Invalid or revoked API key\" }` (`ApiKeyError`), and a request with no API key got a `401` that has no body. A client built against those answers keeps working: handle both shapes and a `401` with no body."},"UpdateLinkedInAccountBody":{"type":"object","properties":{"displayName":{"type":"string","description":"The account's name as Kenso shows it, at most 255 characters.","nullable":true},"timezone":{"type":"string","description":"An IANA time zone, such as `Europe/Bucharest`. An empty string clears it, and the account then works in\nUTC.","nullable":true},"workingHours":{"type":"string","description":"The working hours as a JSON string, keyed `mon` to `sun`. Prefer `workingHoursSchedule`, and\nsend only one of the two.","nullable":true},"workingHoursSchedule":{"allOf":[{"$ref":"#/components/schemas/LinkedInWeeklySchedule"}],"description":"The account's working hours for all seven days, `mon` to `sun`, each with `open`,\n`start` and `end`. Times are HH:mm in the account's time zone. `start` and `end` are\nrequired on an open day, and at least one day must be open. An invalid day returns\n`400 validation_failed` that names it."},"dailyInviteCap":{"type":"integer","description":"The most connection invites per day. Kenso keeps it between 1 and the platform maximum, at most 20.","format":"int32","nullable":true},"dailyMessageCap":{"type":"integer","description":"The most messages and InMails per day. Kenso keeps it between 1 and the platform maximum, at most 50.","format":"int32","nullable":true},"dailyVisitCap":{"type":"integer","description":"The most profile visits per day. Kenso keeps it between 1 and the platform maximum, at most 80.","format":"int32","nullable":true},"paused":{"type":"boolean","description":"Set to `true` to pause outreach from the account: campaign invites, messages, InMails, profile visits,\nwithdrawals, approved Accounts notes and Ken's autonomous replies wait. An account already paused keeps its\nfirst `pausedAt`. `false` resumes it, and the waiting actions go on where they stopped. Replies a\nmember sends from the Inbox and inbox sync keep running while paused. Omit it or send `null` to leave the\npause as it is.","nullable":true},"importConnections":{"type":"boolean","description":"Set to `true` to import the account's LinkedIn connections into Accounts as people and companies.\n`false` stops new imports and keeps what was already imported. Only the member who connected the account or\na workspace admin may send it, and the workspace needs the `linkedin_connections_import` feature. Omit it\nor send `null` to leave it as it is.","nullable":true},"networkOnly":{"type":"boolean","description":"Set to `true` to make the account network-only: Kenso keeps syncing its connections and chats, takes it out\nof every campaign it sends for (the response lists them in `removedFromCampaignIds`) and never sends from it\non its own. `false` makes it a full account again; it joins no campaign by itself. Only the member who\nconnected the account or a workspace admin may send it, and `true` needs the `warm_paths_v2` feature\n(`false` does not). `false` is refused for an account a Network member connected. Omit it or send\n`null` to leave it as it is.","nullable":true},"handoffsMuted":{"type":"boolean","description":"Set to `true` to mute warm path handoffs: while it is set, no teammate's warm path hands you a hop through\nthis or any other account you own (their Start is refused with `guardrail_handoff_muted`). `false`\nunmutes this account. Only the member who connected the account or a workspace admin may send it, and `true`\nneeds the `warm_paths_v2` feature (`false` does not). Omit it or send `null` to leave it as it is.","nullable":true},"researchReads":{"type":"boolean","description":"Set to `true` to turn on research reads: Kenso may then read public LinkedIn posts on this account a few\ntimes a day, inside its working hours, and `researchReadsEnabledAt` is set. `false` turns them off. Only\nthe member who connected the account may send `true`; that member or a workspace admin may send `false`.\nOmit it or send `null` to leave it as it is.","nullable":true},"ramp":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/LinkedInRampActionEdit"},"description":"Per-action ramp edits, accepted only while the account's `rampPlansEnabled` is true (otherwise\n`400 validation_failed`, code `feature_off`). An object keyed by action (invite, message, visit, follow,\nreaction, comment, endorse, accept): `{ \"invite\": { \"start\": 5, \"stepPerWeek\": 5, \"ceiling\": 20 } }`.\nEach value takes any of `start`, `stepPerWeek` and `ceiling`; absent numbers keep the current\nvalue, and every value is clamped to the action's hard ceiling. While `rampPlansEnabled` is true, `dailyInviteCap`,\n`dailyMessageCap` and `dailyVisitCap` also set the invite, message and visit ceilings; a `ramp`\nentry for the same action wins.","nullable":true}},"additionalProperties":false,"description":"The LinkedIn account fields to change. Fields you leave out stay as they are."},"UsedBy":{"type":"object","properties":{"campaigns":{"type":"array","items":{"$ref":"#/components/schemas/UsedByCampaign"},"description":"The live campaigns (scheduled, launching or sending) that use this inbox or LinkedIn account, ordered by id.\nEmpty when there are none."},"accounts":{"type":"boolean","description":"True when Accounts uses it for one-to-one outreach. An inbox counts when it is its member's primary inbox\n(`isPrimary`). A LinkedIn account counts when the member who connected it owns at least one live account\nin Accounts, because an account's LinkedIn steps go out from the LinkedIn account its owner connected.","nullable":true}},"additionalProperties":false,"description":"What an inbox or LinkedIn account is used for: the live campaigns that send through it, and whether Accounts\nuses it for one-to-one outreach."},"UsedByCampaign":{"type":"object","properties":{"id":{"type":"integer","description":"The campaign id.","format":"int64"},"name":{"type":"string","description":"The campaign's name."},"status":{"type":"string","description":"The campaign's status, with the same values as `GET /v1/campaigns`."}},"additionalProperties":false,"description":"A live campaign that uses an inbox or LinkedIn account."}}}}