{"openapi":"3.0.4","info":{"title":"Kenso API: Accounts","version":"1.1","description":"The 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":"accounts","description":"An account is a company you sell to: the record its people, deals, meeting notes and activity hang on. Kenso\nmatches accounts by domain, so one company is one account. List accounts with `domain` to find one, and create\none from its domains: a domain another account owns answers `409 conflict` with that account's id. Update,\nmerge and delete accounts, read an account's website, LinkedIn and careers links, and add the account's people to a\ncampaign. A field a person sets is pinned, so Kenso's own updates leave it as it is.","x-displayName":"Accounts"}],"paths":{"/v1/accounts":{"get":{"tags":["accounts"],"summary":"List accounts in the current workspace.","description":"Filters: `stage` (comma = OR: new, researching, warming, engaged, meeting_booked, in_deal, onboarding, client, churned, nurture, paused, lost, network, not_a_fit, competitor, do_not_contact),\n`stageGroup` (comma = OR: to_sort, pipeline, customers, later, network, archive:\nto_sort is new, pipeline is researching to in_deal, customers is onboarding, client and churned, later is nurture,\npaused and lost, network is network, archive is not_a_fit, competitor and do_not_contact), `ownerMemberId`, `domain` (any domain, URL or email; normalized),\n`q` (name or domain contains), `nextTouchBefore`, `latestSignalAfter` (the latest\nsignal's event time is at or after it), `tagIds` (comma = OR: accounts carrying any of these tags; up to\n100 positive ids, anything else is `400 validation_failed`), `hasOpenOpportunity` (`true`:\naccounts with an open opportunity, `false`: accounts without), `isCustomer` (`true`: customer\naccounts, `false`: the rest), `accountType` (comma = OR: prospect, client, lost, churned, partner,\ncompetitor, investor, do_not_contact; it follows the stage), `fitsIcp`\n(`true`: accounts that fit the ICP, which are the accounts\nToday surfaces for their signals: none of the account's domains is one of the workspace's own domains (Settings >\nCompany domains and the Primary), its stage is in pipeline or later, and research has not scored its fit below 20\n(an account not researched yet fits); `false`: the accounts that do not), `whyNotNow` (comma = OR: stop,\nwait: accounts whose current `whyNotNow` has that outcome; a wait whose `until` has passed, and one that was\nundone or released, does not match; `stop,wait` is every account Kenso is holding back). `sort`: up to 3\ncomma-separated keys, each `field` (ascending), `-field` (descending), `field:asc` or\n`field:desc`, default `-createdAt`. Fields: `createdAt`, `name`, `score`, `tier`\n(ascending is tier 1 first), `latestSignalAt`, `committee` (the engaged share), `pipelineAmount`,\n`nextTouchAt`, `lastTouchAt`; an account with no value for a key comes last in both directions\n(`-score`: highest first, never scored last). Today's Heating up is\n`latestSignalAfter=<now - 7 days>&fitsIcp=true&sort=-score&limit=4`.\nEach item embeds its domains, its `tagIds` and, when it has one, its `latestSignal`, and carries\n`openOpportunityCount`, `openPipelineAmount` and `openOpportunityStage`, and, once handed off,\nits latest `handoff`. `score` (0-99), `scoredAt`, `signalCount` and\n`engagedPeopleCount` are absent until the account is first scored. `expand=committee` adds each\naccount's `committee`: `stakeholderCount`, `openSeatCount`, `coverage` (covered stakeholders, and the total\nof stakeholders and open seats), `roles` (role, stakeholderCount and openSeatCount per role\nthat has either) and `run`, Ken's latest run mapping the buying committee (omitted when Ken never\nmapped the account). Without `expand` there is no `committee`. `limit`: 1-1000, default 50.\n\n`ids` (comma, 1 to 100 account ids) returns those accounts in one call, each exactly as\n`GET /v1/accounts/{accountId}` returns it, in the order sent: `expand=stakeholders` embeds up to 200\nstakeholders each with their person (research is one account's read: use `accounts.get`). An id that is\nmissing, deleted, another workspace's or outside the caller's account scope is left out; a merged id answers with\nthe account it was merged into, and each account comes back once. Every account is on one page\n(`pagination.hasMore` is false). With `ids`, any other parameter but `expand` is\n`400 validation_failed`. Requires Accounts view.\n\nRate limit: 12,000 calls a minute per API key, on top of the workspace limits.\n\nNeeds the `accounts` feature on your workspace. Until it is on, calls answer 404.","operationId":"accounts.list","parameters":[{"name":"stage","in":"query","description":"Comma-separated stages, OR: new, researching, warming, engaged, meeting_booked, in_deal, onboarding, client, churned,\nnurture, paused, lost, network, not_a_fit, competitor, do_not_contact.","schema":{"type":"string"}},{"name":"stageGroup","in":"query","description":"Comma-separated stage groups, OR: to_sort (new), pipeline (researching to in_deal), customers (onboarding,\nclient, churned), later (nurture, paused, lost), network (network), archive (not_a_fit, competitor, do_not_contact).","schema":{"type":"string"}},{"name":"ownerMemberId","in":"query","schema":{"type":"integer","format":"int64"}},{"name":"domain","in":"query","description":"A domain, website URL or email. Normalized to the registrable domain.","schema":{"type":"string"}},{"name":"q","in":"query","description":"Contains, case-insensitive, on the name or any domain.","schema":{"type":"string"}},{"name":"nextTouchBefore","in":"query","description":"Accounts with an open touch due before this time.","schema":{"type":"string","format":"date-time"}},{"name":"latestSignalAfter","in":"query","description":"Accounts whose latest signal's event time is at or after this time (inclusive).","schema":{"type":"string","format":"date-time"}},{"name":"tagIds","in":"query","description":"Comma-separated tag ids, OR: accounts carrying any of them.","schema":{"type":"string"}},{"name":"hasOpenOpportunity","in":"query","description":"true: accounts with a live open opportunity; false: accounts without one.","schema":{"type":"boolean"}},{"name":"isCustomer","in":"query","description":"true: customer accounts; false: accounts that are not customers.","schema":{"type":"boolean"}},{"name":"accountType","in":"query","description":"Comma-separated account types, OR: prospect, client, lost, churned, partner, competitor, investor, do_not_contact.\nMatches the type the account reads, which follows its stage.","schema":{"type":"string"}},{"name":"fitsIcp","in":"query","description":"true: accounts that fit the ICP (none of the workspace's own domains, stage in pipeline or later, research fit unknown\nor at least 20); false: the accounts that do not.","schema":{"type":"boolean"}},{"name":"whyNotNow","in":"query","description":"Comma-separated outcomes, OR: stop, wait. Accounts whose current whyNotNow has one of them: a stop, or a\nwait whose until is still ahead. stop,wait lists every account Kenso is holding back.","schema":{"type":"string"}},{"name":"sort","in":"query","description":"Up to 3 comma-separated keys, each field, -field, field:asc or field:desc. Fields: createdAt, name, score, tier,\nlatestSignalAt, committee, pipelineAmount, nextTouchAt, lastTouchAt. Default -createdAt.","schema":{"type":"string"}},{"name":"expand","in":"query","description":"Comma-separated: committee (each account's committee summary), connections. With ids: stakeholders.","schema":{"type":"string"}},{"name":"limit","in":"query","description":"1 to 1000. Default 50.","schema":{"maximum":1000,"minimum":1,"type":"integer","format":"int32","default":50}},{"name":"cursor","in":"query","description":"The `nextCursor` of the previous page. Omit it for the first page.","schema":{"type":"string"}},{"name":"ids","in":"query","description":"Comma-separated account ids, 1 to 100: returns those accounts as accounts.get does, in this order, in one\ncall. Takes no other parameter but expand.","schema":{"type":"string"}},{"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/AccountListResponse"}}}},"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-features":["accounts"],"x-ken-permission":{"kind":"page","page":"accounts","access":"view","summary":"Accounts view"},"x-ken-rate-limit":{"limit":12000,"windowSeconds":60,"per":"api_key"}},"post":{"tags":["accounts"],"summary":"Create an account from its domains.","description":"`domains` (1 to 20 domains, website URLs or work emails; the first is primary) is required.\nA domain another account owns is `409 conflict` with detail `domain_taken` and that\n`accountId`: use that account instead. With account scope `own`, an account the caller cannot\nsee is not named (the detail has no `accountId`), a missing, null or own `ownerMemberId` makes\nthe caller the owner, and another member's is `403 permission_denied` with `scope: all`.\nFields a person sets are pinned. Ken resolves the company from\nKenso Search and fills the name (else from the primary domain: acme.com becomes Acme), industry, size, HQ\nand LinkedIn page without pinning them. When research is on, it starts research, charged in credits for its AI\nwork and for each web page or search Kenso reads for it.\n`skipResearch=true` creates the account without research or the committee run, so the create costs no\ncredits; research can be started later in the Kenso app.\n`sendsFromInboxId`, `sendsFromLinkedInAccountId`, `sendsFromImessageLineId` and `sendsFromFacebookAccountId` are checked like on PATCH.\nOnly the member who will own the account, a workspace admin or staff sets a Sends from id: anyone else gets\n`403 forbidden` with `details[].code` `sends_from_not_allowed` on each such field, and nothing is saved.\nRequires Accounts edit.\n\nRate limit: 4,800 calls a minute per API key, on top of the workspace limits.\n\nNeeds the `accounts` feature on your workspace. Until it is on, calls answer 404.","operationId":"accounts.create","parameters":[{"name":"skipResearch","in":"query","description":"True: do not queue research or the committee run for the new account. Absent or false: queue them as before.","schema":{"type":"boolean"}},{"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":{"description":"The account to create.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAccountBody"}}}},"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/AccountResponse"}}}},"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"]},"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"]}},"x-ken-features":["accounts"],"x-ken-permission":{"kind":"page","page":"accounts","access":"edit","summary":"Accounts edit"},"x-ken-credits":[{"action":"account_research","pricing":"varies"},{"action":"committee_mapping","pricing":"varies"},{"action":"email_found","pricing":"fixed","unit":"valid_email","unitSize":1,"millicreditsPerUnit":1000,"billing":"per_use"},{"action":"web_scrape","pricing":"varies"},{"action":"podcast_search","pricing":"unlisted"},{"action":"social_data_record","pricing":"unlisted"}],"x-ken-rate-limit":{"limit":4800,"windowSeconds":60,"per":"api_key"}}},"/v1/accounts/{accountId}":{"get":{"tags":["accounts"],"summary":"Return one account.","description":"`expand=stakeholders` embeds up to 200 stakeholders with their person. `expand=research` embeds the\nresearch dossier (status, trigger, errorCode, researchedAt, isStale, whyNow, angle, fitScore, tagline,\ndescription, facts, links, pains, stack, signals, sources). The status is the latest run's; the dossier\nfields come from the latest succeeded run, so a refresh in progress still shows the previous dossier. trigger is\nadd, manual, stale, touch, signal, meeting_booked, or agent for research an agent wrote.\nresearchStatus (none | waiting_credits | queued | running | succeeded | failed) and researchedAt are on every\naccount in get, list and search. `score` (0-99 from the signals of the last 90 days and the engaged\npeople), `scoredAt`, `signalCount`, `engagedPeopleCount` and `latestSignal` (id, kind,\ntitle, occurredAt, detectedAt) are absent until the account is first scored. `handoff` is the latest\nhand-off to a teammate, omitted when there is none. Requires Accounts view.\n\nRate limit: 12,000 calls a minute per API key, on top of the workspace limits.\n\nNeeds the `accounts` feature on your workspace. Until it is on, calls answer 404.","operationId":"accounts.get","parameters":[{"name":"accountId","in":"path","description":"The account.","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"expand","in":"query","description":"Comma-separated: `stakeholders`, `research`.","schema":{"type":"string"}},{"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/AccountResponse"}}}},"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-features":["accounts"],"x-ken-permission":{"kind":"page","page":"accounts","access":"view","summary":"Accounts view"},"x-ken-rate-limit":{"limit":12000,"windowSeconds":60,"per":"api_key"}},"patch":{"tags":["accounts"],"summary":"Update account fields. Absent fields stay unchanged; null clears.","description":"Fields: name, stage, networkLabel, ownerMemberId (a workspace member), fitScore (0-100), whyNow, angle,\ncadenceDays (1-365), industry, fundingRound (1-100 characters), employeeCount, hqLocation,\nlinkedinUrl, kenCompanyId (the company's Kenso id), sendsFromInboxId, sendsFromLinkedInAccountId, sendsFromImessageLineId,\nsendsFromFacebookAccountId.\n`sendsFromInboxId` is the inbox email touches send from: a member's primary inbox (owned\nand on the workspace's primary domain), or a shared campaign inbox on one of the workspace's cold sending\ndomains, whose touches the account owner approves. `sendsFromLinkedInAccountId` is the LinkedIn\naccount LinkedIn touches send from, connected by a member. `sendsFromInstagramAccountId` (PATCH only)\nis the Instagram account Instagram touches send from, one of this workspace's connected by a member.\n`sendsFromImessageLineId` is the iMessage line the account's texts usually send from: a line of this workspace\nthat has not ended (ordered, active, paused, cancelling or down) whose owner is a current member. A first text goes\nfrom an active line in the person's country: this line when it is one, else the account owner's line there, else the\nworkspace's oldest line there; with none there, it goes from this line. A person who already has a thread keeps that\nthread's line. The owner of the line a text goes from approves it. Null clears it: a first text with no active line\nin the person's country then goes from the account owner's first active line.\n`sendsFromFacebookAccountId` is the Facebook account Facebook touches send from, connected by a member; it needs\nFacebook outreach on for the workspace (`400 validation_failed` with code `not_enabled` otherwise). Null on any of\nthe others means the owner's default. None is pinned, so an agent may change them. A bad id is `400 validation_failed` with code `not_found`, `not_owned`,\n`not_member` (its member can't send from it anymore) or `email_domain_mismatch` (the inbox is not on the workspace's\nemail domain; the message says what fixes it). Only a changed id is checked, so a form that sends the stored ids\nback saves. A disconnected sender is accepted; its touches wait until it reconnects. Only the account owner, a\nworkspace admin or staff changes a Sends from id: anyone else gets `403 forbidden` with `details[].code` `sends_from_not_allowed` on each such field, and nothing is saved.\nChanging a field a person set is `409 conflict` with `pinned_by_user` unless\n`overwritePinned: true`; nothing is applied partially. With account scope `own`, an\naccount the caller does not own is `404 not_found`, and an `ownerMemberId` other than the\ncaller's own is `403 permission_denied` with `scope: all`. Requires Accounts edit.\n\n`tierOverride` (1 to the ladder's `tierCount`; a higher tier is `400 validation_failed`) sets\nthe account's tier by hand after the other fields are saved, and routes it to that tier's destination at once\nwhere the workspace has tier routing on (account-tiers); null is Auto: the account goes back to its auto tier\n(the tier the ladder placed it at, else its score's tier) without routing, and the ladder moves it from then on.\nBoth write a tier change to the account's activity, with tier routing on or off. A tier whose move adds the account's people to a campaign, or stops the people\nthe ladder put in one, also requires campaigns edit (`403 permission_denied`); both are checked before\nanything is saved. The response's `tier` is the hand-set tier, else `autoTier`. When another tier\nchange on the account ran at the same time, the tier is not set and the response is `409 conflict`; the\nother fields are saved. A campaign that refuses the people (the plan's lead limit) also leaves the tier unset,\nwith the other fields saved.\n\n`isCustomer` (true or false) marks the account a customer or clears it, after the other fields are saved.\nOnly a workspace admin can change it (`403 forbidden` with code `customer_not_allowed`, checked before\nanything is saved); anyone else may send the stored value back, which leaves the flag as it is. true puts every domain of the account on the workspace blocklist with reason\n`customer`, so Ken sends its people nothing, and moves the stage to client unless it is onboarding or client\nalready. false on an account at onboarding or client moves it to churned and keeps those rows; false on a customer at any other stage (flagged before stages carried the flag)\ntakes off only those rows, and a domain blocked for another reason stays blocked. The response carries\n`isCustomer`, `customerSince` and `customerSource` (manual here).\n\n`stage` is one of the 16 stages `accounts.list` names. The read's `stageGroup` is the group it\nsits in. The Customer flag and `accountType` follow the stage: onboarding and client make the account a customer\n(its domains go on the blocklist), and moving a customer off them clears the flag, to churned, lost, competitor or\ndo_not_contact with its domains kept on the blocklist, to any other stage with them taken off. A stage that sets or\nclears the flag needs a workspace admin (`403 forbidden` with code `customer_not_allowed`, checked before\nanything is saved); a `stage` and an `isCustomer` that disagree in one body are `400 validation_failed`.\n`networkLabel` (partner, investor or personal; null clears it) needs stage network, sent or held\n(`400 validation_failed` otherwise), and clears when the account leaves network.\n\n`accountType` (prospect, client, lost, churned, partner, competitor, investor, do_not_contact; not null) is\nwhat the workspace calls the account. It moves the stage, after `isCustomer`: client to client;\nchurned, competitor, do_not_contact and lost to the stage of that name; partner and investor to network with that\nlabel; prospect to researching when the stage reads another type, else nothing moves. With `stage` in the same\nbody, `stage` wins and `accountType` is ignored. `client` is the customer flag: moving\nan account to client marks it a customer (its domains go on the blocklist) and moving a client to another type\nclears it, so either needs a workspace admin (`403 forbidden` with code `customer_not_allowed`, checked\nbefore anything is saved); the flag turning on or off any other way (a won opportunity to onboarding) moves the stage\nand so the type. Any other type change is open to anyone with accounts edit.\n`accountType` and `isCustomer` that disagree in one body are `400 validation_failed`. Each change\nshows on the account's timeline. Only `client` changes sending by itself: any\nother type blocks the account's domains only while an enabled blocklist rule names it (`accountTypes` on\n`/v1/blocklist-rules`), except that a client moved to lost, churned, competitor or do_not_contact\nkeeps its domains on the blocklist. Sending the type the account already has changes\nnothing. To stop contacting an account, put its domains on the blocklist.\n\nRate limit: 4,800 calls a minute per API key, on top of the workspace limits.\n\nNeeds the `accounts` feature on your workspace. Until it is on, calls answer 404.","operationId":"accounts.update","parameters":[{"name":"accountId","in":"path","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/UpdateAccountBody"}}}},"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/AccountResponse"}}}},"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","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"]}},"x-ken-features":["accounts"],"x-ken-permission":{"kind":"page","page":"accounts","access":"edit","summary":"Accounts edit"},"x-ken-rate-limit":{"limit":4800,"windowSeconds":60,"per":"api_key"}},"delete":{"tags":["accounts"],"summary":"Delete an account.","description":"Frees its domains, removes its stakeholders (people stay), skips its open touches and deletes its\nopportunities. An iMessage text whose last send had no answer is read first, then recorded as sent or skipped\n(`account_deleted`); when no read can tell (its line is gone, or reads failed for about a day) it is skipped\nand counted as possibly delivered. Returns `204`. Requires Accounts edit access (owners, admins and editors by\ndefault).\n\nRate limit: 4,800 calls a minute per API key, on top of the workspace limits.\n\nNeeds the `accounts` feature on your workspace. Until it is on, calls answer 404.","operationId":"accounts.delete","parameters":[{"name":"accountId","in":"path","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"]}},"x-ken-features":["accounts"],"x-ken-permission":{"kind":"page","page":"accounts","access":"edit","summary":"Accounts edit"},"x-ken-rate-limit":{"limit":4800,"windowSeconds":60,"per":"api_key"}}},"/v1/accounts/bulk-create":{"post":{"tags":["accounts"],"summary":"Create up to 100 accounts in one call.","description":"`items` (1 to 100) are each a `POST /v1/accounts` body. Returns 200 with one result per item in\nrequest order: `created` (with the account and `research`: queued or waiting_credits),\n`domain_taken` (the `accountId` that already owns `domain`; counted in skipped), `invalid`\n(`field`, `code` and `error` of the item's first problem) or `failed` (retry that item).\nThe same domain twice in one call (acme.com and www.acme.com) creates once; the repeat is domain_taken.\nDuplicates are by domain only: acme.com and acme.io are two accounts. Ken resolves each company\nfrom Kenso Search and, when research is on, starts research per created account, charged in credits for its AI\nwork and for each web page or search Kenso reads for it; research waits for credits when the balance is short.\nWith account scope `own`, every created account is the caller's, and an item naming another member's\n`ownerMemberId` is `invalid` with code `permission_denied`. Requires Accounts edit.\n\nRate limit: 240 calls a minute per API key, on top of the workspace limits.\n\nNeeds the `accounts` feature on your workspace. Until it is on, calls answer 404.","operationId":"accounts.bulk-create","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/BulkCreateAccountsBody"}}}},"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/BulkCreateAccountsResultResponse"}}}},"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-features":["accounts"],"x-ken-permission":{"kind":"page","page":"accounts","access":"edit","summary":"Accounts edit"},"x-ken-credits":[{"action":"account_research","pricing":"varies"},{"action":"committee_mapping","pricing":"varies"},{"action":"email_found","pricing":"fixed","unit":"valid_email","unitSize":1,"millicreditsPerUnit":1000,"billing":"per_use"},{"action":"web_scrape","pricing":"varies"},{"action":"podcast_search","pricing":"unlisted"},{"action":"social_data_record","pricing":"unlisted"}],"x-ken-rate-limit":{"limit":240,"windowSeconds":60,"per":"api_key"}}},"/v1/accounts/{accountId}/merge":{"post":{"tags":["accounts"],"summary":"Merge an account into another account that is the same company.","description":"The account in the path is merged into `intoAccountId`, the account to keep, in one step. The kept\naccount keeps every field a person set; otherwise a field a person set on the merged account wins, and a\nblank field takes the merged value. Domains, stakeholders, touches, research, committee runs and seats, email\nfinds, Studio pages, opportunities, bookings, booking links, meetings, calendar guests, tags and the timeline move to\nthe kept account. A person on both accounts becomes one stakeholder. Unsent touches are skipped (`account_merged`) when the kept account already has\nan open touch. An iMessage text whose last send had no answer is read first. If the kept account has an open touch\nand the read cannot tell yet, the text is in neither `movedTouchIds` nor `skippedTouchIds` of\n`account.merged` and lands on the kept account later, sent or skipped (`account_merged`); when no read can\ntell (its line is gone, or reads failed for about a day) it is skipped and counted as possibly delivered. Returns\nthe kept account.\nThe merged id then reads as the kept account, and a write to it is\n`409 conflict` with `account_merged` and `mergedIntoId`. There is no unmerge. Merging an\naccount into itself is `400` (`same_account`); a merged account on either side is `409`\n(`account_merged`). With account scope own both accounts must be the caller's; another member's is\n`404`. Requires accounts edit, like delete; a Client seat is refused. Where `crm_import_export` is on, the answer carries\n`mergeSummary` (the fields changed, with the value before and after, the counts moved and the\n`mergeId` of its merge log entry), and `dryRun: true` writes nothing and answers with the summary and\nthe kept account's own fields as the merge would leave them (`400` `not_available` where the flag is\noff). On a dry run the account's `tier` and `lastTouchAt` read as merged too; only its `score` and\n`recentSignalKinds` are its values before the merge. A dry run counts the merged account's unanswered iMessage\ntexts as moved open, while a real merge may skip some of them as `account_merged`. A dry run never waits for an account another write holds: it answers\n`409 conflict` with `busy`, and the same call can be sent again.\nA blank custom field of the kept account takes the merged account's value, and reads as `custom.<key>`\nin `fieldChanges`.\nA workspace key gets `403 forbidden`: the merge records the member who made it, and a workspace key is not\na person.\n\nRate limit: 4,800 calls a minute per API key, on top of the workspace limits.\n\nNeeds the `accounts` feature on your workspace. Until it is on, calls answer 404.","operationId":"accounts.merge","parameters":[{"name":"accountId","in":"path","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/MergeAccountsBody"}}}},"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/AccountResponse"}}}},"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"]},"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"]},"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"]}},"x-ken-features":["accounts"],"x-ken-permission":{"kind":"page","page":"accounts","access":"edit","summary":"Accounts edit"},"x-ken-rate-limit":{"limit":4800,"windowSeconds":60,"per":"api_key"}}},"/v1/accounts/{accountId}/add-to-campaign":{"post":{"tags":["accounts"],"summary":"Add the account's people with no 1:1 touch planned to a campaign.","description":"Body: `campaignId` (required: a campaign of this workspace that is not archived or completed) and\n`who`: `not_yet_contacted` (default: people nobody ever sent a 1:1 touch, a member mailbox email or a\ncampaign email) or `everyone_mapped`. A person joins when they are a stakeholder with an email, targeted and\nnot a blocker. The economic buyer, anyone with a 1:1 touch planned and anyone touched in the last 30 days stay\nout, and so does anyone another open campaign already holds, so an account's people join one campaign (the\nfirst add wins). People are imported like a lead upload (dedup, blocklist, lead credits); the campaign's own\nsequence sends to them. Returns `added`, `alreadyIn` (people the campaign already had) and\n`skipped` (people the rules or another campaign held back, or the import left out), and writes \"N people with no 1:1 touch added to {campaign}\" on the\naccount timeline when it added anyone. Running it again adds nobody twice. An account or campaign not in the\nworkspace is `404 not_found`; an archived or completed campaign is `409 invalid_state` with\n`campaign_closed`. When the plan's lead credits refuse the import before anyone joined, the answer is\n`402 plan_limit_reached` with the refusal. With account scope `own`, an account the caller does not\nown is `404`.\nRequires accounts edit and campaigns edit, and the `nurture_air_cover` feature.\n\nRate limit: 4,800 calls a minute per API key, on top of the workspace limits.\n\nNeeds the `accounts` feature on your workspace. Until it is on, calls answer 404. Needs the `nurture_air_cover` feature on your workspace. Until it is on, calls answer 404.","operationId":"accounts.add-to-campaign","parameters":[{"name":"accountId","in":"path","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/AddAccountPeopleToCampaignBody"}}}},"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/AccountCampaignPeopleResponse"}}}},"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"]},"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"]},"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-features":["accounts","nurture_air_cover"],"x-ken-permission":{"kind":"page","page":"accounts","access":"edit","additionalPages":[{"page":"campaigns","access":"edit"}],"summary":"Accounts edit and Campaigns edit"},"x-ken-rate-limit":{"limit":4800,"windowSeconds":60,"per":"api_key"}}},"/v1/accounts/{accountId}/links":{"get":{"tags":["accounts"],"summary":"Return the account's website, LinkedIn page and careers page.","description":"Returns `website` (`https://` plus the primary domain), `linkedin` (the account's stored LinkedIn\npage), `careers` and `checkedAt`; each is `null` when there is none, and all four are always\npresent. `careers` is a page Ken found on the company's own website, never a guessed path: a link on its\nhome page (nav and footer included) whose path or text says careers or jobs, or to its board on an applicant\ntracking system (Greenhouse, Lever, Ashby, Workable and the like), else a careers URL in its sitemap. Kenso keeps\nit only when it answers 2xx after redirects, does not land on the home page and is not a \"not found\" page.\nThe answer is cached on the account: when the check never ran, ran for another primary domain, or is older\nthan 7 days when it found a careers page (1 day when it found none), this call runs it first (plain HTTP to the\ncompany's site, obeying its robots.txt, up to about 20 seconds; nothing is charged) and stores what it found,\nor that it found nothing, with the time in `checkedAt`. Otherwise it answers from the cache with no\noutbound request. When the server is already checking its most sites at once, the call answers the cache\nwithout checking and a later call checks. `careers` and `checkedAt` are null when the account has no\ndomain, and after its primary domain changed until the check for the new domain has run. A merged id answers\nfor the account it was merged into. With account scope `own`, an account the caller does not own is\n`404`. Requires accounts View.\n\nRate limit: 240 calls a minute per API key, on top of the workspace limits.\n\nNeeds the `accounts` feature on your workspace. Until it is on, calls answer 404.","operationId":"accounts.links","parameters":[{"name":"accountId","in":"path","description":"The account.","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/AccountLinksResponse"}}}},"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-features":["accounts"],"x-ken-permission":{"kind":"page","page":"accounts","access":"view","summary":"Accounts view"},"x-ken-rate-limit":{"limit":240,"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":{"Account":{"required":["createdBy","domains","name","pinnedFields","source","stage","stageGroup","updatedBy"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"mergeSummary":{"allOf":[{"$ref":"#/components/schemas/AccountMergeSummary"}],"description":"Only on the answer of accounts.merge: what the merge changed and moved, or would with `dryRun`."},"stage":{"type":"string","description":"One of the 16 stages: new, researching, warming, engaged, meeting_booked, in_deal, onboarding, client,\nchurned, nurture, paused, lost, network, not_a_fit, competitor or do_not_contact. A newer build may write a value this\nlist does not have yet; read it as a pipeline stage."},"stageGroup":{"type":"string","description":"to_sort, pipeline, customers, later, network or archive: the group the stage sits in. Always present; a\nstage this build does not know reads as pipeline."},"networkLabel":{"type":"string","description":"partner, investor or personal: what kind of network contact an account at stage network is. Omitted otherwise, and when unset (personal).","nullable":true},"stageChangedAt":{"type":"string","format":"date-time"},"ownerMemberId":{"type":"integer","format":"int64","nullable":true},"fitScore":{"type":"integer","format":"int32","nullable":true},"whyNow":{"type":"string","nullable":true},"angle":{"type":"string","nullable":true},"cadenceDays":{"type":"integer","format":"int32"},"nextTouchAt":{"type":"string","format":"date-time","nullable":true},"lastTouchAt":{"type":"string","description":"The latest of a sent or done touch and the latest outbound email or LinkedIn message to the account's people. Null when there is neither. LinkedIn counts campaign invites, messages and InMails; a LinkedIn message\nsent from the Inbox does not count.","format":"date-time","nullable":true},"source":{"type":"string"},"primaryDomain":{"type":"string","nullable":true},"domains":{"type":"array","items":{"$ref":"#/components/schemas/AccountDomain"}},"industry":{"type":"string","nullable":true},"fundingRound":{"type":"string","nullable":true},"employeeCount":{"type":"integer","format":"int32","nullable":true},"hqLocation":{"type":"string","nullable":true},"revenueRange":{"type":"string","description":"The annual revenue band in US dollars: under_1m, from_1m_to_10m, from_10m_to_50m, from_50m_to_100m,\nfrom_100m_to_1b or from_1b. fieldSources.revenueRange estimate means Ken read it off the headcount.","nullable":true},"hqCity":{"type":"string","nullable":true},"hqCountry":{"type":"string","description":"ISO 3166-1 alpha-2, upper case.","nullable":true},"foundedYear":{"type":"integer","format":"int32","nullable":true},"linkedinUrl":{"type":"string","nullable":true},"kenCompanyId":{"type":"integer","description":"The company's Ken id: its id in Ken Search.","format":"int64","nullable":true},"logoUrl":{"type":"string","description":"The LinkedIn company logo from Ken Search for kenCompanyId, an http(s) URL. Omitted when Ken\nhas none; show the primary domain's favicon instead. The URL can stop loading, so fall back on an image error too.","nullable":true},"sendsFromInboxId":{"type":"integer","description":"The inbox email touches send from. Omitted means the owner's primary inbox.","format":"int64","nullable":true},"sendsFromLinkedInAccountId":{"type":"integer","description":"The LinkedIn account LinkedIn touches send from. Omitted means the one the owner connected.","format":"int64","nullable":true},"sendsFromInstagramAccountId":{"type":"integer","description":"The Instagram account Instagram touches send from. Omitted means the one the owner connected.","format":"int64","nullable":true},"sendsFromWhatsAppAccountId":{"type":"integer","description":"The WhatsApp account WhatsApp touches send from. Omitted means the one the owner connected.","format":"int64","nullable":true},"sendsFromFacebookAccountId":{"type":"integer","description":"The Facebook account Facebook touches send from. Omitted means the owner's lowest-id connected one.","format":"int64","nullable":true},"sendsFromImessageLineId":{"type":"integer","description":"The iMessage line this account's texts usually send from. A first text goes from an active line in the\nperson's country: this one, else the account owner's line there, else the workspace's oldest line there; with none\nthere, from this line. A person who already has a thread keeps that thread's line. The owner of the line a text goes\nfrom approves it. Omitted means none is set: the account owner's first active line then stands in for this one.","format":"int64","nullable":true},"tier":{"type":"integer","description":"1 to the ladder's tierCount: the tier the account is worked at, tierOverride when a person set one, else\nautoTier. Always present. A tier past the ladder's tierCount (it was shortened later) reads as its last tier.","format":"int32"},"autoTier":{"type":"integer","description":"1 to the ladder's tierCount: the tier Auto puts the account at, the tier the ladder placed it at, else the tier\nits score falls in on the workspace's ladder (an account not scored yet reads score 0, the last tier). Always\npresent, also while tierOverride is set: it is the tier the account goes back to when tierOverride clears, unless\nthe hand-set tier moved the account to a lane autoTier does not work (a campaign or Watch): Auto then keeps the\nhand-set tier, so the tier matches where the account is.","format":"int32"},"tierOverride":{"type":"integer","description":"1 to 10 when a person set the tier by hand (up to the ladder's tierCount). Omitted for Auto.","format":"int32","nullable":true},"tierReason":{"allOf":[{"$ref":"#/components/schemas/AccountTierReason"}],"description":"Why the account sits at its tier; omitted while the feature is off, before a placement, after the tier moved, and under tierOverride."},"isCustomer":{"type":"boolean","description":"The workspace's customer: its domains are on the blocklist (reason customer), so Ken sends its people\nnothing. Always present."},"customerSince":{"type":"string","description":"When the account last became a customer. Omitted while it is not one.","format":"date-time","nullable":true},"customerSource":{"type":"string","description":"manual, opportunity_won or crm: what made it a customer. Omitted while it is not one.","nullable":true},"accountType":{"type":"string","description":"prospect, client, lost, churned, partner, competitor, investor or do_not_contact. It follows the stage: onboarding and client read client; churned, competitor, do_not_contact and lost read that type; network\nreads partner or investor by its label; any other stage reads prospect, or the type stored before stages carried it.\nAlways present; prospect by default."},"customFields":{"type":"object","additionalProperties":{},"description":"The record's custom field values by key (the fields the workspace defined): a string, number or boolean, a list of\noption keys for a multi_select field, `{amount, currency}` for a currency field. A select field holds its\noption's key. Empty when none is set."},"customFieldMeta":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/CustomFieldMeta"},"description":"Who or what last set each custom field, by key. Absent when no value has a record of it.","nullable":true},"pinnedFields":{"type":"array","items":{"type":"string"}},"fieldSources":{"type":"object","additionalProperties":{"type":"string"},"description":"Where each field's value came from, by wire name: user or crm (a person set it, pinned), ken_search,\nresearch, estimate, agent, api_key, workflow or system. A field with no recorded source is left out.","nullable":true},"createdBy":{"allOf":[{"$ref":"#/components/schemas/Actor"}],"description":"Who created or last changed a record."},"updatedBy":{"allOf":[{"$ref":"#/components/schemas/Actor"}],"description":"Who created or last changed a record."},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"score":{"type":"integer","description":"0 to 99 from the account's signals of the last 90 days (each kind once, weighted by age) and its engaged\npeople. Null until the account is first scored.","format":"int32","nullable":true},"scoredAt":{"type":"string","description":"When the score was last computed.","format":"date-time","nullable":true},"signalCount":{"type":"integer","description":"Signals whose event time is in the last 90 days, as of scoredAt.","format":"int32","nullable":true},"engagedPeopleCount":{"type":"integer","description":"Distinct live stakeholders who replied, met or viewed an asset in 90 days, or whose coverage is engaged.","format":"int32","nullable":true},"latestSignal":{"allOf":[{"$ref":"#/components/schemas/AccountSignalSummary"}],"description":"The signal with the latest event time, any age. Null when the account has none."},"recentSignalKinds":{"type":"array","items":{"type":"string"},"description":"The distinct kinds of the account's signals whose event time, when it happened else when Ken found it, is in\nthe last 90 days, in this order: funding, hiring, leadership_hire, job_change, headcount_growth, news,\npublic_post, event, tech_change, asset_view, reply, meeting, web_visit. The signal filter's window, but stored kinds, not\nfilter values: the job_change filter value also matches leadership_hire. Read live, so it does not wait for\nthe next score. Omitted when there are none.","nullable":true},"openOpportunityCount":{"type":"integer","description":"Live opportunities in an open stage (0 when none). Filled by get, list and search while the opportunities\nfeature is on for the caller; omitted on a write response and when the feature is off.","format":"int32","nullable":true},"openPipelineAmount":{"type":"number","description":"Sum of the open opportunities' amounts in the workspace currency; omitted when none has an amount.","format":"double","nullable":true},"openOpportunityStage":{"type":"string","description":"Stage key of the newest open opportunity; omitted when none is open.","nullable":true},"stakeholders":{"type":"array","items":{"$ref":"#/components/schemas/Stakeholder"},"description":"Only with expand=stakeholders (up to 200; page the rest with stakeholders.list).","nullable":true},"committee":{"allOf":[{"$ref":"#/components/schemas/CommitteeSummary"}],"description":"Only with expand=committee on accounts.list: the committee's counts, coverage and latest run."},"plan":{"allOf":[{"$ref":"#/components/schemas/AccountPlan"}],"description":"Only on accounts.get."},"reengageAfter":{"type":"string","description":"The day Ken re-engages a lost account: the day its latest lost opportunity closed, in the planner's time\nzone, plus 180 days. On an account at stage lost whose deal is lost (list, search,\nget); omitted otherwise, on a write response and while re-engagement is off.","format":"date","nullable":true},"tagIds":{"type":"array","items":{"type":"integer","format":"int64"},"description":"Ids of the live tags on the account, ascending. Always present; [] when none."},"handoff":{"allOf":[{"$ref":"#/components/schemas/AccountHandoff"}],"description":"The latest hand-off to a teammate. Omitted when the account was never handed off."},"researchStatus":{"type":"string","description":"Latest research run's status: none | waiting_credits | queued | running | succeeded | failed (list, search, get).","nullable":true},"researchedAt":{"type":"string","description":"When the latest successful research finished.","format":"date-time","nullable":true},"research":{"allOf":[{"$ref":"#/components/schemas/AccountResearch"}],"description":"Only with expand=research."},"importOnlyAt":{"type":"string","description":"When the LinkedIn connections import added the account: nobody has worked it yet, so it stays out of All\nand Ken runs nothing on it. Omitted once someone works it, and for every other account.","format":"date-time","nullable":true},"connections":{"allOf":[{"$ref":"#/components/schemas/AccountConnections"}],"description":"Only with expand=connections: the teammates' LinkedIn connections at the account. Omitted when none."},"whyNotNow":{"allOf":[{"$ref":"#/components/schemas/AccountWhyNotNow"}],"description":"The account's current reason not to reach out now: a stop or a wait. Omitted when there is none, and\nonce it was undone or a wait was released. Read it before any touch: while it is a stop, or a wait whose\n`until` is ahead, Kenso sends the account nothing but replies and meeting emails."}},"additionalProperties":false,"example":{"id":6120,"name":"Northwind Labs","stage":"engaged","stageGroup":"pipeline","stageChangedAt":"2026-10-13T16:22:05Z","ownerMemberId":1093,"fitScore":82,"whyNow":"Raised a $40M Series B in September and is hiring 12 engineers.","angle":"Their outbound team doubled this year: one place to run email and LinkedIn.","cadenceDays":7,"nextTouchAt":"2026-10-16T14:00:00Z","lastTouchAt":"2026-10-13T16:22:05Z","source":"api","primaryDomain":"northwind.example.com","domains":[{"id":8801,"domain":"northwind.example.com","isPrimary":true}],"industry":"Computer Software","fundingRound":"Series B","employeeCount":240,"hqLocation":"Austin, Texas, United States","kenCompanyId":3318204,"tier":1,"autoTier":1,"isCustomer":false,"accountType":"prospect","pinnedFields":["whyNow"],"customFields":{"renewal_date":"2027-01-31T00:00:00Z"},"createdBy":{"kind":"user","memberId":1093},"updatedBy":{"kind":"user","memberId":1093},"createdAt":"2026-09-23T15:02:11Z","updatedAt":"2026-10-14T09:41:27Z","score":64,"scoredAt":"2026-10-14T09:41:27Z","signalCount":2,"engagedPeopleCount":1,"latestSignal":{"id":4410,"kind":"funding","title":"Raised a $40M Series B","occurredAt":"2026-09-18T00:00:00Z","detectedAt":"2026-09-23T15:02:11Z"},"recentSignalKinds":["funding","hiring"],"openOpportunityCount":1,"openPipelineAmount":48000,"openOpportunityStage":"qualified","tagIds":[341],"researchStatus":"succeeded","researchedAt":"2026-09-23T15:02:11Z"}},"AccountCampaignPeople":{"required":["accountId","added","alreadyIn","campaignId","skipped"],"type":"object","properties":{"accountId":{"type":"integer","format":"int64"},"campaignId":{"type":"integer","format":"int64"},"campaignName":{"type":"string","nullable":true},"added":{"type":"integer","description":"People added to the campaign.","format":"int32"},"alreadyIn":{"type":"integer","description":"People already in the campaign.","format":"int32"},"skipped":{"type":"integer","description":"People the rules held back (the economic buyer, a 1:1 touch planned, touched recently), people another open campaign already holds, or the import left out (a duplicate elsewhere in the workspace, a rejected row).","format":"int32"}},"additionalProperties":false,"example":{"accountId":6120,"campaignId":4821,"campaignName":"Q4 SaaS founders","added":3,"alreadyIn":1,"skipped":1}},"AccountCampaignPeopleResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"Always true on a success."},"data":{"allOf":[{"$ref":"#/components/schemas/AccountCampaignPeople"}],"description":"The result of the operation."}},"additionalProperties":false,"description":"The body of a successful operation that returns one result. The result is in `data`."},"AccountConnectionPerson":{"type":"object","properties":{"personId":{"type":"integer","format":"int64"},"fullName":{"type":"string","nullable":true}},"additionalProperties":false},"AccountConnections":{"required":["connectedVia","people"],"type":"object","properties":{"count":{"type":"integer","description":"Distinct people at the account who are a teammate's LinkedIn connection.","format":"int32"},"people":{"type":"array","items":{"$ref":"#/components/schemas/AccountConnectionPerson"},"description":"The first few of them."},"connectedVia":{"type":"array","items":{"$ref":"#/components/schemas/ConnectedVia"},"description":"The seats those connections come from, by seat id."}},"additionalProperties":false,"description":"An account's LinkedIn connections, with expand=connections."},"AccountDomain":{"required":["domain"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"domain":{"type":"string"},"isPrimary":{"type":"boolean"}},"additionalProperties":false},"AccountHandoff":{"required":["channel","toName"],"type":"object","properties":{"toMemberId":{"type":"integer","format":"int64"},"toName":{"type":"string"},"channel":{"type":"string","description":"email, slack or crm_task."},"crmProvider":{"type":"string","description":"crm_task only: the CRM that holds the task.","nullable":true},"byMemberId":{"type":"integer","format":"int64","nullable":true},"handedOffAt":{"type":"string","format":"date-time"}},"additionalProperties":false,"description":"An account's latest hand-off: who it went to, how, by whom and when."},"AccountLinks":{"type":"object","properties":{"accountId":{"type":"integer","description":"The account the links are for (a merged id answers for the account it was merged into).","format":"int64"},"website":{"type":"string","description":"https:// plus the primary domain; null when the account has no domain.","nullable":true},"linkedin":{"type":"string","description":"The account's stored LinkedIn page.","nullable":true},"careers":{"type":"string","description":"The careers page found on the company's own website and checked to answer 2xx; null when none was found, or no\ncheck ran for the account's current domain.","nullable":true},"checkedAt":{"type":"string","description":"When the careers check last ran for the account's current domain; null when it never ran for it (the account has\nno domain, or its domain changed and the check could not run yet).","format":"date-time","nullable":true}},"additionalProperties":false,"description":"GET /v1/accounts/{accountId}/links: the links the account page shows. Each link is null when there is\nnone, and the four fields are always on the wire (null included), so a client can tell \"none\" from an old backend.","example":{"accountId":6120,"website":"https://northwind.example.com","careers":"https://northwind.example.com/careers","checkedAt":"2026-10-14T09:41:27Z"}},"AccountLinksResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"Always true on a success."},"data":{"allOf":[{"$ref":"#/components/schemas/AccountLinks"}],"description":"The result of the operation."}},"additionalProperties":false,"description":"The body of a successful operation that returns one result. The result is in `data`."},"AccountListResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"Always true on a success."},"data":{"type":"array","items":{"$ref":"#/components/schemas/Account"},"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."},"AccountMergeFieldChange":{"required":["field"],"type":"object","properties":{"field":{"type":"string","description":"The field's API name, such as `ownerMemberId` or `industry`."},"from":{"description":"The kept account's value before the merge. Absent when it was empty."},"to":{"description":"The value the merge sets: the merged-away account's."}},"additionalProperties":false},"AccountMergeMoved":{"type":"object","properties":{"domainCount":{"type":"integer","format":"int32"},"personCount":{"type":"integer","description":"People who move to the kept account.","format":"int32"},"combinedPersonCount":{"type":"integer","description":"People who were on both accounts and become one place on the kept account.","format":"int32"},"touchCount":{"type":"integer","description":"Touches that moved, sent and skipped ones included.","format":"int32"},"skippedTouchCount":{"type":"integer","description":"Of `touchCount`, the open touches the merge marked skipped as they moved: the kept account already had an\nopen touch for the person, or the person stays removed there.","format":"int32"},"opportunityCount":{"type":"integer","description":"Deals (opportunities).","format":"int32"},"meetingCount":{"type":"integer","format":"int32"},"tagCount":{"type":"integer","format":"int32"},"signalCount":{"type":"integer","format":"int32"},"studioPageCount":{"type":"integer","format":"int32"},"timelineEventCount":{"type":"integer","format":"int32"}},"additionalProperties":false,"description":"How many records of each kind move to the kept account."},"AccountMergeSummary":{"required":["fieldChanges","moved"],"type":"object","properties":{"isDryRun":{"type":"boolean","description":"True when the call was a dry run: nothing was written."},"mergeId":{"type":"integer","description":"The id of this merge's log entry, on a merge that was written.","format":"int64","nullable":true},"fieldChanges":{"type":"array","items":{"$ref":"#/components/schemas/AccountMergeFieldChange"},"description":"The kept account's fields the merge changes, each with the value before and the value after."},"moved":{"allOf":[{"$ref":"#/components/schemas/AccountMergeMoved"}],"description":"How many records of each kind move to the kept account."}},"additionalProperties":false,"description":"What a merge changed and moved, on the answer of accounts.merge. With `dryRun` nothing was\nwritten: this is what the merge would do."},"AccountPlan":{"required":["status"],"type":"object","properties":{"accountId":{"type":"integer","description":"The account the plan is for.","format":"int64"},"status":{"type":"string","description":"none (no plan yet), active, paused or ended."},"startedAt":{"type":"string","description":"When the plan started.","format":"date-time","nullable":true},"endsAt":{"type":"string","description":"When the plan's window ends.","format":"date-time","nullable":true},"pausedAt":{"type":"string","description":"When the plan was paused. Set while paused.","format":"date-time","nullable":true},"pauseReason":{"type":"string","description":"Why the plan is paused: reply (the account replied) or owner (the account owner paused it). Set while paused.","nullable":true},"pausedByMessageId":{"type":"string","description":"The reply that paused the plan, when `pauseReason` is reply.","nullable":true},"resumedAt":{"type":"string","description":"When the plan last resumed after a pause.","format":"date-time","nullable":true},"endedAt":{"type":"string","description":"When the plan ended.","format":"date-time","nullable":true},"endReason":{"type":"string","description":"Why the plan ended: completed, owner (the account owner ended it), meeting_booked or stage_changed.","nullable":true},"stepCount":{"type":"integer","description":"The plan's steps, not counting deleted or skipped ones.","format":"int32"},"openStepCount":{"type":"integer","description":"Steps not sent yet: planned, drafted, awaiting approval, approved or failed.","format":"int32"},"thin":{"type":"boolean","description":"True when an active or paused plan has fewer steps than the minimum its plan calls for, usually because Kenso\nknows too few people at the account: map more people to fill it."},"nextStepAt":{"type":"string","description":"When the earliest open step is due.","format":"date-time","nullable":true}},"additionalProperties":false,"description":"The account's 90-day touch plan. Status is none when the account was never planned."},"AccountResearch":{"required":["status"],"type":"object","properties":{"id":{"type":"integer","description":"The id of the dossier shown (the latest succeeded run), which the AI feedback control rates as\n            `account_research:{id}`. Absent when none finished.","format":"int64","nullable":true},"status":{"type":"string"},"trigger":{"type":"string","nullable":true},"errorCode":{"type":"string","nullable":true},"researchedAt":{"type":"string","format":"date-time","nullable":true},"isStale":{"type":"boolean"},"whyNow":{"$ref":"#/components/schemas/ResearchClaim"},"angle":{"type":"string","nullable":true},"fitScore":{"type":"integer","format":"int32","nullable":true},"tagline":{"$ref":"#/components/schemas/ResearchClaim"},"description":{"$ref":"#/components/schemas/ResearchClaim"},"facts":{"$ref":"#/components/schemas/ResearchFacts"},"links":{"$ref":"#/components/schemas/ResearchLinks"},"pains":{"type":"array","items":{"$ref":"#/components/schemas/ResearchPain"},"nullable":true},"stack":{"type":"array","items":{"$ref":"#/components/schemas/ResearchClaim"},"nullable":true},"signals":{"type":"array","items":{"$ref":"#/components/schemas/ResearchClaim"},"nullable":true},"sources":{"type":"array","items":{"$ref":"#/components/schemas/ResearchSourceClaim"},"nullable":true},"whyNowStatus":{"type":"string","description":"`no_sourced_trigger` when the run found no dated why-now within 120 days.","nullable":true},"company":{"allOf":[{"$ref":"#/components/schemas/ResearchCompany"}],"description":"The company block, from Ken's own records (no model call): Ken Search, the linked contacts_company\n            row (enrichment) and the job postings index."},"stackItems":{"type":"array","items":{"$ref":"#/components/schemas/ResearchStackItem"},"description":"The merged, sourced stack. stack stays for older readers.","nullable":true},"pricing":{"$ref":"#/components/schemas/ResearchPricing"},"salesMotion":{"$ref":"#/components/schemas/ResearchSalesMotion"},"acv":{"allOf":[{"$ref":"#/components/schemas/ResearchAcv"}],"description":"Their ACV, an estimate of what one customer pays the company a year, derived only from cited\n            published pricing, with its basis."},"customers":{"type":"array","items":{"$ref":"#/components/schemas/ResearchClaim"},"nullable":true},"competitors":{"type":"array","items":{"$ref":"#/components/schemas/ResearchClaim"},"nullable":true},"answers":{"type":"array","items":{"$ref":"#/components/schemas/ResearchAnswer"},"nullable":true},"appliedPrompt":{"allOf":[{"$ref":"#/components/schemas/ResearchAppliedPrompt"}],"description":"The Knowledge › Prompts research prompt that shaped the dossier shown."}},"additionalProperties":false},"AccountResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"Always true on a success."},"data":{"allOf":[{"$ref":"#/components/schemas/Account"}],"description":"The result of the operation."}},"additionalProperties":false,"description":"The body of a successful operation that returns one result. The result is in `data`."},"AccountSignalSummary":{"required":["kind","title"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"kind":{"type":"string","description":"funding, hiring, leadership_hire, job_change, headcount_growth, news, public_post, event, tech_change, asset_view, reply, meeting, web_visit."},"title":{"type":"string"},"occurredAt":{"type":"string","description":"When it happened, when the source says.","format":"date-time","nullable":true},"detectedAt":{"type":"string","format":"date-time"}},"additionalProperties":false,"description":"An account's latest signal, embedded in the account."},"AccountTierReason":{"required":["facts"],"type":"object","properties":{"tier":{"type":"integer","format":"int32"},"tierName":{"type":"string","nullable":true},"who":{"type":"string","nullable":true},"confidence":{"type":"number","format":"double","nullable":true},"probabilities":{"type":"object","additionalProperties":{"type":"number","format":"double"},"nullable":true},"facts":{"$ref":"#/components/schemas/AccountTierReasonFacts"},"next":{"$ref":"#/components/schemas/AccountTierReasonNext"},"placedAt":{"type":"string","format":"date-time"}},"additionalProperties":false,"description":"Why Ken placed the account at its tier. Who is the tier's \"who belongs here\" text; Probabilities is keyed by tier number."},"AccountTierReasonFacts":{"type":"object","properties":{"fitScore":{"type":"integer","format":"int32","nullable":true},"industry":{"type":"string","nullable":true},"employees":{"type":"integer","format":"int32","nullable":true},"fundingRound":{"type":"string","nullable":true},"signalScore":{"type":"integer","format":"int32","nullable":true},"engagedPeople":{"type":"integer","format":"int32","nullable":true},"topSignals":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"AccountTierReasonNext":{"type":"object","properties":{"tier":{"type":"integer","format":"int32"},"who":{"type":"string","nullable":true}},"additionalProperties":false},"AccountWhyNotNow":{"required":["outcome","reason","setBy","text"],"type":"object","properties":{"reason":{"type":"string","description":"outside_limits, company_gone or competitor (a stop); open_deal, asked_later, recent_no, crisis, being_acquired or\njust_bought (a wait); person_left or wrong_person (switch person, set on one stakeholder and never shown here)."},"outcome":{"type":"string","description":"stop (the account moved to not_a_fit or competitor until a person undoes it) or wait (the stage stays and Kenso\nholds the account to its release date, `until`)."},"text":{"type":"string","description":"The sentence people read: the reason's label, then the note or source text it was set with."},"sourceUrl":{"type":"string","description":"The source the reason came from, an http(s) URL. Omitted for a reason from a reply.","nullable":true},"sourceDate":{"type":"string","description":"The source's own date. Omitted when the reason came from a reply without one.","format":"date","nullable":true},"replyId":{"type":"string","description":"The msg_ id of the reply the reason came from. Omitted otherwise.","nullable":true},"until":{"type":"string","description":"A wait's release date: Kenso holds the account until then and resumes its plan after. Omitted for a stop.","format":"date-time","nullable":true},"setBy":{"type":"string","description":"ken (a Kenso job), agent (an agent or an API key) or user (a member)."},"setAt":{"type":"string","format":"date-time"}},"additionalProperties":false,"description":"An account's why-not-now: the reason, what it does and its source. A member sets and clears it on\nthe account in Kenso, or Ken does."},"Actor":{"required":["kind"],"type":"object","properties":{"kind":{"type":"string","description":"Who made the change: `user` (a member in the app), `agent` (Ken or another AI agent), `api_key`,\n`workflow` or `system` (Kenso itself)."},"memberId":{"type":"integer","description":"The id of the member behind the change. Omitted when no member is.","format":"int64","nullable":true}},"additionalProperties":false,"description":"Who created or last changed a record."},"AddAccountPeopleToCampaignBody":{"required":["campaignId"],"type":"object","properties":{"campaignId":{"type":"integer","description":"The campaign the people join, a live campaign of this workspace that is not archived or completed. Required.","format":"int64"},"who":{"type":"string","description":"not_yet_contacted (default): people nobody has touched yet. everyone_mapped: every mapped person not touched in 30 days.","nullable":true}},"additionalProperties":false,"example":{"campaignId":4821,"who":"not_yet_contacted"}},"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."},"BulkCreateAccountItemResult":{"required":["status"],"type":"object","properties":{"status":{"type":"string","description":"`created`, `domain_taken`, `invalid` or `failed`."},"accountId":{"type":"integer","description":"created: the new account. domain_taken: the account that already owns `domain`; use it.","format":"int64","nullable":true},"account":{"allOf":[{"$ref":"#/components/schemas/Account"}],"description":"created only."},"research":{"type":"string","description":"created only: `queued`, or `waiting_credits` when the workspace is short. Absent when research is off.","nullable":true},"domain":{"type":"string","description":"domain_taken: the domain another account owns.","nullable":true},"field":{"type":"string","description":"invalid: the item field of the first error, such as `domains[0]`.","nullable":true},"code":{"type":"string","description":"invalid: the error code, such as `generic_email_domain`.","nullable":true},"error":{"type":"string","description":"Every status except created: what went wrong and what to do.","nullable":true}},"additionalProperties":false},"BulkCreateAccountsBody":{"required":["items"],"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/CreateAccountBody"},"description":"1 to 100 accounts. Each item is a POST /v1/accounts body. Required."}},"additionalProperties":false,"example":{"items":[{"name":"Northwind Labs","domains":["northwind.example.com"],"stage":"new","ownerMemberId":1093,"whyNow":"Raised a $40M Series B in September and is hiring 12 engineers.","angle":"Their outbound team doubled this year: one place to run email and LinkedIn.","cadenceDays":7,"industry":"Computer Software","employeeCount":240,"hqLocation":"Austin, Texas, United States"},{"name":"Contoso Analytics","domains":["contoso.example.com"]}]}},"BulkCreateAccountsResult":{"required":["results"],"type":"object","properties":{"created":{"type":"integer","description":"Items with status created.","format":"int32"},"skipped":{"type":"integer","description":"Items with status domain_taken: the company is already an account.","format":"int32"},"failed":{"type":"integer","description":"Items with status invalid or failed.","format":"int32"},"results":{"type":"array","items":{"$ref":"#/components/schemas/BulkCreateAccountItemResult"}}},"additionalProperties":false,"description":"Result of `POST /v1/accounts/bulk-create`. `results` is in request order.","example":{"created":1,"skipped":1,"failed":0,"results":[{"status":"created","accountId":6120,"account":{"id":6120,"name":"Northwind Labs","stage":"engaged","stageGroup":"pipeline","stageChangedAt":"2026-10-13T16:22:05Z","ownerMemberId":1093,"fitScore":82,"whyNow":"Raised a $40M Series B in September and is hiring 12 engineers.","angle":"Their outbound team doubled this year: one place to run email and LinkedIn.","cadenceDays":7,"nextTouchAt":"2026-10-16T14:00:00Z","lastTouchAt":"2026-10-13T16:22:05Z","source":"api","primaryDomain":"northwind.example.com","domains":[{"id":8801,"domain":"northwind.example.com","isPrimary":true}],"industry":"Computer Software","fundingRound":"Series B","employeeCount":240,"hqLocation":"Austin, Texas, United States","kenCompanyId":3318204,"tier":1,"autoTier":1,"isCustomer":false,"accountType":"prospect","pinnedFields":["whyNow"],"customFields":{"renewal_date":"2027-01-31T00:00:00Z"},"createdBy":{"kind":"user","memberId":1093},"updatedBy":{"kind":"user","memberId":1093},"createdAt":"2026-09-23T15:02:11Z","updatedAt":"2026-10-14T09:41:27Z","score":64,"scoredAt":"2026-10-14T09:41:27Z","signalCount":2,"engagedPeopleCount":1,"latestSignal":{"id":4410,"kind":"funding","title":"Raised a $40M Series B","occurredAt":"2026-09-18T00:00:00Z","detectedAt":"2026-09-23T15:02:11Z"},"recentSignalKinds":["funding","hiring"],"openOpportunityCount":1,"openPipelineAmount":48000,"openOpportunityStage":"qualified","tagIds":[341],"researchStatus":"succeeded","researchedAt":"2026-09-23T15:02:11Z"},"research":"queued"},{"status":"domain_taken","accountId":5977,"domain":"contoso.example.com","error":"Account 5977 already owns contoso.example.com. GET /v1/accounts/5977 instead of creating it, or add your other domains there."}]}},"BulkCreateAccountsResultResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"Always true on a success."},"data":{"allOf":[{"$ref":"#/components/schemas/BulkCreateAccountsResult"}],"description":"The result of the operation."}},"additionalProperties":false,"description":"The body of a successful operation that returns one result. The result is in `data`."},"CommitteeCoverage":{"type":"object","properties":{"covered":{"type":"integer","description":"Live stakeholders with coverage engaged or planned.","format":"int32"},"total":{"type":"integer","description":"Live stakeholders plus live open seats.","format":"int32"}},"additionalProperties":false,"description":"\"3 of 5 mapped\": covered stakeholders out of live stakeholders plus live open seats."},"CommitteeRoleCount":{"required":["role"],"type":"object","properties":{"role":{"type":"string","description":"champion, economic_buyer, approver, evaluator, user, executive_sponsor, blocker or unknown (stakeholders only)."},"stakeholderCount":{"type":"integer","format":"int32"},"openSeatCount":{"type":"integer","format":"int32"}},"additionalProperties":false},"CommitteeRun":{"required":["counts","status","trigger"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"accountId":{"type":"integer","format":"int64"},"trigger":{"type":"string","description":"account_created, ask_ken or api."},"instruction":{"type":"string","description":"The user's steer.","nullable":true},"status":{"type":"string","description":"finding, queued, running, paused, succeeded or failed."},"pausedReason":{"type":"string","description":"Why the run is paused: credits when the workspace is out of credits, member_limit when the person the run counts\nagainst (who started it, else the account owner) reached their monthly credit limit. Null when not paused.","nullable":true},"counts":{"$ref":"#/components/schemas/CommitteeRunCounts"},"costCredits":{"type":"integer","description":"Whole credits the run's model call cost, rounded half away from zero. Email finds are charged on each find.","format":"int32"},"error":{"type":"string","description":"Short and user-safe, when the run failed.","nullable":true},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":"string","format":"date-time","nullable":true},"completedAt":{"type":"string","format":"date-time","nullable":true}},"additionalProperties":false,"description":"One run of Ken's committee mapping."},"CommitteeRunCounts":{"type":"object","properties":{"candidatesSeen":{"type":"integer","format":"int32"},"peopleAdded":{"type":"integer","format":"int32"},"peopleUpdated":{"type":"integer","format":"int32"},"seatsOpened":{"type":"integer","format":"int32"},"emailsQueued":{"type":"integer","format":"int32"}},"additionalProperties":false},"CommitteeSummary":{"required":["coverage","roles"],"type":"object","properties":{"stakeholderCount":{"type":"integer","description":"Live stakeholders.","format":"int32"},"openSeatCount":{"type":"integer","description":"Live open seats.","format":"int32"},"coverage":{"allOf":[{"$ref":"#/components/schemas/CommitteeCoverage"}],"description":"Covered stakeholders out of stakeholders plus open seats."},"roles":{"type":"array","items":{"$ref":"#/components/schemas/CommitteeRoleCount"},"description":"One entry per role with a live stakeholder or open seat, in the order champion, economic_buyer, approver, evaluator,\nuser, executive_sponsor, blocker, unknown. [] when the committee is empty."},"run":{"allOf":[{"$ref":"#/components/schemas/CommitteeRun"}],"description":"Ken's latest run mapping this account's buying committee. Omitted when Ken has never mapped it."}},"additionalProperties":false,"description":"The account's buying committee in brief: its stakeholders, open seats, coverage by role and Ken's latest mapping run."},"ConnectedVia":{"type":"object","properties":{"linkedinAccountId":{"type":"integer","description":"The id of the connected LinkedIn account in Kenso.","format":"int64"},"displayName":{"type":"string","description":"The name on that LinkedIn account. Omitted when unknown.","nullable":true},"memberId":{"type":"integer","description":"The id of the member who connected that LinkedIn account to Kenso. Omitted when Kenso did not record it.","format":"int64","nullable":true}},"additionalProperties":false,"description":"A teammate's LinkedIn account that has a person as a connection."},"CreateAccountBody":{"required":["domains"],"type":"object","properties":{"name":{"type":"string","nullable":true},"stage":{"type":"string","description":"One of the 16 stages: new, researching, warming, engaged, meeting_booked, in_deal, onboarding, client,\nchurned, nurture, paused, lost, network, not_a_fit, competitor or do_not_contact. Onboarding and client make the\naccount a customer (admins only). Cannot be null.","nullable":true},"networkLabel":{"type":"string","description":"partner, investor or personal: what kind of network contact an account at stage network is. Only with stage\nnetwork (the stored stage, or stage network in the same body); null clears it, which reads as personal.","nullable":true},"ownerMemberId":{"type":"integer","description":"A member of this workspace, or null to clear.","format":"int64","nullable":true},"fitScore":{"type":"integer","description":"0 to 100.","format":"int32","nullable":true},"whyNow":{"type":"string","nullable":true},"angle":{"type":"string","nullable":true},"cadenceDays":{"type":"integer","description":"1 to 365. Cannot be null.","format":"int32","nullable":true},"industry":{"type":"string","nullable":true},"fundingRound":{"type":"string","description":"The latest funding round, such as Series A. 1 to 100 characters.","nullable":true},"employeeCount":{"type":"integer","format":"int32","nullable":true},"hqLocation":{"type":"string","description":"Where the company sits, as free text (\"Berlin, Germany\"); where filters it with contains. hqCity and hqCountry are\nthe structured, exact-match fields.","nullable":true},"revenueRange":{"type":"string","description":"The annual revenue band in US dollars: under_1m, from_1m_to_10m, from_10m_to_50m, from_50m_to_100m,\nfrom_100m_to_1b or from_1b. Null clears it.","nullable":true},"hqCity":{"type":"string","description":"The HQ city, 1 to 200 characters.","nullable":true},"hqCountry":{"type":"string","description":"The HQ country: an ISO 3166-1 alpha-2 code such as DE, or a country name, stored as the code.","nullable":true},"foundedYear":{"type":"integer","description":"The year the company was founded, 1000 to 2100.","format":"int32","nullable":true},"linkedinUrl":{"type":"string","description":"The company page, such as https://linkedin.com/company/acme.","nullable":true},"kenCompanyId":{"type":"integer","description":"The company's Ken id: its id in Ken Search. Null clears it.","format":"int64","nullable":true},"sendsFromInboxId":{"type":"integer","description":"The inbox this account's email touches send from: a member's primary inbox (owned, on the\nworkspace's primary domain), or a shared campaign inbox on one of the workspace's cold sending domains. Null clears it, and the account owner's primary inbox sends.","format":"int64","nullable":true},"sendsFromLinkedInAccountId":{"type":"integer","description":"The LinkedIn account this account's LinkedIn touches send from. It must have been connected by a\nmember. Null clears it, and the LinkedIn account the owner connected sends.","format":"int64","nullable":true},"sendsFromWhatsAppAccountId":{"type":"integer","description":"The WhatsApp account this account's WhatsApp touches send from. It must have been connected by a member.\nNull clears it, and the WhatsApp account the owner connected sends.","format":"int64","nullable":true},"sendsFromImessageLineId":{"type":"integer","description":"The iMessage line this account's texts usually send from: a line of this workspace that has not ended,\nowned by a current member. A first text goes from an active line in the person's country (this one, else the\naccount owner's, else the oldest), else from this line; a person with a thread keeps its line. The owner of the\nline a text goes from approves it. Null clears it: the owner's first active line then stands in for this one.","format":"int64","nullable":true},"sendsFromFacebookAccountId":{"type":"integer","description":"The Facebook account this account's Facebook touches send from. It must have been connected by a member,\nand the workspace must have Facebook outreach on. Null clears it, and the lowest-id Facebook account the owner\nconnected sends.","format":"int64","nullable":true},"domains":{"type":"array","items":{"type":"string"},"description":"1 to 20 domains, website URLs or work emails. The first is primary. Required."},"source":{"type":"string","description":"manual, csv, search, promoted, workflow or api. Defaults to manual for a person and api otherwise.","nullable":true}},"additionalProperties":false,"example":{"name":"Northwind Labs","domains":["northwind.example.com"],"stage":"new","ownerMemberId":1093,"whyNow":"Raised a $40M Series B in September and is hiring 12 engineers.","angle":"Their outbound team doubled this year: one place to run email and LinkedIn.","cadenceDays":7,"industry":"Computer Software","employeeCount":240,"hqLocation":"Austin, Texas, United States"}},"CustomFieldMeta":{"required":["source"],"type":"object","properties":{"source":{"type":"string","description":"`user` (a member, in the app), `crm` (your CRM), `agent` (Ken or another agent), `api_key`,\n`workflow` or `system`. A `user` or `crm` value is pinned: the field is listed in\n`pinnedFields` as `custom.<key>`."},"at":{"type":"string","description":"When the value was set.","format":"date-time"},"memberId":{"type":"integer","description":"The member who set it, or who the agent or key acted for. Absent when no member did.","format":"int64","nullable":true}},"additionalProperties":false,"description":"Who or what last set a custom field's value on a record, and when."},"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."},"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."},"MergeAccountsBody":{"required":["intoAccountId"],"type":"object","properties":{"intoAccountId":{"type":"integer","description":"The account to keep. The account in the path is merged into it. Required.","format":"int64"},"dryRun":{"type":"boolean","description":"True to write nothing and answer with what the merge would change and move (`mergeSummary`). The account in\nthe answer shows its own fields as merged, tier and last touch included; only its score and recent signal kinds\nstay as they are before the merge.","nullable":true}},"additionalProperties":false,"example":{"intoAccountId":6120}},"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."},"PersonEmailFindSummary":{"required":["status"],"type":"object","properties":{"id":{"type":"integer","description":"The email find's id.","format":"int64"},"status":{"type":"string","description":"Where the find stands: `queued`, `running`, `paused` (waiting for credits), `found`,\n`not_found` or `failed`."},"completedAt":{"type":"string","description":"When the find finished, in UTC. Omitted while it is not finished.","format":"date-time","nullable":true},"fromKenPool":{"type":"boolean","description":"True when Kenso's own email database found the email at no charge. Omitted otherwise.","nullable":true}},"additionalProperties":false,"description":"The newest search for a person's email."},"PersonPhone":{"required":["kind","number","source"],"type":"object","properties":{"number":{"type":"string","description":"The number as a plus sign and 8 to 15 digits, starting with the country code, such as +15551234567."},"kind":{"type":"string","description":"The kind of number: `mobile`, `work` or `other`."},"source":{"type":"string","description":"Who added the number: a person source such as `manual`, `api`, `crm` or `form`, or the name\nof the service that found it."},"addedAt":{"type":"string","description":"When the number was added, in UTC.","format":"date-time"},"invalidAt":{"type":"string","description":"When the number was marked as a wrong number, in UTC. Omitted for a number not known to be wrong.","format":"date-time","nullable":true},"whatsapp":{"type":"string","description":"on, off or unknown: whether this number is on WhatsApp, from a check in the last 30 days. Only on the people get,\nlist and search reads with the whatsapp feature on; omitted otherwise.","nullable":true},"whatsappCheckedAt":{"type":"string","description":"When that check ran. Omitted when whatsapp is unknown or omitted.","format":"date-time","nullable":true},"whatsappOptOutAt":{"type":"string","description":"When WhatsApp to this number stopped: the person's stop or the number's, whichever came first. Kenso never sends\nWhatsApp to it. Omitted when neither is set or whatsapp is omitted. phoneOptOutAt blocks WhatsApp too.","format":"date-time","nullable":true}},"additionalProperties":false,"description":"One of a person's phone numbers."},"PersonSource":{"required":["source"],"type":"object","properties":{"source":{"type":"string","description":"The source: `manual`, `api`, `workflow`, `search`, `research`, `promoted`,\n`campaign`, `booking`, `crm`, `form`, `webhook`, `import`, `visitor`,\n`inbound_email` or `linkedin`."},"detail":{"type":"string","description":"More about the source, such as the form or list name an intake sent, or the import or webhook name. Omitted when\nthere is none.","nullable":true},"at":{"type":"string","description":"When the person came from this source, in UTC. Omitted when unknown.","format":"date-time","nullable":true}},"additionalProperties":false,"description":"Where a person came from, and when."},"PersonSummary":{"type":"object","properties":{"id":{"type":"integer","description":"The person's id.","format":"int64"},"fullName":{"type":"string","description":"The person's full name. Omitted when unknown.","nullable":true},"title":{"type":"string","description":"The person's job title. Omitted when unknown.","nullable":true},"email":{"type":"string","description":"The person's email, in lower case. Omitted when Kenso has none.","nullable":true},"linkedinUrl":{"type":"string","description":"The person's LinkedIn profile, as https://linkedin.com/in/{slug}. Omitted when Kenso has none.","nullable":true},"kenPersonId":{"type":"integer","description":"The person's id in Kenso Search. Omitted when Kenso has not matched them there.","format":"int64","nullable":true},"ownerMemberId":{"type":"integer","description":"The id of the member who owns the person. Omitted when nobody owns them.","format":"int64","nullable":true},"leadStatus":{"type":"string","description":"The person's lead status: `new`, `working`, `qualified`, `disqualified` or `nurture`.\nOmitted when the person is not a lead.","nullable":true},"leadStatusAt":{"type":"string","description":"When the lead status last changed, in UTC. Omitted when the person has no lead status.","format":"date-time","nullable":true},"score":{"type":"integer","description":"How well the person fits, from 0 to 100. Read-only. Omitted until Kenso scores the person.","format":"int32","nullable":true},"phones":{"type":"array","items":{"$ref":"#/components/schemas/PersonPhone"},"description":"Every phone number the person has, in stored order. An entry with `invalidAt` is a known wrong number."},"phone":{"type":"string","description":"The first number in `phones` without `invalidAt`. Omitted when there is none.","nullable":true},"firstSource":{"allOf":[{"$ref":"#/components/schemas/PersonSource"}],"description":"Where the person first came from. Omitted when Kenso has no record of it."},"latestSource":{"allOf":[{"$ref":"#/components/schemas/PersonSource"}],"description":"Where the person most recently came from. Omitted when Kenso has no record of it."},"headline":{"type":"string","description":"The person's LinkedIn headline. Omitted when unknown.","nullable":true},"photoUrl":{"type":"string","description":"The URL of the person's photo, a file Kenso stores and serves. Omitted when there is no photo.","nullable":true},"photoSource":{"type":"string","description":"Where the photo came from: `upload` for an uploaded photo, `linkedin` for their LinkedIn photo. Omitted\nwhen there is no photo.","nullable":true},"emailFind":{"allOf":[{"$ref":"#/components/schemas/PersonEmailFindSummary"}],"description":"The newest search for the person's email. Omitted when nobody asked Kenso to find it."}},"additionalProperties":false,"description":"A short view of a person, as an account's stakeholder carries it."},"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."},"ResearchAcv":{"required":["basis","currency"],"type":"object","properties":{"low":{"type":"number","format":"double"},"high":{"type":"number","format":"double"},"currency":{"type":"string"},"basis":{"type":"string"},"sourceUrls":{"type":"array","items":{"type":"string"}}},"additionalProperties":false,"description":"Their ACV, an estimate of what one customer pays the company a year, derived only from cited\n            published pricing, with its basis."},"ResearchAnswer":{"required":["answer","question"],"type":"object","properties":{"question":{"type":"string"},"answer":{"type":"string"},"sourceUrls":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"ResearchAppliedPrompt":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"}},"additionalProperties":false,"description":"The Knowledge › Prompts research prompt that shaped a run."},"ResearchClaim":{"required":["sourceUrls","text"],"type":"object","properties":{"text":{"type":"string"},"sourceUrls":{"type":"array","items":{"type":"string"}},"date":{"type":"string","nullable":true},"origin":{"type":"string","description":"Where the claim came from: ken_search, enrichment, website, news, search, jobs, model or social.\n            Set on the claims of the newer brief fields; absent on older ones.","nullable":true}},"additionalProperties":false},"ResearchCompany":{"type":"object","properties":{"employees":{"allOf":[{"$ref":"#/components/schemas/ResearchValue"}],"description":"One company value with its origin (a ResearchOrigin)."},"sizeBand":{"allOf":[{"$ref":"#/components/schemas/ResearchValue"}],"description":"One company value with its origin (a ResearchOrigin)."},"industry":{"allOf":[{"$ref":"#/components/schemas/ResearchValue"}],"description":"One company value with its origin (a ResearchOrigin)."},"headquarters":{"allOf":[{"$ref":"#/components/schemas/ResearchValue"}],"description":"One company value with its origin (a ResearchOrigin)."},"founded":{"allOf":[{"$ref":"#/components/schemas/ResearchValue"}],"description":"One company value with its origin (a ResearchOrigin)."},"revenueRange":{"allOf":[{"$ref":"#/components/schemas/ResearchValue"}],"description":"One company value with its origin (a ResearchOrigin)."},"funding":{"allOf":[{"$ref":"#/components/schemas/ResearchValue"}],"description":"One company value with its origin (a ResearchOrigin)."},"openRoles":{"allOf":[{"$ref":"#/components/schemas/ResearchValue"}],"description":"One company value with its origin (a ResearchOrigin)."},"hiring":{"type":"array","items":{"$ref":"#/components/schemas/ResearchClaim"},"nullable":true},"leadershipChanges":{"type":"array","items":{"$ref":"#/components/schemas/ResearchClaim"},"nullable":true}},"additionalProperties":false,"description":"The company block, from Ken's own records (no model call): Ken Search, the linked contacts_company\n            row (enrichment) and the job postings index."},"ResearchFact":{"required":["sourceUrls","value"],"type":"object","properties":{"value":{"type":"string"},"sub":{"type":"string","nullable":true},"sourceUrls":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"ResearchFacts":{"type":"object","properties":{"headquarters":{"$ref":"#/components/schemas/ResearchFact"},"founded":{"$ref":"#/components/schemas/ResearchFact"},"employees":{"$ref":"#/components/schemas/ResearchFact"},"funding":{"$ref":"#/components/schemas/ResearchFact"},"revenue":{"$ref":"#/components/schemas/ResearchFact"},"stock":{"$ref":"#/components/schemas/ResearchFact"}},"additionalProperties":false},"ResearchLinks":{"required":["website"],"type":"object","properties":{"website":{"type":"string"},"linkedin":{"type":"string","nullable":true},"careers":{"type":"string","nullable":true},"ticker":{"type":"string","nullable":true}},"additionalProperties":false},"ResearchPain":{"required":["sourceUrls","text"],"type":"object","properties":{"text":{"type":"string"},"evidence":{"type":"string","nullable":true},"sourceUrls":{"type":"array","items":{"type":"string"}},"date":{"type":"string","nullable":true}},"additionalProperties":false},"ResearchPricing":{"type":"object","properties":{"model":{"$ref":"#/components/schemas/ResearchClaim"},"pricePoints":{"type":"array","items":{"$ref":"#/components/schemas/ResearchClaim"},"nullable":true}},"additionalProperties":false},"ResearchSalesMotion":{"required":["value"],"type":"object","properties":{"value":{"type":"string","description":"One of all."},"evidence":{"type":"string","nullable":true},"sourceUrls":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"ResearchSourceClaim":{"required":["kind","sourceUrls","text"],"type":"object","properties":{"text":{"type":"string"},"sourceUrls":{"type":"array","items":{"type":"string"}},"date":{"type":"string","nullable":true},"kind":{"type":"string"}},"additionalProperties":false},"ResearchStackItem":{"required":["name","origin"],"type":"object","properties":{"name":{"type":"string"},"category":{"type":"string","nullable":true},"origin":{"type":"string"},"sourceUrls":{"type":"array","items":{"type":"string"}}},"additionalProperties":false,"description":"One tool in the merged stack (Ken Search, enrichment and the model's cited stack, deduped by name)."},"ResearchValue":{"required":["origin","value"],"type":"object","properties":{"value":{"type":"string"},"sub":{"type":"string","nullable":true},"origin":{"type":"string"},"sourceUrls":{"type":"array","items":{"type":"string"}}},"additionalProperties":false,"description":"One company value with its origin (a ResearchOrigin)."},"Stakeholder":{"required":["coverage","createdBy","pinnedFields","role","source","updatedBy"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"accountId":{"type":"integer","format":"int64"},"personId":{"type":"integer","format":"int64"},"role":{"type":"string"},"priority":{"type":"integer","format":"int32","nullable":true},"coverage":{"type":"string"},"note":{"type":"string","nullable":true},"reportsToStakeholderId":{"type":"integer","description":"The stakeholder on the same account this person reports to.","format":"int64","nullable":true},"kenNote":{"type":"string","description":"Ken's longer note for the person rail.","nullable":true},"source":{"type":"string"},"pinnedFields":{"type":"array","items":{"type":"string"}},"person":{"allOf":[{"$ref":"#/components/schemas/PersonSummary"}],"description":"A short view of a person, as an account's stakeholder carries it."},"createdBy":{"allOf":[{"$ref":"#/components/schemas/Actor"}],"description":"Who created or last changed a record."},"updatedBy":{"allOf":[{"$ref":"#/components/schemas/Actor"}],"description":"Who created or last changed a record."},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"warmPath":{"allOf":[{"$ref":"#/components/schemas/WarmPath"}],"description":"The strongest warm path to this person through the team's LinkedIn network on the stakeholder reads.\nOmitted when there is none or the workspace's `linkedin_network` feature is off."}},"additionalProperties":false,"example":{"id":2410,"accountId":6120,"personId":77310,"role":"champion","priority":1,"coverage":"engaged","note":"Warm path - worked with Alex at Fabrikam","kenNote":"Replied to the second email and asked for a demo. Runs the SDR team of six.","source":"search","pinnedFields":["role"],"person":{"id":77310,"fullName":"Amanda Chen","title":"VP of Engineering","email":"amanda.chen@northwind.example.com","ownerMemberId":1093},"createdBy":{"kind":"user","memberId":1093},"updatedBy":{"kind":"user","memberId":1093},"createdAt":"2026-09-23T15:02:11Z","updatedAt":"2026-10-14T09:41:27Z","warmPath":{"kind":"past_colleague","strength":90,"summary":"Worked with Amanda at Fabrikam (2019 to 2021)","linkedinAccountId":7702,"companyName":"Fabrikam","startDate":"2019-03-01","endDate":"2021-06-30"}}},"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."},"UpdateAccountBody":{"type":"object","properties":{"name":{"type":"string","nullable":true},"stage":{"type":"string","description":"One of the 16 stages: new, researching, warming, engaged, meeting_booked, in_deal, onboarding, client,\nchurned, nurture, paused, lost, network, not_a_fit, competitor or do_not_contact. Onboarding and client make the\naccount a customer (admins only). Cannot be null.","nullable":true},"networkLabel":{"type":"string","description":"partner, investor or personal: what kind of network contact an account at stage network is. Only with stage\nnetwork (the stored stage, or stage network in the same body); null clears it, which reads as personal.","nullable":true},"ownerMemberId":{"type":"integer","description":"A member of this workspace, or null to clear.","format":"int64","nullable":true},"fitScore":{"type":"integer","description":"0 to 100.","format":"int32","nullable":true},"whyNow":{"type":"string","nullable":true},"angle":{"type":"string","nullable":true},"cadenceDays":{"type":"integer","description":"1 to 365. Cannot be null.","format":"int32","nullable":true},"industry":{"type":"string","nullable":true},"fundingRound":{"type":"string","description":"The latest funding round, such as Series A. 1 to 100 characters.","nullable":true},"employeeCount":{"type":"integer","format":"int32","nullable":true},"hqLocation":{"type":"string","description":"Where the company sits, as free text (\"Berlin, Germany\"); where filters it with contains. hqCity and hqCountry are\nthe structured, exact-match fields.","nullable":true},"revenueRange":{"type":"string","description":"The annual revenue band in US dollars: under_1m, from_1m_to_10m, from_10m_to_50m, from_50m_to_100m,\nfrom_100m_to_1b or from_1b. Null clears it.","nullable":true},"hqCity":{"type":"string","description":"The HQ city, 1 to 200 characters.","nullable":true},"hqCountry":{"type":"string","description":"The HQ country: an ISO 3166-1 alpha-2 code such as DE, or a country name, stored as the code.","nullable":true},"foundedYear":{"type":"integer","description":"The year the company was founded, 1000 to 2100.","format":"int32","nullable":true},"linkedinUrl":{"type":"string","description":"The company page, such as https://linkedin.com/company/acme.","nullable":true},"kenCompanyId":{"type":"integer","description":"The company's Ken id: its id in Ken Search. Null clears it.","format":"int64","nullable":true},"sendsFromInboxId":{"type":"integer","description":"The inbox this account's email touches send from: a member's primary inbox (owned, on the\nworkspace's primary domain), or a shared campaign inbox on one of the workspace's cold sending domains. Null clears it, and the account owner's primary inbox sends.","format":"int64","nullable":true},"sendsFromLinkedInAccountId":{"type":"integer","description":"The LinkedIn account this account's LinkedIn touches send from. It must have been connected by a\nmember. Null clears it, and the LinkedIn account the owner connected sends.","format":"int64","nullable":true},"sendsFromWhatsAppAccountId":{"type":"integer","description":"The WhatsApp account this account's WhatsApp touches send from. It must have been connected by a member.\nNull clears it, and the WhatsApp account the owner connected sends.","format":"int64","nullable":true},"sendsFromImessageLineId":{"type":"integer","description":"The iMessage line this account's texts usually send from: a line of this workspace that has not ended,\nowned by a current member. A first text goes from an active line in the person's country (this one, else the\naccount owner's, else the oldest), else from this line; a person with a thread keeps its line. The owner of the\nline a text goes from approves it. Null clears it: the owner's first active line then stands in for this one.","format":"int64","nullable":true},"sendsFromFacebookAccountId":{"type":"integer","description":"The Facebook account this account's Facebook touches send from. It must have been connected by a member,\nand the workspace must have Facebook outreach on. Null clears it, and the lowest-id Facebook account the owner\nconnected sends.","format":"int64","nullable":true},"customFields":{"type":"object","additionalProperties":{},"description":"Custom field values by field key (a record's customFields shows the keys), merged per key: send only the keys to\nchange, and a key as null to clear it. Each value is read as its field's type: text and url a string, number a number,\nboolean true or false, date a date or an ISO 8601 time, select an option's key or label, multi_select a list of\nthem, currency {\"amount\": 1200.50, \"currency\": \"USD\"}, user a member id. A key no field names, an archived\nfield or a value of the wrong type is 400 with details on customFields.<key>. A person's value pins the\nfield as custom.<key>, like the built-in fields. Needs the custom_fields feature.","nullable":true},"overwritePinned":{"type":"boolean","description":"Change fields a person set. Send true only when the user asked for this change.","nullable":true},"sendsFromInstagramAccountId":{"type":"integer","description":"The Instagram account this account's Instagram touches send from: one of this workspace's, connected by\na member. Null clears it, and the Instagram account the owner connected sends. The account owner or an admin\nchanges it, as with the other Sends from fields.","format":"int64","nullable":true},"tierOverride":{"type":"integer","description":"1 to the ladder's tierCount (at most 10) sets the account's tier by hand and routes it there at once; null is Auto (the account keeps\nits tier and the ladder moves it from then on).","format":"int32","nullable":true},"isCustomer":{"type":"boolean","description":"true marks the account a customer and puts its domains on the blocklist (reason customer); false clears it and\ntakes off only the rows the flag added. Admins only (403 customer_not_allowed). Cannot be null.","nullable":true},"accountType":{"type":"string","description":"prospect, client, lost, churned, partner, competitor, investor or do_not_contact. It moves the stage: client to client; churned, competitor, do_not_contact and lost to that stage; partner and investor to network\nwith that label; prospect to researching from a stage that reads another type. client is the customer flag: moving to\nclient sets isCustomer and moving a client away clears it, so either needs an admin (403 customer_not_allowed). Ignored\nwhen the body also sends stage. Cannot be null.","nullable":true}},"additionalProperties":false,"example":{"stage":"meeting_booked","fitScore":88,"whyNow":"Booked a demo after the Series B announcement; the VP of Engineering owns the budget."}},"WarmPath":{"required":["kind","summary"],"type":"object","properties":{"kind":{"type":"string","description":"past_colleague, connection, connection_colleague or shared_company."},"strength":{"type":"integer","description":"90 past_colleague, 80 connection, 60 connection_colleague, 40 shared_company; half at a school.","format":"int32"},"summary":{"type":"string","description":"One line, e.g. \"Worked with Jordan at Segment (2019 to 2021)\"."},"linkedinAccountId":{"type":"integer","description":"The team's LinkedIn account (seat) the path goes through.","format":"int64"},"linkedinConnectionId":{"type":"integer","description":"The seat's connection the path goes through (connection and connection_colleague).","format":"int64","nullable":true},"companyName":{"type":"string","description":"Where the two worked; omitted for connection.","nullable":true},"startDate":{"type":"string","description":"YYYY-MM-DD: the overlap's start, or for shared_company the seat owner's tenure. Omitted for connection.","nullable":true},"endDate":{"type":"string","description":"YYYY-MM-DD; an ongoing overlap ends today.","nullable":true}},"additionalProperties":false,"description":"One warm path to a stakeholder: how someone on the team can reach them."}}}}