{"openapi":"3.0.4","info":{"title":"Kenso API: Account domains","version":"1.1","description":"The Account domains 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":"account-domains","description":"An account's domains are the company's website and email domains. Kenso matches people, emails and imports to the\naccount by them, and one domain belongs to one account. Add a domain to an account, or remove one by its id; both\nanswer with the account.","x-displayName":"Account domains"}],"paths":{"/v1/accounts/{accountId}/domains":{"post":{"tags":["account-domains"],"summary":"Add a domain to an account. Returns the account.","description":"`domain`: a domain, website URL or work email (normalized to the registrable domain).\n`isPrimary` makes it the primary. A domain the account already has is a `200` no-op.\nOne another account owns is `409 conflict` with `domain_taken` (and that `accountId`,\nunless account scope `own` hides that account). Requires 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":"account-domains.create","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/AddAccountDomainBody"}}}},"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"]},"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/account-domains/{accountDomainId}":{"delete":{"tags":["account-domains"],"summary":"Remove a domain from its account. Returns the account.","description":"The account's last domain cannot go (`409 invalid_state`, `last_domain`). Removing the\nprimary promotes the oldest remaining domain. Requires 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":"account-domains.delete","parameters":[{"name":"accountDomainId","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":{"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"]},"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"],"x-ken-permission":{"kind":"page","page":"accounts","access":"edit","summary":"Accounts edit"},"x-ken-rate-limit":{"limit":4800,"windowSeconds":60,"per":"api_key"}}}},"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Enter: Bearer {your Kenso API key}. Create one in the Kenso app under Settings > Integrations > API Keys.","scheme":"bearer","bearerFormat":"Opaque API key"}},"headers":{"RateLimit-Limit":{"description":"The request limit of the rate limit this request is closest to reaching: your plan's limit for this kind of call, your API key's own limit, or the operation's own limit, whichever has the fewest requests left.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"The requests left under that limit. `0` on a `429`.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"The seconds until that limit resets.","schema":{"type":"integer"}}},"schemas":{"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"}},"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."},"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."},"AddAccountDomainBody":{"required":["domain"],"type":"object","properties":{"domain":{"type":"string","description":"A domain, website URL or work email. Required."},"isPrimary":{"type":"boolean","nullable":true}},"additionalProperties":false,"example":{"domain":"northwind-labs.example.com","isPrimary":false}},"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."},"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."},"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."},"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."},"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."}}}}