{"openapi":"3.1.0","paths":{"/client/v2/user/team-members":{"get":{"operationId":"UserClientApiController_listTeamMembers","summary":"List Team Members","description":"Returns all users visible to the current user inside their selected team. Optionally narrow the result by `registrationType` — e.g. to show only invited members or only managed accounts.","parameters":[{"description":"Optional filter by how the user entered the system. `NEW_USER_SIGNUP` — self-signup; `NEW_USER_WORKSPACE_INVITE_CONFIRM` — accepted a team invite; `SUB_USER` — managed account created by another user.","required":false,"name":"registrationType","in":"query","schema":{"enum":["NEW_USER_SIGNUP","NEW_USER_WORKSPACE_INVITE_CONFIRM","SUB_USER"],"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListTeamMembersResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Team Members"],"security":[{"api-key":[]}]}},"/client/v2/account-settings/{ownerId}/linkedin-status":{"get":{"operationId":"AccountSettingsClientApiController_getLinkedInStatus","summary":"Get LinkedIn Connection Status","description":"Returns the account's LinkedIn connection, Sales Navigator and recent action restrictions. An existing account permission or an accessible campaign of this owner permits this read. Connecting, reconnecting and changing settings require separate account permissions.","parameters":[{"description":"Extrovert owner user ID. This read also accepts campaign access in the current workspace; settings and account-management permissions are unchanged.","required":true,"name":"ownerId","in":"path","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetLinkedinStatusResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Account Settings"],"security":[{"api-key":[]}]}},"/client/v2/account-settings/{ownerId}/daily-limits":{"get":{"operationId":"AccountSettingsClientApiController_getDailyLimits","summary":"Get Daily Limits","description":"Returns the account's Daily Limits: how many comments, reactions and connection requests it may make, and how many unaccepted connection requests it may withdraw, per day.","parameters":[{"description":"Extrovert user ID, not the LinkedIn-profile or membership-record ID. You may manage your own account; another account requires account-management permission and a creator seat in this workspace. Campaign sharing alone is not enough.","required":true,"name":"ownerId","in":"path","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetDailyLimitsResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Account Settings"],"security":[{"api-key":[]}]},"put":{"operationId":"AccountSettingsClientApiController_updateDailyLimits","summary":"Update Daily Limits","description":"Replaces the account's comment, reaction and connection-request Daily Limits with the three values given — all three are required — and the withdrawal limit when it is given, and returns the values saved.","parameters":[{"name":"ownerId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDailyLimitsRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDailyLimitsResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Account Settings"],"security":[{"api-key":[]}]}},"/client/v2/account-settings/{ownerId}/working-hours":{"get":{"operationId":"AccountSettingsClientApiController_getWorkingHours","summary":"Get Working Hours","description":"Returns the account's Working Hours: the working window of each weekday and the timezone they are read in.","parameters":[{"description":"Extrovert user ID, not the LinkedIn-profile or membership-record ID. You may manage your own account; another account requires account-management permission and a creator seat in this workspace. Campaign sharing alone is not enough.","required":true,"name":"ownerId","in":"path","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetWorkingHoursResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Account Settings"],"security":[{"api-key":[]}]},"put":{"operationId":"AccountSettingsClientApiController_updateWorkingHours","summary":"Update Working Hours","description":"Replaces the account's Working Hours with the given week — a weekday sent without a window becomes a day off — and returns the values saved.","parameters":[{"name":"ownerId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWorkingHoursRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWorkingHoursResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Account Settings"],"security":[{"api-key":[]}]}},"/client/v2/workspace/get-current-plan-features":{"get":{"operationId":"WorkspaceClientApiController_getCurrentPlanFeatures","summary":"Get Current Workspace Plan Features","description":"Returns the capabilities granted by the workspace's current plan: `planName`, `isPlanActive`, the list of boolean capability flags (`features`), and the list of counter quotas with their effective `max` (`counters`).","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCurrentPlanFeaturesResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Workspace"],"security":[{"api-key":[]}]}},"/client/v2/workspace/get-capacity":{"get":{"operationId":"WorkspaceClientApiController_getCapacity","summary":"Get Workspace Capacity","description":"Returns how much of each workspace Capacity pool is occupied, how much may be occupied and how much is left, together with the plan state those numbers were resolved under. Capacity is a property of the workspace, not of the caller: every member reads the same values. This is the authoritative source of occupancy and remainder — no consumer computes them from its own data. The composition of the limit and any monetary figure are not part of this contract.","parameters":[{"description":"Campaign the call is being planned for. Optional. While `planState` is `TRIAL` the limits are stated per campaign owner, so naming the campaign measures the pools for that campaign's owner — the same scope the operation itself will be admitted in. Omit it to measure your own scope; an API key, which names no user, then reads the workspace's busiest owner. The campaign must belong to your workspace.","examples":{"example1":{"value":"8d256aa6-9b12-49a7-93ee-bf41634b5b60"}},"required":false,"name":"campaignId","in":"query","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCapacityResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Workspace"],"security":[{"api-key":[]}]}},"/client/v2/dashboard/commenting":{"get":{"operationId":"DashboardStatisticsClientApiController_getCommenting","summary":"Get Dashboard Commenting Statistics","description":"Returns the Commenting section of the Dashboard for a period: comments posted, the average per day, and the daily posted and pending comments. The period is `startDate`–`endDate`, both calendar days included, in `timezone`: 1 to 366 days, and `endDate` is not later than today in that timezone. A period outside these rules or an unknown timezone is refused with 400. To get the same numbers as the Extrovert Dashboard, pass the `timezone` of the user's profile (the `timezone` field of the user in the Team Members list). Comparison values are against the preceding range of the same number of days. Pending counts approved actions waiting right now to be published or sent whose date lies in the period; actions still waiting for approval are not included, and it is not the historical size of the queue on that day. Every id filter is optional: an omitted or empty filter does not narrow that dimension, and without filters every campaign of the caller's scope is counted. `campaignsIds` come from the Campaign list, `ownersIds` from the Team Members list and `listsIds` from a campaign's prospect lists; filters given together narrow the scope together (AND), so only activity with prospects of the selected lists is counted. An id outside the caller's scope, a deleted prospect list included, is refused with 403.","parameters":[{"description":"Optional campaign-owner user IDs in the accessible workspace scope. Omit or pass `[]` for no owner filter; combined with `campaignsIds` and `listsIds` using AND.","required":false,"name":"ownersIds","in":"query","schema":{"maxItems":1000,"type":"array","items":{"type":"string","format":"uuid"}}},{"description":"Optional campaign IDs in the accessible workspace scope. Omit or pass `[]` for no campaign filter; combined with `ownersIds` and `listsIds` using AND.","required":false,"name":"campaignsIds","in":"query","schema":{"maxItems":1000,"type":"array","items":{"type":"string","format":"uuid"}}},{"description":"Optional prospect list IDs of campaigns in the accessible workspace scope. Omit or pass `[]` for no prospect list filter; combined with `ownersIds` and `campaignsIds` using AND.","required":false,"name":"listsIds","in":"query","schema":{"maxItems":1000,"type":"array","items":{"type":"string","format":"uuid"}}},{"description":"First calendar day of the period, included, `YYYY-MM-DD`.","examples":{"example1":{"value":"2026-09-12"}},"required":true,"name":"startDate","in":"query","schema":{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"}},{"description":"Last calendar day of the period, included, `YYYY-MM-DD`. Not later than today in `timezone`.","examples":{"example1":{"value":"2026-10-11"}},"required":true,"name":"endDate","in":"query","schema":{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"}},{"description":"Required IANA timezone the calendar days are taken in. Use the user's profile `timezone` to match the Dashboard.","examples":{"example1":{"value":"Europe/Paris"},"example2":{"value":"America/New_York"}},"required":true,"name":"timezone","in":"query","schema":{"minLength":1,"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCommentingResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Dashboard"],"security":[{"api-key":[]}]}},"/client/v2/dashboard/connections":{"get":{"operationId":"DashboardStatisticsClientApiController_getConnections","summary":"Get Dashboard Connection Statistics","description":"Returns the Connections section of the Dashboard for a period: connection requests sent, the requests sent and the requests accepted on each day (each counted on its own day), and the acceptance rate. The period is `startDate`–`endDate`, both calendar days included, in `timezone`: 1 to 366 days, and `endDate` is not later than today in that timezone. A period outside these rules or an unknown timezone is refused with 400. To get the same numbers as the Extrovert Dashboard, pass the `timezone` of the user's profile (the `timezone` field of the user in the Team Members list). Comparison values are against the preceding range of the same number of days. The acceptance rate is All time: it covers every request ever sent and does not depend on the period. Every id filter is optional: an omitted or empty filter does not narrow that dimension, and without filters every campaign of the caller's scope is counted. `campaignsIds` come from the Campaign list, `ownersIds` from the Team Members list and `listsIds` from a campaign's prospect lists; filters given together narrow the scope together (AND), so only activity with prospects of the selected lists is counted. An id outside the caller's scope, a deleted prospect list included, is refused with 403.","parameters":[{"description":"Optional campaign-owner user IDs in the accessible workspace scope. Omit or pass `[]` for no owner filter; combined with `campaignsIds` and `listsIds` using AND.","required":false,"name":"ownersIds","in":"query","schema":{"maxItems":1000,"type":"array","items":{"type":"string","format":"uuid"}}},{"description":"Optional campaign IDs in the accessible workspace scope. Omit or pass `[]` for no campaign filter; combined with `ownersIds` and `listsIds` using AND.","required":false,"name":"campaignsIds","in":"query","schema":{"maxItems":1000,"type":"array","items":{"type":"string","format":"uuid"}}},{"description":"Optional prospect list IDs of campaigns in the accessible workspace scope. Omit or pass `[]` for no prospect list filter; combined with `ownersIds` and `campaignsIds` using AND.","required":false,"name":"listsIds","in":"query","schema":{"maxItems":1000,"type":"array","items":{"type":"string","format":"uuid"}}},{"description":"First calendar day of the period, included, `YYYY-MM-DD`.","examples":{"example1":{"value":"2026-09-12"}},"required":true,"name":"startDate","in":"query","schema":{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"}},{"description":"Last calendar day of the period, included, `YYYY-MM-DD`. Not later than today in `timezone`.","examples":{"example1":{"value":"2026-10-11"}},"required":true,"name":"endDate","in":"query","schema":{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"}},{"description":"Required IANA timezone the calendar days are taken in. Use the user's profile `timezone` to match the Dashboard.","examples":{"example1":{"value":"Europe/Paris"},"example2":{"value":"America/New_York"}},"required":true,"name":"timezone","in":"query","schema":{"minLength":1,"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetConnectionsResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Dashboard"],"security":[{"api-key":[]}]}},"/client/v2/dashboard/direct-messages":{"get":{"operationId":"DashboardStatisticsClientApiController_getDirectMessages","summary":"Get Dashboard Direct Message Statistics","description":"Returns the Direct Messages section of the Dashboard for a period: direct messages sent, the daily sent and pending messages, and the reply rate. The period is `startDate`–`endDate`, both calendar days included, in `timezone`: 1 to 366 days, and `endDate` is not later than today in that timezone. A period outside these rules or an unknown timezone is refused with 400. To get the same numbers as the Extrovert Dashboard, pass the `timezone` of the user's profile (the `timezone` field of the user in the Team Members list). Pending counts approved actions waiting right now to be published or sent whose date lies in the period; actions still waiting for approval are not included, and it is not the historical size of the queue on that day. The reply rate is All time: it covers every conversation ever messaged and does not depend on the period. Every id filter is optional: an omitted or empty filter does not narrow that dimension, and without filters every campaign of the caller's scope is counted. `campaignsIds` come from the Campaign list, `ownersIds` from the Team Members list and `listsIds` from a campaign's prospect lists; filters given together narrow the scope together (AND), so only activity with prospects of the selected lists is counted. An id outside the caller's scope, a deleted prospect list included, is refused with 403.","parameters":[{"description":"Optional campaign-owner user IDs in the accessible workspace scope. Omit or pass `[]` for no owner filter; combined with `campaignsIds` and `listsIds` using AND.","required":false,"name":"ownersIds","in":"query","schema":{"maxItems":1000,"type":"array","items":{"type":"string","format":"uuid"}}},{"description":"Optional campaign IDs in the accessible workspace scope. Omit or pass `[]` for no campaign filter; combined with `ownersIds` and `listsIds` using AND.","required":false,"name":"campaignsIds","in":"query","schema":{"maxItems":1000,"type":"array","items":{"type":"string","format":"uuid"}}},{"description":"Optional prospect list IDs of campaigns in the accessible workspace scope. Omit or pass `[]` for no prospect list filter; combined with `ownersIds` and `campaignsIds` using AND.","required":false,"name":"listsIds","in":"query","schema":{"maxItems":1000,"type":"array","items":{"type":"string","format":"uuid"}}},{"description":"First calendar day of the period, included, `YYYY-MM-DD`.","examples":{"example1":{"value":"2026-09-12"}},"required":true,"name":"startDate","in":"query","schema":{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"}},{"description":"Last calendar day of the period, included, `YYYY-MM-DD`. Not later than today in `timezone`.","examples":{"example1":{"value":"2026-10-11"}},"required":true,"name":"endDate","in":"query","schema":{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"}},{"description":"Required IANA timezone the calendar days are taken in. Use the user's profile `timezone` to match the Dashboard.","examples":{"example1":{"value":"Europe/Paris"},"example2":{"value":"America/New_York"}},"required":true,"name":"timezone","in":"query","schema":{"minLength":1,"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetDirectMessagesResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Dashboard"],"security":[{"api-key":[]}]}},"/client/v2/csv-export":{"get":{"operationId":"CsvExportClientApiController_download","summary":"Download CSV Export","description":"Streams a CSV export of prospects, published comments or Dashboard statistics (`text/csv`). A file holds at most 10000 rows; a larger export is refused with a message to narrow the filter (a campaign, a list or a shorter period), never cut off. Up to 2 exports of one caller run at a time, and the same export started again within 60 seconds is refused with 429. Access follows the caller's own rights, exactly as the corresponding lists in the app; an inaccessible campaign or list is refused with 403. The file is UTF-8 with a BOM, with snake_case column names, ISO 8601 dates and full URLs.","parameters":[{"description":"What the file contains. `prospects`: prospects with their connection and engagement numbers; filter by `campaignId` or `listId`. `comments`: comments published on LinkedIn, oldest first; filter by `campaignId` and the period, no period means all time. `statistics`: the Dashboard numbers, one row per day; the period is required and keeps the Dashboard limit of 366 days.","required":true,"x-nestjs_zod-parent-metadata":{"dependentRequired":{"startDate":["endDate"],"endDate":["startDate"]}},"name":"type","in":"query","schema":{"enum":["prospects","comments","statistics"],"type":"string"}},{"description":"Optional campaign ID in the caller's scope; omit for every accessible campaign.","required":false,"x-nestjs_zod-parent-metadata":{"dependentRequired":{"startDate":["endDate"],"endDate":["startDate"]}},"name":"campaignId","in":"query","schema":{"format":"uuid","type":"string"}},{"description":"Optional prospect list ID; `prospects` only.","required":false,"x-nestjs_zod-parent-metadata":{"dependentRequired":{"startDate":["endDate"],"endDate":["startDate"]}},"name":"listId","in":"query","schema":{"format":"uuid","type":"string"}},{"description":"First calendar day of the period, included, `YYYY-MM-DD`. Given together with `endDate`.","examples":{"example1":{"value":"2026-10-01"}},"required":false,"x-nestjs_zod-parent-metadata":{"dependentRequired":{"startDate":["endDate"],"endDate":["startDate"]}},"name":"startDate","in":"query","schema":{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"}},{"description":"Last calendar day of the period, included, `YYYY-MM-DD`. Given together with `startDate`.","examples":{"example1":{"value":"2026-10-31"}},"required":false,"x-nestjs_zod-parent-metadata":{"dependentRequired":{"startDate":["endDate"],"endDate":["startDate"]}},"name":"endDate","in":"query","schema":{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"}},{"description":"IANA timezone the calendar days are taken in. Required for `statistics` (use the user's profile timezone to match the Dashboard); `comments` uses UTC without it. In the export link it may be omitted: the Extrovert app then uses the visitor's profile timezone.","examples":{"example1":{"value":"Europe/Berlin"}},"required":false,"x-nestjs_zod-parent-metadata":{"dependentRequired":{"startDate":["endDate"],"endDate":["startDate"]}},"name":"timezone","in":"query","schema":{"minLength":1,"type":"string"}}],"responses":{"200":{"description":"The CSV file.","content":{"text/csv":{"schema":{"type":"string"}}}},"401":{"description":"Invalid or missing API key.","content":{"text/csv":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["CSV Export"],"security":[{"api-key":[]}]}},"/client/v2/prospect-list/get-campaign-lists":{"get":{"operationId":"ProspectListClientApiController_getCampaignLists","summary":"List Prospect Lists on Campaign","description":"Returns all prospect lists attached to a campaign. Each list groups LinkedIn prospect URLs and exposes its total prospect count. Lists belong to exactly one campaign.","parameters":[{"description":"ID of the campaign whose prospect lists should be returned.","examples":{"example1":{"value":"8d256aa6-9b12-49a7-93ee-bf41634b5b60"}},"required":true,"name":"id","in":"query","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCampaignListsResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects"],"security":[{"api-key":[]}]}},"/client/v2/prospect-list/{id}":{"get":{"operationId":"ProspectListClientApiController_getOneList","summary":"Get Prospect List","description":"Loads a single prospect list by id, including counters and the parent campaign id.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetOneListResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects"],"security":[{"api-key":[]}]},"patch":{"operationId":"ProspectListClientApiController_update","summary":"Update Prospect List","description":"Updates a prospect list's name and parent campaign. If `campaignId` differs from the current parent campaign, the list and all its prospects are moved to that campaign. The returned id is the resulting list id and may differ after a move.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRequestDto2"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateResponseDto2"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects"],"security":[{"api-key":[]}]}},"/client/v2/prospect-list":{"post":{"operationId":"ProspectListClientApiController_createList","summary":"Create prospect list with LinkedIn profile URLs","description":"Creates a new prospect list inside the given campaign and seeds it with the provided LinkedIn profile URLs. No existing list or prospect is deleted. With `moveOwnDuplicated: true`, the owner's existing prospects among these URLs are moved into the new list, out of their current list and campaign, and their pending work there stops. The backend validates URLs and may reject some as invalid, duplicates, or out-of-limit. The response describes which URLs were submitted, rejected, or already existed elsewhere. Profile existence is verified asynchronously after this call: a URL can be accepted into `submittedUrls` and still be dropped later — check `prospect-list_get-one-list` for the final prospect count before reporting how many were actually added. For a list without prospects, use `prospect-list_create-empty-list`.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateListRequestDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateListResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects"],"security":[{"api-key":[]}]}},"/client/v2/prospect-list/create-empty-list":{"post":{"operationId":"ProspectListClientApiController_createEmptyList","summary":"Create Empty Prospect List","description":"Creates a new prospect list with no prospects inside the given Prospects campaign and returns it. Uses no credits and no Prospect Capacity. Refused when the plan is not active, when the campaign already holds its plan's maximum of prospect lists, or when the campaign is not a non-deleted Prospects campaign.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEmptyListRequestDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEmptyListResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}},"403":{"description":"The caller cannot update the campaign, the plan is not active, or the campaign already holds its plan's maximum of prospect lists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects"],"security":[{"api-key":[]}]}},"/client/v2/prospect-list/count-inactive":{"post":{"operationId":"ProspectListClientApiController_countInactive","summary":"Count Inactive Prospects","description":"Returns how many prospects in the given scope have not posted on LinkedIn in the last 30 days. Nothing is modified: this is the preview of `delete-inactive` — for the same scope, this is the number of prospects that endpoint deletes. Scope: pass `campaignIds`, `listIds`, or both.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountInactiveRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountInactiveResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}},"403":{"description":"No scope provided. Pass at least one of `campaignIds` or `listIds`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects"],"security":[{"api-key":[]}]}},"/client/v2/prospect-list/delete-inactive":{"post":{"operationId":"ProspectListClientApiController_deleteInactive","summary":"Delete Inactive Prospects","description":"Deletes prospects in the given scope that have not posted on LinkedIn in the last 30 days, and always rejects their pending post activities and discards their approvable DM drafts. The prospect lists themselves are kept. Scope: pass `campaignIds`, `listIds`, or both. The response carries no payload — preview the same scope with `count-inactive` to learn how many prospects will be deleted.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteInactiveRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteInactiveResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}},"403":{"description":"No scope provided. Pass at least one of `campaignIds` or `listIds`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects"],"security":[{"api-key":[]}]}},"/client/v2/prospect-list/{id}/add-users-to-list":{"post":{"operationId":"ProspectListClientApiController_addUsersToList","summary":"Add LinkedIn profile URLs to an existing prospect list","description":"Adds LinkedIn profile URLs to an existing prospect list. Same validation and duplicate rules as create-list. The response describes which URLs were accepted, rejected, or skipped as duplicates.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddUsersToListRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddUsersToListResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects"],"security":[{"api-key":[]}]}},"/client/v2/prospect-list/{id}/delete":{"post":{"operationId":"ProspectListClientApiController_delete","summary":"Delete Prospect List","description":"Deletes the given prospect list and all its prospects, and always rejects their pending/approvable post activities. Only this list is affected; other lists of the same campaign are kept.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteRequestDto2"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteResponseDto2"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects"],"security":[{"api-key":[]}]}},"/client/v2/prospects/{id}/replace-notes":{"post":{"operationId":"ProspectsClientApiController_replaceNotes","summary":"Replace Prospect Notes","description":"Replaces the relationship note on a real LEAD prospect. Empty text clears it. Existing campaign permissions apply; drafts and automation state are unchanged. Notes add context for comment and DM generation. Generation already receives relevant post and message-history context, so repeating it in Notes is usually unnecessary. Focus on additional relationship context.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplaceNotesBodyPublicApiDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplaceNotesResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects"],"security":[{"api-key":[]}]}},"/client/v2/prospects/{id}/add-note-fact":{"post":{"operationId":"ProspectsClientApiController_addNoteFact","summary":"Add Prospect Note Fact","description":"Adds a fact to a real LEAD prospect's relationship note. When the current note plus the fact exceed 1800 characters, the whole note, including manually written text, is rewritten once into a shorter version and the earlier wording is not kept; the returned text is saved unchanged. Existing campaign permissions apply; drafts and automation state are unchanged. Notes add context for comment and DM generation. Generation already receives relevant post and message-history context, so repeating it in Notes is usually unnecessary. Focus on additional relationship context.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddNoteFactBodyPublicApiDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddNoteFactResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects"],"security":[{"api-key":[]}]}},"/client/v2/prospects":{"get":{"operationId":"ProspectsClientApiController_list","summary":"List Prospects","description":"Returns visible prospects with their campaign/list bindings and optional pagination information. Use `listId` to scope to a single list, or pass broader filter arrays for campaign-wide prospect management. This endpoint returns existing prospects only — it does not add them. To add new LinkedIn profiles, add their URLs to a prospect list (`create-list` or `add-users-to-list`).","parameters":[{"description":"Optional single-list shortcut. When present, it replaces `listsIds` with `[listId]`; it does not override `campaignsIds`, `search`, importance, frequency, or touch-point filters.","required":false,"name":"listId","in":"query","schema":{"format":"uuid","type":"string"}},{"description":"Campaign IDs to filter within the accessible Prospects scope. Omit or pass `[]` for no campaign restriction; non-empty campaign and list filters intersect with the other active filters.","required":false,"name":"campaignsIds","in":"query","schema":{"maxItems":1000,"type":"array","items":{"type":"string","format":"uuid"}}},{"description":"Optional filter to only show important or non-important prospects.","required":false,"name":"isImportant","in":"query","schema":{"type":"boolean"}},{"description":"Filter the stored direct-post weekly frequency estimate: `MORE_THAN_TWICE_PER_WEEK` >2; `ONE_TO_TWO_TIMES_PER_WEEK` 1–2 inclusive; `ONE_TO_THREE_TIMES_PER_MONTH` 0.25–0.99 inclusive; `LESS_THAN_ONCE_PER_MONTH` <0.25. This is based on fetched activity, not a live or calendar-month LinkedIn count.","required":false,"name":"postFrequency","in":"query","schema":{"enum":["MORE_THAN_TWICE_PER_WEEK","ONE_TO_TWO_TIMES_PER_WEEK","ONE_TO_THREE_TIMES_PER_MONTH","LESS_THAN_ONCE_PER_MONTH"],"type":"string"}},{"description":"List IDs to filter by; omit or pass `[]` for no list restriction. If `listId` is supplied, it replaces this array with `[listId]`, rather than intersecting with it. Other active filters still apply.","required":false,"name":"listsIds","in":"query","schema":{"maxItems":1000,"type":"array","items":{"type":"string","format":"uuid"}}},{"description":"Sort field: `prospectName` = stored LinkedIn full name; `campaignName` = campaign name; `postFrequency` = direct weekly post frequency; `totalComments` = published direct comments only; `lastComment` = stored direct comment timestamp (may include `POSTING`); `lastPostCheck` = last successful post-fetch finish. Omit for name ascending.","required":false,"name":"sortBy","in":"query","schema":{"enum":["prospectName","campaignName","postFrequency","totalComments","lastComment","lastPostCheck"],"type":"string"}},{"description":"`ASC` sorts the chosen field ascending; `DESC` sorts it descending. If omitted, `lastComment` and `lastPostCheck` default to `DESC` and other explicit fields to `ASC`. If `sortBy` is omitted, the backend uses name `ASC` even if `sortOrder` is supplied.","required":false,"name":"sortOrder","in":"query","schema":{"enum":["ASC","DESC"],"type":"string"}},{"description":"Case-insensitive stored LinkedIn full-name search after whitespace normalization; `%` and `_` remain SQL LIKE wildcards. Does not search headline, company or profile URL. An empty normalized term adds no search restriction. A non-empty term currently replaces the default successful-enrichment predicate.","required":false,"name":"search","in":"query","schema":{"type":"string"}},{"description":"OR-filter on published or already `POSTING` direct-plus-indirect comments, not likes, DMs or connection requests. Omitting it or passing `[]` disables this filter. `COMMENTED_1_TIME` through `COMMENTED_5_TIMES` mean exactly 1 through 5; `COMMENTED_6_AND_MORE_TIMES` means 6 or more.","required":false,"name":"numberOfTouchPoints","in":"query","schema":{"type":"array","items":{"type":"string","enum":["NOT_COMMENTED","COMMENTED_1_TIME","COMMENTED_2_TIMES","COMMENTED_3_TIMES","COMMENTED_4_TIMES","COMMENTED_5_TIMES","COMMENTED_6_AND_MORE_TIMES"],"description":"Comment touch-point bucket: `COMMENTED_1_TIME` through `COMMENTED_5_TIMES` = exactly 1 through 5 published or `POSTING` direct-plus-indirect comments; `COMMENTED_6_AND_MORE_TIMES` = at least 6."}}},{"description":"Optional positive integer page size, at most 1000; omitted uses the backend default of 5. This is pagination, not a total-results cap. Pass it explicitly and use the returned pagination to read further pages.","examples":{"example1":{"value":5},"example2":{"value":25}},"required":false,"name":"limit","in":"query","schema":{"maximum":1000,"exclusiveMinimum":0,"type":"integer"}},{"description":"Optional zero-based offset in the same filtered result; omitted starts at 0. Keep the same filters and ordering when advancing pages. The public maximum is 2147483647.","examples":{"example1":{"value":0},"example2":{"value":5},"example3":{"value":25}},"required":false,"name":"offset","in":"query","schema":{"minimum":0,"maximum":2147483647,"type":"integer"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects"],"security":[{"api-key":[]}]}},"/client/v2/prospects/find-by-linkedin-url":{"get":{"operationId":"ProspectsClientApiController_findByLinkedInUrl","summary":"Find Prospect By LinkedIn URL","description":"Checks whether a LinkedIn profile URL already exists among the team's prospects and returns all matching prospect records if found. This only searches existing prospects — it does not add them. To add new LinkedIn profiles, add their URLs to a prospect list (`create-list` or `add-users-to-list`).","parameters":[{"description":"LinkedIn profile URL to normalize and search among existing accessible Prospects records. This does not add a prospect or check global team-wide absence; an invalid LinkedIn-profile URL can yield `exists=false` rather than a missing-profile error.","examples":{"example1":{"value":"https://www.linkedin.com/in/john-doe"},"example2":{"value":"https://www.linkedin.com/in/jane-smith-123456789"}},"required":true,"name":"url","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindByLinkedinUrlResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects"],"security":[{"api-key":[]}]}},"/client/v2/prospects/{id}":{"get":{"operationId":"ProspectsClientApiController_get","summary":"Get Prospect","description":"Loads one prospect by id with the current campaign/list bindings, flags, connection data, and lightweight statistics.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetResponseDto2"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects"],"security":[{"api-key":[]}]}},"/client/v2/prospects/delete-selected":{"post":{"operationId":"ProspectsClientApiController_deleteSelected","summary":"Delete Selected Prospects","description":"Deletes prospects so they stop appearing in campaign lists and always rejects their posts currently in 'Need approval' status. Two modes: (1) When `areAllSelected` is false, each `targetUsersData` entry is a (userId, LinkedIn profile id) pair — the backend deletes every prospect record with that LinkedIn profile across every campaign owned by that user in the team. This is a person-wide deletion for that user, not a per-campaign or per-record operation. (2) When `areAllSelected` is true, `targetUsersData` is ignored and the scope is controlled by `variant` (and `listId`) — may cover many prospects.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteSelectedRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteSelectedResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects"],"security":[{"api-key":[]}]}},"/client/v2/prospects/move":{"post":{"operationId":"ProspectsClientApiController_move","summary":"Move Selected Prospects","description":"Moves prospects between lists or into a new list inside the target campaign. Exactly one destination is required: pass `newListId` to reuse an existing list, or `newListName` to create a destination list. Pass one item in `prospectsIds` for a single-prospect case, or many items for a bulk operation. Moving a prospect that is already visible does not take a new unit of the workspace Prospect Capacity, whoever owns the destination campaign. The backend returns which prospects already existed at the destination. Requires an active plan: on an expired plan the move is rejected with `403`, while clean-up stays available.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoveRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoveResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects"],"security":[{"api-key":[]}]}},"/client/v2/prospects/{id}/mark-important":{"post":{"operationId":"ProspectsClientApiController_markImportant","summary":"Mark Prospect As Important","description":"Single-prospect operation: updates the important flag for one prospect.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarkImportantRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarkImportantResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects"],"security":[{"api-key":[]}]}},"/api/client/v1/prospects":{"get":{"operationId":"TargetUserClientApiController_getProspectsUrlsListWithStatistics","summary":"List Prospects With Statistics","description":"Returns prospects in a campaign together with their list membership and per-prospect engagement counters (posts fetched, direct and indirect comments, likes, connection status).","parameters":[{"description":"ID of the campaign to list prospects from.","examples":{"example1":{"value":"8d256aa6-9b12-49a7-93ee-bf41634b5b60"}},"required":true,"name":"campaignId","in":"query","schema":{"format":"uuid","type":"string"}},{"description":"Optional prospect list ID to narrow the result to a single list within the campaign.","examples":{"example1":{"value":"cf33282b-b171-4d23-ae02-848499d793e4"}},"required":false,"name":"listId","in":"query","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetListResponseDto2"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects (legacy)"],"security":[{"api-key":[]}]},"post":{"operationId":"TargetUserClientApiController_addProspectToList","summary":"Add Prospect","description":"Single-prospect operation: adds one prospect to a prospect list inside a campaign. If the prospect already exists elsewhere in the owner's team, the duplicate behavior is controlled by `moveDuplicatedProspect`.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRequestDto2"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateResponseDto2"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects (legacy)"],"security":[{"api-key":[]}]},"delete":{"operationId":"TargetUserClientApiController_removeProspectFromList","summary":"Remove Prospect From Campaign","description":"Single-prospect operation: removes one prospect from one campaign and always rejects that prospect's posts currently in 'Need approval' status. The prospect record may still exist in other campaigns or in other teammates' campaigns within the same team.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteRequestDto3"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteResponseDto3"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects (legacy)"],"security":[{"api-key":[]}]}},"/api/client/v1/workspace/prospects":{"delete":{"operationId":"TargetUserClientApiController_removeProspectFromWorkspace","summary":"Remove Prospect From Team","description":"Single-prospect operation with team-wide scope: removes one prospect from every campaign across every teammate in the team and always rejects that prospect's posts currently in 'Need approval' status. Use for full offboarding — when the prospect should not be re-engaged by anyone in the team. Cannot be undone.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteFromWorkspaceRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteFromWorkspaceResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Prospects (legacy)"],"security":[{"api-key":[]}]}},"/client/v2/comments":{"get":{"operationId":"CommentsClientApiController_getList","summary":"List comments","description":"Lists one campaign's comment feed for an owner and review state. Results include the post, author, effective prospect context, current draft, state, and only actions valid now. `plannedAt` fills only when the campaign spaces approved comments with a posting interval — null means posting starts right after approval. This action does not change feed state. After a mutation — approving or skipping a comment — restart paging from `offset = 0`, because a page taken at a stale offset can skip or repeat records; this matters most in `Need approval`, which is re-ranked on every request, while the other views are ordered by lifecycle transition time and do not reorder.","parameters":[{"description":"LinkedIn account owner whose campaign feed is being read. Often a managed account rather than the authenticated user — call `user_list-shared` first and pick the owner whose LinkedIn profile runs the campaign.","required":true,"name":"ownerId","in":"query","schema":{"format":"uuid","type":"string"}},{"description":"Campaign that scopes this feed. Aggregated cross-campaign feed is not part of this action.","required":true,"name":"campaignId","in":"query","schema":{"format":"uuid","type":"string"}},{"description":"Feed view, not an exact item-state filter. Need approval may include manual generation; Pending includes accepted generation or posting. Inspect each item’s state and `allowedActions`.","required":true,"name":"view","in":"query","schema":{"enum":["Need approval","Pending","Error","Posted","Skipped"],"type":"string"}},{"description":"Optional Prospect List filter. Cannot be combined with keywordId.","required":false,"name":"prospectListId","in":"query","schema":{"format":"uuid","type":"string"}},{"description":"Optional Keyword filter. Cannot be combined with prospectListId.","required":false,"name":"keywordId","in":"query","schema":{"format":"uuid","type":"string"}},{"description":"Number of records requested for this page.","required":false,"name":"limit","in":"query","schema":{"minimum":1,"maximum":50,"default":10,"type":"integer"}},{"description":"Offset from the start of the filtered result set.","required":false,"name":"offset","in":"query","schema":{"minimum":0,"maximum":2147483647,"default":0,"type":"integer"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetListResponseDto3"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Comments"],"security":[{"api-key":[]}]}},"/client/v2/comments/{postId}":{"get":{"operationId":"CommentsClientApiController_get","summary":"Get comment","description":"Returns the current owner-global comment by postId and ownerId across every state. The read is non-destructive and is the recovery check after an ambiguous write. `plannedAt` fills only when the campaign spaces approved comments with a posting interval — null means posting starts right after approval.","parameters":[{"description":"Post to read.","required":true,"name":"postId","in":"path","schema":{"format":"uuid","type":"string"}},{"description":"LinkedIn account owner whose comment state is returned.","required":true,"name":"ownerId","in":"query","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetResponseDto3"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Comments"],"security":[{"api-key":[]}]}},"/client/v2/comments/{postId}/generate-or-improve-draft":{"post":{"operationId":"CommentsClientApiController_generateOrImproveDraft","summary":"Generate or improve comment draft","description":"Generate writes a new Extrovert comment draft, including when no draft exists, using the selected campaign's Voice, optionally steered by one-off instructions. Improve rewrites the current draft text and requires both an existing draft with text and instructions. Both modes replace the current draft text, including text the user wrote or edited, and the replaced text is not kept. One-off instructions never change the Voice. Returns the comment with its new draft text. It does not approve or post the comment; a generation that produces no text is an error, never an empty success. The comment identity is postId + ownerId and the change is owner-global: it also applies to sibling campaign activities of the same owner, even when the feed context came from one campaign.","parameters":[{"name":"postId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateOrImproveDraftRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateOrImproveDraftResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Comments"],"security":[{"api-key":[]}]}},"/client/v2/comments/generate-drafts":{"post":{"operationId":"CommentsClientApiController_generateDrafts","summary":"Generate comment drafts","description":"Generates a fresh Extrovert comment draft for each listed post of one owner, using each post's campaign Voice (or the given campaign). Posts run in parallel, including posts of the same owner. Each post gets its own result in request order — the full comment with its draft text, or the reason it failed; a failed post never hides or undoes the others. Each generated draft replaces that post's current draft text, including text the user wrote or edited, and the replaced text is not kept. Batch generation never takes instructions and never improves; nothing is approved or posted. Up to 10 posts per call.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateDraftsRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateDraftsResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Comments"],"security":[{"api-key":[]}]}},"/client/v2/comments/{postId}/draft":{"patch":{"operationId":"CommentsClientApiController_setDraftText","summary":"Set comment draft text","description":"Sets the exact text of the unpublished comment draft for later review and approval, replacing the current draft text; the text Extrovert generated stays stored, but earlier text the user wrote or edited is replaced and not kept. It creates an ordinary draft when none exists and never calls Extrovert generation. If the text includes the post author's full LinkedIn name or a leading part of it, Extrovert automatically tags the author once when publishing, preferring the most complete matching name. Match a literal leading part of the LinkedIn name, preserving all leading emoji and the exact spelling. A matching name must contain at least two letters; emoji-only prefixes are skipped. It does not approve or post the comment; call it again to change the text. The comment identity is postId + ownerId and the change is owner-global: it also applies to sibling campaign activities of the same owner, even when the feed context came from one campaign.","parameters":[{"name":"postId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetDraftTextRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetDraftTextResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Comments"],"security":[{"api-key":[]}]}},"/client/v2/comments/{postId}/skip-and-react":{"post":{"operationId":"CommentsClientApiController_skipAndReact","summary":"Skip comment and react","description":"Queues only the selected LinkedIn reaction and does not publish the comment text. This action includes approval; do not submit a separate approval afterward. It does not move the item to Skipped. Success means the command was accepted for the normal Pending/publication lifecycle, not that the reaction is already live. The reaction configuration changes before approval; if approval fails, that configuration may remain changed. Do not retry automatically after a failed or ambiguous result; read the current comment state before deciding what to do next. The comment identity is postId + ownerId and the change is owner-global: it also applies to sibling campaign activities of the same owner, even when the feed context came from one campaign.","parameters":[{"name":"postId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkipAndReactRequestDto"}}}},"responses":{"202":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkipAndReactResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Comments"],"security":[{"api-key":[]}]}},"/client/v2/comments/{postId}/approve":{"post":{"operationId":"CommentsClientApiController_approve","summary":"Approve comment","description":"Approves the current owner-global comment/reaction and queues the consequential LinkedIn action. Success means the command was accepted for the existing Pending/publication lifecycle, not that the comment is already live. Use Get comment when current state is needed. The comment identity is postId + ownerId and the change is owner-global: it also applies to sibling campaign activities of the same owner, even when the feed context came from one campaign.","parameters":[{"name":"postId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApproveRequestDto"}}}},"responses":{"202":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApproveResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Comments"],"security":[{"api-key":[]}]}},"/client/v2/comments/bulk-approve":{"post":{"operationId":"CommentsClientApiController_bulkApprove","summary":"Bulk approve comments","description":"Approves the most relevant Need approval comments of one scope in a single request. The cards are selected live at request time: the request names a scope and how many comments to attempt, never card identities, so the result is not bound to any page a client is currently showing and may include comments it has never listed. Every card is claimed on its own — an accepted card enters the ordinary Pending/publication lifecycle and adds 1 to today's Comment Today progress, a card that is no longer approvable is skipped without side effects, and a failing card never rolls back the cards already accepted. The three counters always sum to the number of cards attempted, which is lower than the requested count when the scope holds fewer approvable comments.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkApproveRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkApproveResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Comments"],"security":[{"api-key":[]}]}},"/client/v2/comments/{postId}/cancel-posting":{"post":{"operationId":"CommentsClientApiController_cancelPosting","summary":"Cancel comment posting","description":"Attempts to cancel a Pending comment before LinkedIn posting starts. Success confirms cancellation and moves the comment to the Skipped state (use unskip to restore it); a request that is already too late returns an error rather than success. Use Get comment when current state is needed. The comment identity is postId + ownerId and the change is owner-global: it also applies to sibling campaign activities of the same owner, even when the feed context came from one campaign.","parameters":[{"name":"postId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelPostingRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelPostingResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Comments"],"security":[{"api-key":[]}]}},"/client/v2/comments/{postId}/skip":{"post":{"operationId":"CommentsClientApiController_skip","summary":"Skip comment","description":"Moves the owner-global comment out of the active review flow without posting a comment or reaction. Use unskip to restore a Skipped comment to review. The comment identity is postId + ownerId and the change is owner-global: it also applies to sibling campaign activities of the same owner, even when the feed context came from one campaign.","parameters":[{"name":"postId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkipRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkipResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Comments"],"security":[{"api-key":[]}]}},"/client/v2/comments/{postId}/unskip":{"post":{"operationId":"CommentsClientApiController_unskip","summary":"Unskip comment","description":"Returns a Skipped owner-global comment to the active review flow as Need approval, preserving the existing draft when one exists. It does not post anything; a comment that is not currently Skipped is rejected. Use Get comment when current state is needed. The comment identity is postId + ownerId and the change is owner-global: it also applies to sibling campaign activities of the same owner, even when the feed context came from one campaign.","parameters":[{"name":"postId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnskipRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnskipResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Comments"],"security":[{"api-key":[]}]}},"/client/v2/main-feed":{"get":{"operationId":"MainFeedClientApiController_getList","summary":"List Main Feed comments","description":"Lists one page of an owner's Main Feed: the comment feed of every campaign that owner runs, merged into a single order and deduplicated so one LinkedIn post appears once even when several campaigns collected it. Each record carries the post, author, effective prospect context, current draft, state, and only the actions valid now; `engagementContexts` lists every campaign context the same comment is visible in. `pagination.total` counts the whole deduplicated owner-wide feed for the requested state, not one campaign. This action does not change feed state and never starts comment generation. After a mutation — approving or skipping a comment — restart paging from `offset = 0`, because a page taken at a stale offset can skip or repeat records; this matters most in `Need approval`, which is re-ranked on every request, while the other views are ordered by lifecycle transition time and do not reorder.","parameters":[{"description":"LinkedIn account owner whose Main Feed is being read. Often a managed account rather than the authenticated user.","required":true,"name":"ownerId","in":"query","schema":{"format":"uuid","type":"string"}},{"description":"Feed view, not an exact item-state filter. Need approval may include manual generation; Pending includes accepted generation or posting. Inspect each item’s state and `allowedActions`.","required":true,"name":"view","in":"query","schema":{"enum":["Need approval","Pending","Error","Posted","Skipped"],"type":"string"}},{"description":"Number of records requested for this page.","required":false,"name":"limit","in":"query","schema":{"minimum":1,"maximum":50,"default":10,"type":"integer"}},{"description":"Offset from the start of the owner-wide result set.","required":false,"name":"offset","in":"query","schema":{"minimum":0,"maximum":2147483647,"default":0,"type":"integer"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetListResponseDto4"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Main Feed"],"security":[{"api-key":[]}]}},"/client/v2/comment-today/{id}":{"get":{"operationId":"CommentTodayClientApiController_get","summary":"Get Comment Today State","description":"Returns the owner's Comment Today state: the daily approval goal and today's progress. Progress counts comment approvals accepted during the owner-local calendar day, across all channels. Accepted is not published: later publication failures or cancellations never decrease progress.","parameters":[{"description":"ID of the publishing owner (user) whose Comment Today state is addressed. The daily goal and progress are tracked per owner.","examples":{"example1":{"value":"8d256aa6-9b12-49a7-93ee-bf41634b5b60"}},"required":true,"name":"id","in":"path","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetResponseDto5"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Comment Today"],"security":[{"api-key":[]}]}},"/client/v2/comment-today/{id}/set-goal":{"patch":{"operationId":"CommentTodayClientApiController_setGoal","summary":"Set Comment Today Goal","description":"Sets the owner's daily comment-approval goal. Takes effect immediately: when the new goal is at or below today's progress, the state reports the goal as reached. The goal never limits or blocks approvals.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetGoalRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetGoalResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Comment Today"],"security":[{"api-key":[]}]}},"/client/v2/voice-comment-examples":{"get":{"operationId":"VoiceCommentExampleClientApiController_getVoiceList","summary":"List Comment Examples on a Voice","description":"Returns the saved Comment Examples attached to this Voice. Only those examples are supplied to comment generation; an empty collection adds no examples section. A Comment Example is a full sample comment (either captured by the backend from the user's real activity, or added manually) that is used as a writing-style sample when generating comments under that Voice. Entries appear via two paths: (1) automatically — when the parent Voice has `isLearningModeEnabled: true`, the backend captures the user's edited-and-approved comments; (2) manually — by creating an entry directly.","parameters":[{"description":"ID of the Voice whose Comment Examples should be returned.","required":true,"name":"id","in":"query","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetVoiceListResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice Comment Examples"],"security":[{"api-key":[]}]},"post":{"operationId":"VoiceCommentExampleClientApiController_create","summary":"Create Comment Examples","description":"Adds one or more Comment Examples to Voices. Each text should be a complete, polished sample comment in the desired tone of voice — it will be used as a writing-style sample when generating comments. Prefer several short, varied examples over one long block. Text limit: 1250 characters. Up to 20 entries per Voice. If the parent Voice has `isLearningModeEnabled: true`, the backend additionally captures Comment Examples automatically from the user's edited-and-approved comments, so slots may already be partially consumed. Returns one result per requested element, in request order: the saved Comment Example, or the reason that element was not applied (access, plan cap, not found). Other elements are unaffected. Comment Examples feed comment generation only — never direct messages. The change applies to future generations only: an already-generated comment draft keeps its text until it is regenerated (`comments_generate-or-improve-draft`).","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRequestDto4"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateResponseDto4"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice Comment Examples"],"security":[{"api-key":[]}]},"patch":{"operationId":"VoiceCommentExampleClientApiController_update","summary":"Update Comment Examples","description":"Replaces the `text` of one or more existing Comment Examples. Comment Examples not listed are left unchanged. Text limit: 1250 characters. Returns one result per requested element, in request order: the saved Comment Example, or the reason that element was not applied (access, plan cap, not found). Other elements are unaffected. Comment Examples feed comment generation only — never direct messages. The change applies to future generations only: an already-generated comment draft keeps its text until it is regenerated (`comments_generate-or-improve-draft`).","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRequestDto4"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateResponseDto4"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice Comment Examples"],"security":[{"api-key":[]}]},"delete":{"operationId":"VoiceCommentExampleClientApiController_delete","summary":"Delete Comment Examples","description":"Permanently deletes one or more Comment Examples. Comment Examples not listed are left unchanged. Returns one result per requested id, in request order, with the reason for any id that was not deleted. Note: deleting the parent Voice cascades to all its Comment Examples automatically — you do not need to call this per entry in that case. Comment Examples feed comment generation only — never direct messages. The change applies to future generations only: an already-generated comment draft keeps its text until it is regenerated (`comments_generate-or-improve-draft`).","parameters":[{"description":"Delete only these shared-Voice entries, independently by ID. Existing drafts and unlisted entries remain unchanged; inspect each result.","required":true,"name":"ids","in":"query","schema":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","format":"uuid"}}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteResponseDto5"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice Comment Examples"],"security":[{"api-key":[]}]}},"/client/v2/voice-comment-examples/{id}":{"get":{"operationId":"VoiceCommentExampleClientApiController_getById","summary":"Get Comment Example","description":"Loads a single Comment Example by id.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetByIdResponseDto2"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice Comment Examples"],"security":[{"api-key":[]}]}},"/client/v2/monitored-topics":{"get":{"operationId":"RelevantPostTagClientApiController_getOwnerList","summary":"List Monitored Topics","description":"Returns all Monitored Topics owned by the given user. A Monitored Topic is a named matching criterion used to decide whether a post qualifies for a Topic campaign. Each response item also reports which Topic campaign, if any, the topic is currently bound to as `campaign: { id, name }`.","parameters":[{"description":"ID of the user whose Monitored Topics should be returned.","examples":{"example1":{"value":"8d256aa6-9b12-49a7-93ee-bf41634b5b60"}},"required":true,"name":"id","in":"query","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetOwnerListResponseDto2"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Monitored Topics"],"security":[{"api-key":[]}]},"post":{"operationId":"RelevantPostTagClientApiController_create","summary":"Create Monitored Topics","description":"Creates one or more Monitored Topics, each owned by the given user. New topics are not bound to any campaign yet. Returns one result per requested element, in request order: the saved Monitored Topic, or the reason that element was not applied (access, plan cap, not found). Other elements are unaffected.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRequestDto5"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateResponseDto5"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Monitored Topics"],"security":[{"api-key":[]}]},"patch":{"operationId":"RelevantPostTagClientApiController_update","summary":"Update Monitored Topics","description":"Updates the name and description of one or more existing Monitored Topics. Topics not listed are left unchanged. Existing bindings to Topic campaigns are preserved. The owner cannot be changed. Returns one result per requested element, in request order: the saved Monitored Topic, or the reason that element was not applied (access, plan cap, not found). Other elements are unaffected.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRequestDto5"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateResponseDto5"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Monitored Topics"],"security":[{"api-key":[]}]},"delete":{"operationId":"RelevantPostTagClientApiController_delete","summary":"Delete Monitored Topics","description":"Permanently deletes one or more Monitored Topics. Topics not listed are left unchanged. Returns one result per requested id, in request order, with the reason for any id that was not deleted. Cascade per deleted topic: (1) any Topic campaign bound to this topic loses the binding — the binding is soft-deleted and the campaign's keyword set is regenerated automatically; (2) Prospects campaigns that use this topic in `commenting.postFilters.monitoredTopicIds` are NOT auto-cleaned — the id stays in the filter array but will no longer match anything, and the campaign must be updated if the filter should reflect the change.","parameters":[{"description":"Permanently delete these topics independently. For each bound topic, detach its binding and reject that binding's pending-approval posts; hide bindings with history, physically remove empty ones. Prospect topic-filter arrays are not cleaned automatically.","required":true,"name":"ids","in":"query","schema":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","format":"uuid"}}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteResponseDto6"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Monitored Topics"],"security":[{"api-key":[]}]}},"/client/v2/campaign-topic":{"get":{"operationId":"KeywordClientApiController_getByCampaign","summary":"List Monitored Topic Bindings on a Topic Campaign","description":"Returns all Monitored Topics attached to a Topic campaign — these are the topics the campaign uses to collect relevant posts. Each binding exposes the topic name (preserved even if the source Monitored Topic was deleted), and the timestamp of the last successful post-collection run.","parameters":[{"description":"ID of the Topic campaign whose Monitored Topic attachments should be returned.","examples":{"example1":{"value":"8d256aa6-9b12-49a7-93ee-bf41634b5b60"}},"required":true,"name":"id","in":"query","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetByCampaignResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Campaign Topics"],"security":[{"api-key":[]}]}},"/client/v2/campaign-topic/{campaignId}/toggle-bulk":{"post":{"operationId":"KeywordClientApiController_toggleBulk","summary":"Replace Monitored Topic Bindings on a Topic Campaign","description":"Replaces the full set of Monitored Topics that a Topic campaign uses to collect relevant posts. Pass the full target list: topics in `monitoredTopicIds` that are not yet attached become attached (previously deleted bindings are reactivated automatically); topics currently attached but missing from `monitoredTopicIds` become detached. Pass `[]` to detach every topic. `rejectPendingPostsForDetachedTopics=true` additionally rejects, in the same call, the pending-approval posts of the topics this call detaches — it does not clear the rest of the campaign's approval queue, has no effect when the call detaches nothing, and is a one-shot action, not persisted state on the campaign. Every binding this call makes visible takes one unit of the workspace Topic Capacity pool and detaching frees it; a set that does not fit the pool, or a workspace with an expired plan, is rejected with `403` and nothing is attached, while detaching is always allowed.","parameters":[{"name":"campaignId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToggleBulkRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToggleBulkResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Campaign Topics"],"security":[{"api-key":[]}]}},"/client/v2/voice-talking-points":{"get":{"operationId":"VoiceTalkingPointClientApiController_getVoiceList","summary":"List Talking Points on a Voice","description":"Returns all Talking Points attached to the given Voice. A Talking Point is a single idea, fact, or point of view (industry observations, product benefits, hot takes, thoughts that add value) used as context when generating comments on posts. Talking Points feed comment generation only — they are never used for direct messages.","parameters":[{"description":"ID of the Voice whose Talking Points should be returned.","required":true,"name":"id","in":"query","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetVoiceListResponseDto2"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice Talking Points"],"security":[{"api-key":[]}]},"post":{"operationId":"VoiceTalkingPointClientApiController_create","summary":"Create Talking Points","description":"Adds one or more Talking Points to Voices. Each Talking Point should be a single, focused idea, fact, or point of view the LLM can weave into a comment (industry observations, product benefits, hot takes, advice you'd give peers). Prefer several short Talking Points over one long block. Text limit: 750 characters. Up to 40 Talking Points per Voice. Returns one result per requested element, in request order: the saved Talking Point, or the reason that element was not applied (access, plan cap, not found). Other elements are unaffected. Talking Points feed comment generation only — never direct messages. The change applies to future generations only: an already-generated comment draft keeps its text until it is regenerated (`comments_generate-or-improve-draft`).","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRequestDto7"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateResponseDto7"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice Talking Points"],"security":[{"api-key":[]}]},"patch":{"operationId":"VoiceTalkingPointClientApiController_update","summary":"Update Talking Points","description":"Replaces the text of one or more existing Talking Points. Talking Points not listed are left unchanged. Text limit: 750 characters. Returns one result per requested element, in request order: the saved Talking Point, or the reason that element was not applied (access, plan cap, not found). Other elements are unaffected. Talking Points feed comment generation only — never direct messages. The change applies to future generations only: an already-generated comment draft keeps its text until it is regenerated (`comments_generate-or-improve-draft`).","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRequestDto7"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateResponseDto7"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice Talking Points"],"security":[{"api-key":[]}]},"delete":{"operationId":"VoiceTalkingPointClientApiController_delete","summary":"Delete Talking Points","description":"Permanently deletes one or more Talking Points. Talking Points not listed are left unchanged. Returns one result per requested id, in request order, with the reason for any id that was not deleted. Note: deleting the parent Voice cascades to all its Talking Points automatically — you do not need to call this per entry in that case. Talking Points feed comment generation only — never direct messages. The change applies to future generations only: an already-generated comment draft keeps its text until it is regenerated (`comments_generate-or-improve-draft`).","parameters":[{"description":"Delete only these shared-Voice entries, independently by ID. Existing drafts and unlisted entries remain unchanged; inspect each result.","required":true,"name":"ids","in":"query","schema":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","format":"uuid"}}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteResponseDto8"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice Talking Points"],"security":[{"api-key":[]}]}},"/client/v2/voice-talking-points/{id}":{"get":{"operationId":"VoiceTalkingPointClientApiController_getById","summary":"Get Talking Point","description":"Loads a single Talking Point by id.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetByIdResponseDto3"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice Talking Points"],"security":[{"api-key":[]}]}},"/client/v2/voice-selling-points":{"get":{"operationId":"VoiceSellingPointClientApiController_getVoiceList","summary":"List Selling Points on a Voice","description":"Returns all Selling Points attached to the given Voice. Selling Points feed direct-message generation only; templates are managed separately. An empty list means the AI has no Voice-specific sales facts to draw from.","parameters":[{"description":"ID of the Voice whose Selling Points should be returned.","required":true,"name":"id","in":"query","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetVoiceListResponseDto3"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice Selling Points"],"security":[{"api-key":[]}]},"post":{"operationId":"VoiceSellingPointClientApiController_create","summary":"Create Selling Points","description":"Adds one or more focused sales facts, benefits, proof points, capabilities or value propositions to Voices. Text limit: 750 characters. Up to 40 Selling Points per Voice. Returns one result per requested element, in request order: the saved Selling Point, or the reason that element was not applied (access, plan cap, not found). Other elements are unaffected. Selling Points feed direct-message generation only — never comments. The change applies to future generations only: an existing DM draft keeps its text until it is refreshed (`dm-conversations_generate-or-improve-reply`).","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRequestDto8"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateResponseDto8"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice Selling Points"],"security":[{"api-key":[]}]},"patch":{"operationId":"VoiceSellingPointClientApiController_update","summary":"Update Selling Points","description":"Replaces the text of one or more existing Selling Points. Selling Points not listed are left unchanged. Text limit: 750 characters. Returns one result per requested element, in request order: the saved Selling Point, or the reason that element was not applied (access, plan cap, not found). Other elements are unaffected. Selling Points feed direct-message generation only — never comments. The change applies to future generations only: an existing DM draft keeps its text until it is refreshed (`dm-conversations_generate-or-improve-reply`).","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRequestDto8"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateResponseDto8"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice Selling Points"],"security":[{"api-key":[]}]},"delete":{"operationId":"VoiceSellingPointClientApiController_delete","summary":"Delete Selling Points","description":"Permanently deletes one or more Selling Points. Selling Points not listed are left unchanged. Returns one result per requested id, in request order, with the reason for any id that was not deleted. Note: deleting the parent Voice cascades to all its Selling Points automatically — you do not need to call this per entry in that case. Selling Points feed direct-message generation only — never comments. The change applies to future generations only: an existing DM draft keeps its text until it is refreshed (`dm-conversations_generate-or-improve-reply`).","parameters":[{"description":"Delete only these shared-Voice entries, independently by ID. Existing drafts and unlisted entries remain unchanged; inspect each result.","required":true,"name":"ids","in":"query","schema":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","format":"uuid"}}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteResponseDto9"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice Selling Points"],"security":[{"api-key":[]}]}},"/client/v2/voice-selling-points/{id}":{"get":{"operationId":"VoiceSellingPointClientApiController_getById","summary":"Get Selling Point","description":"Loads a single Selling Point by id.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetByIdResponseDto4"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice Selling Points"],"security":[{"api-key":[]}]}},"/client/v2/voice-dm-templates":{"get":{"operationId":"VoiceDmTemplateClientApiController_getVoiceList","summary":"List DM Templates on a Voice","description":"Returns all structured DM Templates attached to the Voice. Each template has example text, when-to-use guidance and adaptation guidance. The LLM decides whether and how to apply it; templates are never inserted verbatim by the API.","parameters":[{"description":"ID of the Voice whose DM Templates should be returned.","required":true,"name":"id","in":"query","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetVoiceListResponseDto4"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice DM Templates"],"security":[{"api-key":[]}]},"post":{"operationId":"VoiceDmTemplateClientApiController_create","summary":"Create DM Templates","description":"Adds one or more structured DM Templates to Voices. All three fields of each element are required. The LLM chooses when to use a template and adapts it; callers should not pre-resolve variables. Up to 40 Templates per Voice. Returns one result per requested element, in request order: the saved DM Template, or the reason that element was not applied (access, plan cap, not found). Other elements are unaffected. DM Templates feed direct-message generation only — never comments. The change applies to future generations only: an existing DM draft keeps its text until it is refreshed (`dm-conversations_generate-or-improve-reply`).","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRequestDto9"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateResponseDto9"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice DM Templates"],"security":[{"api-key":[]}]},"patch":{"operationId":"VoiceDmTemplateClientApiController_update","summary":"Update DM Templates","description":"Replaces all three fields of one or more existing DM Templates. Templates not listed are left unchanged. Returns one result per requested element, in request order: the saved DM Template, or the reason that element was not applied (access, plan cap, not found). Other elements are unaffected. DM Templates feed direct-message generation only — never comments. The change applies to future generations only: an existing DM draft keeps its text until it is refreshed (`dm-conversations_generate-or-improve-reply`).","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRequestDto9"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateResponseDto9"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice DM Templates"],"security":[{"api-key":[]}]},"delete":{"operationId":"VoiceDmTemplateClientApiController_delete","summary":"Delete DM Templates","description":"Permanently deletes one or more DM Templates. Templates not listed are left unchanged. Returns one result per requested id, in request order, with the reason for any id that was not deleted. Note: deleting the parent Voice cascades to all its DM Templates automatically — you do not need to call this per entry in that case. DM Templates feed direct-message generation only — never comments. The change applies to future generations only: an existing DM draft keeps its text until it is refreshed (`dm-conversations_generate-or-improve-reply`).","parameters":[{"description":"Delete only these shared-Voice entries, independently by ID. Existing drafts and unlisted entries remain unchanged; inspect each result.","required":true,"name":"ids","in":"query","schema":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","format":"uuid"}}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteResponseDto10"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice DM Templates"],"security":[{"api-key":[]}]}},"/client/v2/voice-dm-templates/{id}":{"get":{"operationId":"VoiceDmTemplateClientApiController_getById","summary":"Get DM Template","description":"Loads a single DM Template by id.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetByIdResponseDto5"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voice DM Templates"],"security":[{"api-key":[]}]}},"/client/v2/campaign":{"get":{"operationId":"CampaignClientApiController_getList","summary":"List Campaigns","description":"Returns all campaigns visible to the current user (both types: `TARGET_USER` and `KEYWORD` — user-facing 'Prospects campaign' and 'Topic campaign' respectively).","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetListResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Campaigns"],"security":[{"api-key":[]}]},"post":{"operationId":"CampaignClientApiController_create","summary":"Create Campaign","description":"Creates a new campaign. The campaign owner must already have a Voice.\n\nTwo types (backend values `TARGET_USER` and `KEYWORD` correspond to user-facing 'Prospects campaign' and 'Topic campaign' respectively):\n- `TARGET_USER`: engages with a specific list of LinkedIn profiles.\n- `KEYWORD`: discovers posts by topic bindings.\n\nThe engagement-automation fields `skipTeammatesLeads` and `outreach` apply to `TARGET_USER` (Prospects) campaigns only. For `KEYWORD` (Topic) campaigns they do not apply — omit them (or leave them off).","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRequestDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Campaigns"],"security":[{"api-key":[]}]}},"/client/v2/campaign/{id}":{"get":{"operationId":"CampaignClientApiController_getOne","summary":"Get Campaign","description":"Loads full details of a single campaign, including the linked Voice, the whole `commenting` policy, and the full outreach settings (warm up, connection requests, direct messages).","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetOneResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Campaigns"],"security":[{"api-key":[]}]},"patch":{"operationId":"CampaignClientApiController_update","summary":"Update Campaign","description":"Updates the editable fields of an existing campaign. `id`, `name`, `voiceId` and `skipTeammatesLeads` are required (full replace). Backend types `TARGET_USER` and `KEYWORD` correspond to user-facing 'Prospects campaign' and 'Topic campaign' respectively.\n\n**`KEYWORD` campaigns: only `name` and the comment policy are editable.** The backend rejects with a 409 state-conflict whenever `skipTeammatesLeads`, an explicitly passed `outreach.connectionRequests.enabled`, or an explicitly passed `outreach.directMessages.enabled` differs from the current value. Omitting the optional `outreach` and `commenting` objects means \"no change\" and is always safe.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Campaigns"],"security":[{"api-key":[]}]}},"/client/v2/campaign/{id}/automatic-comments-settings":{"patch":{"operationId":"CampaignClientApiController_updateAutomaticCommentsSettings","summary":"Update Automatic Comments Settings","description":"Updates the Automatic Comments settings of a campaign. When enabled, the campaign automatically publishes top eligible comments from its approval feed — up to the daily cap, inside the active window intersected with the LinkedIn account's working hours — without manual review. Absent optional fields keep the currently stored values. Disabling stops scheduling new automatic comments but does not cancel already-scheduled pending publications — those must be cancelled manually if needed. Requires update permission on the campaign; returns 403 without it.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAutomaticCommentsSettingsRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAutomaticCommentsSettingsResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Campaigns"],"security":[{"api-key":[]}]}},"/client/v2/campaign/{id}/delete":{"post":{"operationId":"CampaignClientApiController_delete","summary":"Delete Campaign","description":"Soft-deletes a campaign and always removes all of its not-yet-posted activities.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Campaigns"],"security":[{"api-key":[]}]}},"/client/v2/campaign/{id}/start":{"post":{"operationId":"CampaignClientApiController_start","summary":"Start Campaign","description":"Activates a campaign (sets `isActive` to `true`): the post feed resumes updating, DM drafts are suggested again, and connection requests start being sent per the campaign's settings. The campaign must be properly configured first (a Voice, and either a ProspectList for `TARGET_USER` — user-facing 'Prospects campaign' — or Monitored Topics bound to the campaign for `KEYWORD` — user-facing 'Topic campaign').","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Campaigns"],"security":[{"api-key":[]}]}},"/client/v2/campaign/{id}/stop":{"post":{"operationId":"CampaignClientApiController_stop","summary":"Stop Campaign","description":"Pauses a campaign (sets `isActive` to `false`): the post feed stops updating, no DM drafts are suggested, and no connection requests are sent until the campaign is started again. Existing posts in the approval queue are preserved.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Campaigns"],"security":[{"api-key":[]}]}},"/client/v2/campaign/{id}/duplicate":{"post":{"operationId":"CampaignClientApiController_duplicate","summary":"Duplicate Campaign","description":"Creates a copy of an existing campaign. Copied: Voice, the whole `commenting` policy, outreach settings (warm up, connection requests, direct messages), `skipTeammatesLeads`, and sharing settings (subject to plan capabilities). NOT copied: attached prospects (for `TARGET_USER`) and bound MonitoredTopics (for `KEYWORD`) — the duplicate starts empty and must be populated via the corresponding tools. The duplicate is named `Copy of <original name>`.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicateResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Campaigns"],"security":[{"api-key":[]}]}},"/client/v2/campaign/{campaignId}/share":{"post":{"operationId":"CampaignClientApiController_share","summary":"Share Campaign","description":"Updates campaign sharing settings. Pass explicit user ids in `usersIds` to share with specific teammates, or set `shareWithAllWorkspaceUsers=true` to make the campaign visible to the whole team — in that case pass an empty array for `usersIds`.","parameters":[{"name":"campaignId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Campaigns"],"security":[{"api-key":[]}]}},"/client/v2/campaign/{id}/transfer":{"post":{"operationId":"CampaignClientApiController_transfer","summary":"Transfer Campaign Ownership","description":"Transfers the campaign to another owner. The target owner must also receive a compatible Voice because campaign ownership depends on owner-bound assets. Returns the id of the resulting campaign — the original campaign id becomes invalid after the transfer; use the returned id for all subsequent calls. Only Prospects (target-user) campaigns can be transferred.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransferRequestDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransferResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Campaigns"],"security":[{"api-key":[]}]}},"/client/v2/credits":{"get":{"operationId":"CreditsClientApiController_getContext","summary":"Get Credit Balance","description":"Returns the credit balance of the current workspace and what each billable action costs. Every team member may read it; the split into plan and bought credits is shown to an admin only.","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetContextResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Credits"],"security":[{"api-key":[]}]}},"/client/v2/credits/usage":{"get":{"operationId":"CreditsClientApiController_getUsage","summary":"Get Credit Usage","description":"Lists the credit consumption of the current workspace, newest first. An admin or an API key sees every consumption of the workspace; a manager or member sees only the consumption made for their own account.","parameters":[{"description":"Optional positive page size. Defaults to 25; values above 100 are capped at 100. Continue using the returned effective page bounds.","required":false,"name":"limit","in":"query","schema":{"maximum":9007199254740991,"exclusiveMinimum":0,"type":"integer"}},{"description":"Optional page offset. Increase it to load the next page with the same filters.","examples":{"example1":{"value":0},"example2":{"value":5},"example3":{"value":25}},"required":false,"name":"offset","in":"query","schema":{"minimum":0,"maximum":2147483647,"type":"integer"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetUsageResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Credits"],"security":[{"api-key":[]}]}},"/client/v2/credits/balance-activity":{"get":{"operationId":"CreditsClientApiController_getBalanceActivity","summary":"Get Credit Balance Activity","description":"Lists every operation on the workspace wallet, newest first — plan allocations, purchases, consumptions, forfeitures and corrections — with the balance after each. Workspace admins and API keys only.","parameters":[{"description":"Optional positive page size. Defaults to 25; values above 100 are capped at 100. Continue using the returned effective page bounds.","required":false,"name":"limit","in":"query","schema":{"maximum":9007199254740991,"exclusiveMinimum":0,"type":"integer"}},{"description":"Optional page offset. Increase it to load the next page with the same filters.","examples":{"example1":{"value":0},"example2":{"value":5},"example3":{"value":25}},"required":false,"name":"offset","in":"query","schema":{"minimum":0,"maximum":2147483647,"type":"integer"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetBalanceActivityResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Credits"],"security":[{"api-key":[]}]}},"/client/v2/lead-finder/search-schema":{"get":{"operationId":"LeadFinderClientApiController_getSearchSchema","summary":"Get Search Schema","description":"Returns the people-search filter grammar: every field a query may filter on (`fields`), what each accepts, the bounds a whole query is held to (`limits`) and the whole-query refusals (`rules`). A field with `valuePolicy` `closed` carries its whole vocabulary in `values`; a `custom` field takes free values. Free: consumes no credits.\n\nA query is a flat list of conditions, all of which must hold: `{\"filters\":[{\"field\":\"contact.titleLatest\",\"op\":\"any.include\",\"mode\":\"WORD\",\"values\":[\"sales director\"]},{\"field\":\"contact.titleLatest\",\"op\":\"any.exclude\",\"mode\":\"STRICT\",\"values\":[\"intern\"]},{\"field\":\"account.employeeSize\",\"op\":\"range\",\"ranges\":[{\"start\":51,\"end\":200}]}]}`. Each condition names one `field`, one of that field's `ops` as `op`, and the payload keys of the field's `control`:\n\n| `control` | `op` | Payload keys |\n|---|---|---|\n| `text_match` | `any.include`, `any.exclude`, `all.include` | `mode` (one of `matchModes`), `values` |\n| `value_list` | `any.include`, `any.exclude` | `values` |\n| `keyword_sources` | `any.include`, `any.exclude` | `sources`: `[{\"source\":\"HEADLINE\",\"mode\":\"WORD\"}]`, `values` |\n| `enum_list` | `in` | `values` |\n| `numeric_range_list` | `range` | `ranges`: `[{\"start\":51,\"end\":200},{\"start\":1001}]` |\n| `numeric_range` | `range` | `start`, `end` |\n| `duration_range` | `range` | `min`, `max`: `{\"year\":1,\"month\":6}` |\n| `date_range` | `range` | `start`, `end` |\n| `metric_employee_rows` | `rows` | `rows`: `[{\"departments\":[\"sales\"],\"start\":10,\"end\":50}]` |\n| `metric_growth_rows` | `rows` | `rows`: `[{\"departments\":[\"sales\"],\"start\":10,\"end\":50,\"timeFrame\":\"TWELVE\"}]` |\n\nA field takes only the `op` values its `ops` lists. `any.include` matches any of the values, `any.exclude` drops matches of any of them, `all.include` requires every value. `mode`, `values`, `sources`, `ranges` and `rows` are required where the control takes them, and every array is non-empty. A keyword condition has no `mode` of its own: each source carries one, each source from `sources` at most once, at most `maxSources` per condition. A band takes `start`, `end` or both, inclusive, and the bands of `ranges` combine with OR; a duration takes `min`, `max` or both, each `{\"year\":…,\"month\":…}` with both keys required (`month` 0 to 11 on top of whole years, e.g. `{\"year\":5,\"month\":0}` for five years); a date is epoch milliseconds or an ISO date such as `\"2024-01-01\"`; `metric_growth_rows` counts percent over a `timeFrame` from `timeFrames`. A key the control does not take, an `op` the field does not list, or a second condition with the same `field` and `op` is refused: put all the values of one `field` and `op` pair into one condition. A query needs at least one condition that is not `any.exclude`. The whole `query`, serialized as compact JSON, takes at most 149504 bytes. A refusal names the condition by its place in the list and, where known, its field and op, e.g. `query.filters[0].ranges[1]: starts above its end (account.employeeSize range)`. `limits.maxQueryBytes` and `limits.maxQueryDepth` count the query after the backend normalizes it, not the request as sent.\n\nPerson fields: `contact.titleLatest` job title of the primary active role, `contact.titleCurrent` any active role, `contact.titlePrevious` past roles; `contact.seniority` level; `contact.departmentAndFunction` the person's function; `contact.location` where the person is; `contact.durationCurrentJob` time in the current role, `contact.durationCurrentCompany` time at the current company, `contact.durationTotal` total experience; `contact.skill`; `contact.certification`; `contact.educationDegree`, `contact.educationFieldOfStudy`; `contact.language` languages spoken (closed values, but a `text_match` control, so a condition still needs `mode`); `contact.keyword` terms searched in chosen sections of the profile; `contact.profileBadge` LinkedIn profile badges; `contact.linkedInFollowers`.\nCompany fields (the employer): `account.name`, `account.domain` and `account.linkedin` (company LinkedIn URL) each name the employer, and an `any.exclude` condition on any of them may list several employers to leave out; `account.industries`; `account.productAndServices`; `account.technologies`; `account.employeeSize` headcount; `account.retailSize` number of offices; `account.revenue` annual revenue in USD; `account.foundedYear`; `account.type` company type such as `PUBLIC_COMPANY` or `NON_PROFIT`; `account.socialMedia` has a profile on a network; `account.language` operating language; `account.keyword` terms searched in chosen parts of the company record; `account.fundingType` round types, `account.fundingTotalAmount` and `account.fundingLastAmount` in USD, `account.fundingDate` last round date; `account.metricEmployee` headcount per department, `account.metricGrowth` headcount growth per department in percent over a window; `account.naics` 6-digit NAICS codes; `account.location` where the company has an office.","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetSearchSchemaResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Lead Finder"],"security":[{"api-key":[]}]}},"/client/v2/lead-finder/industries":{"get":{"operationId":"LeadFinderClientApiController_getIndustries","summary":"List Industries","description":"Returns the whole industry vocabulary the `account.industries` field of the people-search schema is filled from. That field is `custom`, so the schema itself carries no values for it. Free: consumes no credits.","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetIndustriesResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Lead Finder"],"security":[{"api-key":[]}]}},"/client/v2/lead-finder/technologies":{"get":{"operationId":"LeadFinderClientApiController_searchTechnologies","summary":"Search Technologies","description":"Searches the technology vocabulary the `account.technologies` field is filled from and returns at most `limit` matches, most widely used first. Prefix matches come before substring matches; matching is trimmed and case-insensitive, with no fuzzy matching, aliases or transliteration. Free: consumes no credits.","parameters":[{"description":"Fragment of a technology name to look for. At least 2 characters after trimming; matched case-insensitively.","examples":{"example1":{"value":"sales"},"example2":{"value":"hubspot"}},"required":true,"name":"search","in":"query","schema":{"minLength":2,"type":"string"}},{"description":"Largest number of values to return. Defaults to 20 when omitted; 50 is the hard maximum.","examples":{"example1":{"value":20},"example2":{"value":50}},"required":false,"name":"limit","in":"query","schema":{"maximum":50,"exclusiveMinimum":0,"default":20,"type":"integer"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchTechnologiesResponseDto"}}}},"400":{"description":"`search` is shorter than 2 characters after trimming, or `limit` is outside 1 to 50.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Lead Finder"],"security":[{"api-key":[]}]}},"/client/v2/lead-finder/locations":{"get":{"operationId":"LeadFinderClientApiController_searchLocations","summary":"Search Locations","description":"Searches the geography a location filter accepts — continents, economic zones, countries, states and cities — and returns at most `limit` matches, broadest tier first, stopping once the limit is filled: every continent match, then economic zones, countries, states and cities, and within one tier prefix matches before substring matches — so `ger` lists the countries Germany, Algeria and Niger before the state Gers. A name held by several tiers is returned once, with the broadest tier's spelling. Matching is trimmed and case-insensitive, with no fuzzy matching, aliases or transliteration. Free: consumes no credits.","parameters":[{"description":"Fragment of a continent, economic zone, country, state or city name to look for. At least 2 characters after trimming; matched case-insensitively.","examples":{"example1":{"value":"ger"},"example2":{"value":"san fra"}},"required":true,"name":"search","in":"query","schema":{"minLength":2,"type":"string"}},{"description":"Largest number of values to return. Defaults to 20 when omitted; 50 is the hard maximum.","examples":{"example1":{"value":20},"example2":{"value":50}},"required":false,"name":"limit","in":"query","schema":{"maximum":50,"exclusiveMinimum":0,"default":20,"type":"integer"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchLocationsResponseDto"}}}},"400":{"description":"`search` is shorter than 2 characters after trimming, or `limit` is outside 1 to 50.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Lead Finder"],"security":[{"api-key":[]}]}},"/client/v2/lead-finder/preview":{"post":{"operationId":"LeadFinderClientApiController_previewPeople","summary":"Preview People","description":"Runs a people search and returns the first page of the people matched plus `grossTotal`, how many people match in total. There is no further page and no page, size or cursor parameter. Each row carries the person's masked name, role, location, position history and current company, every value verbatim, and never a full name, LinkedIn URL, avatar or contact details. `query` is the flat list of conditions, `{\"filters\":[{\"field\":…,\"op\":…,…}]}`, written in the grammar Get Lead Finder Search Schema publishes for the `version` sent as `schemaVersion`; a query in any other shape is refused before the search, and a condition the grammar does not accept is refused naming it by its path (e.g. `query.filters[3].values`) and, where known, its field and op. Free: consumes no credits. Limit: 100 preview attempts per user, or per API key, in a sliding 24-hour window, regardless of filters or workspace; cached previews and refused attempts count too. Once the limit is reached no search is run and the answer is 429 with `Retry-After`, an approximate wait in seconds, not a guaranteed reset time.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewPeopleRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewPeopleResponseDto"}}}},"400":{"description":"The request is refused before any search: another `schemaVersion`, a query not in the flat `{\"filters\":[…]}` shape, or a condition the grammar does not accept, named by its path and, where known, its field and op.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}},"429":{"description":"The API key's preview limit is reached; `Retry-After` gives an approximate wait in seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Lead Finder"],"security":[{"api-key":[]}]}},"/client/v2/lead-finder/imports":{"post":{"operationId":"LeadFinderClientApiController_importProspects","summary":"Import Prospects","description":"Starts a paid import of prospects into a prospect list of a campaign. `FILTERS` buys `count` live matches of the same `query` starting at zero-based `startOffset` (default 0); `startOffset + count` must not exceed `limits.resultCeiling`. Skipped rows are not retrieved or charged. `SELECTED` permits only omitted or zero offset. Live ordering can shift; no unique or new prospects are guaranteed. After a completed import, the next window starts at its accepted `startOffset + breakdown.processed`, not `added`. A failed or cancelled purchase is not an automatic continuation. The charge is per prospect retrieved, not per prospect added: each retrieved prospect costs 1 credit, including prospects that end up not added (already in prospects, invalid, or over Prospect Capacity). The response comes as soon as the import is accepted, with three ids: the import, the campaign and the list (the new list when `listName` was given).\n\nThe start is refused, and nothing is created or charged:\n- `400`: The request is refused: its query as the preview refuses it (named by its path such as `query.filters[0].values` and, where known, its field and op), a campaign that is not a Prospects campaign (`TARGET_USER`), a list of another campaign, a count above the Prospect Capacity left or the search schema's `limits.resultCeiling`, a balance that does not cover the cost, or a cost that could exceed `maxCreditsSpend`.\n- `403`: The caller cannot update the campaign, the plan is inactive or cannot spend credits, or the `idempotencyKey` belongs to another workspace, user or API key.\n- `404`: The campaign or the list does not exist.\n- `409`: Another import of the campaign owner is still running; wait until it ends, then start again.\n\nOne `idempotencyKey` names one purchase: a retry with the same key returns the original purchase with `replayed: true`; its `campaignId` and `listId` may differ from this request; nothing new is started or charged. After a timeout, a network error, a 5xx or a 408, retry with the same key, since the purchase may already exist under it; after a 429, wait for `Retry-After` and retry with the same key. A 403 saying the `idempotencyKey` belongs to another workspace, user or API key means the key already names a purchase made by another caller: it is not proof that nothing was bought, so retry only with the same API key or user that made it. Any other 4xx means no purchase was created, and a new purchase takes a new key. The result — prospects added and credits charged — is not part of this response; it can be read by the import id once the import ends.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportProspectsRequestDto"}}}},"responses":{"202":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportProspectsResponseDto"}}}},"400":{"description":"The request is refused: its query as the preview refuses it (named by its path such as `query.filters[0].values` and, where known, its field and op), a campaign that is not a Prospects campaign (`TARGET_USER`), a list of another campaign, a count above the Prospect Capacity left or the search schema's `limits.resultCeiling`, a balance that does not cover the cost, or a cost that could exceed `maxCreditsSpend`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}},"403":{"description":"The caller cannot update the campaign, the plan is inactive or cannot spend credits, or the `idempotencyKey` belongs to another workspace, user or API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}},"404":{"description":"The campaign or the list does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}},"409":{"description":"Another import of the campaign owner is still running; wait until it ends, then start again.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Lead Finder"],"security":[{"api-key":[]}]}},"/client/v2/lead-finder/imports/{id}":{"get":{"operationId":"LeadFinderClientApiController_getImportOutcome","summary":"Get Import Outcome","description":"Returns one import: its status, what was asked for and, once the import is terminal, the six numbers that describe what it did. `COMPLETED` means the import ran to the end — it may still have imported nobody, and it was charged for what it retrieved either way. `FAILED` means the import did not complete; `breakdown`, when present, states what was retrieved and charged. `IN_PROGRESS` carries no `breakdown` yet.","parameters":[{"description":"Id of the import, as `importId` in the response of Import Lead Finder Prospects.","required":true,"name":"id","in":"path","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetImportOutcomeResponseDto"}}}},"400":{"description":"`id` is not a UUID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}},"403":{"description":"The import belongs to another workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}},"404":{"description":"No import has this id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Lead Finder"],"security":[{"api-key":[]}]}},"/client/v2/voices":{"get":{"operationId":"VoiceClientApiController_getOwnerList","summary":"List Voices","description":"Returns all Voices owned by the given user, including background about the user and their company, comment and DM tone instructions, and completion counters for Comment Examples, Talking Points, Selling Points and DM Templates, and the accessible campaigns of the current workspace that use each Voice. Related collection contents are not returned here and are managed through separate actions. Background and tone fields remain optional.","parameters":[{"description":"Owner whose Voices to list across workspaces. `workspaceId` controls access and the visible campaign-usage slice, not Voice ownership.","required":true,"name":"id","in":"query","schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetOwnerListResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voices"],"security":[{"api-key":[]}]},"post":{"operationId":"VoiceClientApiController_create","summary":"Create Voice","description":"Creates a new Voice for the given user. Only `name` and `userId` are required — a Voice may be created with just the background group, just the tone group, or neither, and completed later with `update`.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRequestDto3"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateResponseDto3"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voices"],"security":[{"api-key":[]}]}},"/client/v2/voices/{id}":{"get":{"operationId":"VoiceClientApiController_getById","summary":"Get Voice","description":"Loads a single Voice by id with its background, tone texts, collection counts and the accessible campaigns of the current workspace that use it. Collection contents are not included.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetByIdResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voices"],"security":[{"api-key":[]}]},"patch":{"operationId":"VoiceClientApiController_update","summary":"Update Voice","description":"Partially updates an existing Voice. Every field except `id` is optional and only the fields actually present in the request are written — an omitted field keeps its stored value, so updating the background group never clears the tone group and vice versa. Pass an empty string to clear a text field explicitly. Changes take effect immediately — the next comment or direct-message generation uses the updated values.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRequestDto3"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateResponseDto3"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voices"],"security":[{"api-key":[]}]},"delete":{"operationId":"VoiceClientApiController_delete","summary":"Delete Voice","description":"Permanently deletes a Voice. The call fails with a 403 error if any existing Campaign still references this Voice — active or stopped alike. Only hidden or deleted campaigns have their Voice reference cleared automatically. All Comment Examples, Talking Points, Selling Points and DM Templates attached to the Voice are deleted in cascade — you do not need to delete them manually.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteResponseDto4"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voices"],"security":[{"api-key":[]}]}},"/client/v2/voices/{id}/duplicate":{"post":{"operationId":"VoiceClientApiController_duplicate","summary":"Duplicate Voice","description":"Creates an independent Voice with the requested name and copies the source settings and four collections. Existing campaigns keep using the original. Use this to fork a proven Voice and tune the duplicate without changing the original, or to seed another user with the same Voice together with its related collections.","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicateRequestDto2"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicateResponseDto2"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Voices"],"security":[{"api-key":[]}]}},"/client/v2/dm-conversations":{"get":{"operationId":"DmConversationsClientApiController_getList","summary":"List conversations","description":"Lists an owner's LinkedIn conversations in the required inbox view: needs-reply, for-review (For Review), auto, unread, all, snoozed or ended. It returns preview, unread count, active workflow state, and valid next actions without marking anything read.","parameters":[{"description":"LinkedIn account owner whose inbox is being read. Often a managed account rather than the authenticated user — call `user_list-shared` first and pick the owner whose LinkedIn profile holds the conversations.","required":true,"name":"ownerId","in":"query","schema":{"format":"uuid","type":"string"}},{"description":"Required lowercase inbox view. for-review is the For Review tab. Suggested is not accepted.","required":true,"name":"view","in":"query","schema":{"enum":["unread","all","needs-reply","for-review","auto","snoozed","ended"],"type":"string"}},{"description":"Optional campaign filter. When omitted, the list covers all campaigns of the owner that the caller can access — never conversations outside those campaigns.","required":false,"name":"campaignId","in":"query","schema":{"format":"uuid","type":"string"}},{"description":"Optional Prospect List filter.","required":false,"name":"prospectListId","in":"query","schema":{"format":"uuid","type":"string"}},{"description":"Case-insensitive LinkedIn display-name search, not message text. SQL LIKE wildcards `%` and `_` remain active. Omit for no search; null and blank text are invalid.","required":false,"name":"search","in":"query","schema":{"minLength":1,"type":"string"}},{"description":"Number of records requested for this page.","required":false,"name":"limit","in":"query","schema":{"minimum":1,"maximum":50,"default":20,"type":"integer"}},{"description":"Offset from the start of the filtered result set.","required":false,"name":"offset","in":"query","schema":{"minimum":0,"maximum":2147483647,"default":0,"type":"integer"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetListResponseDto7"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Direct Messages"],"security":[{"api-key":[]}]}},"/client/v2/dm-conversations/recommended":{"get":{"operationId":"DmConversationsClientApiController_getRecommendedList","summary":"List recommended conversations","description":"Lists the owner's conversations Extrovert recommends writing to now, newest recommendation first (recommendations without an appearance date last): why each one is recommended, which follow-up is due, the active reply ID and whether that reply is already written and ready for review. Reading never marks anything read and never generates a reply.","parameters":[{"description":"LinkedIn account owner whose conversations are addressed. Often a managed account rather than the authenticated user.","required":true,"name":"ownerId","in":"query","schema":{"format":"uuid","type":"string"}},{"description":"Optional campaign filter. When omitted, the list covers all campaigns of the owner that the caller can access — never conversations outside those campaigns.","required":false,"name":"campaignId","in":"query","schema":{"format":"uuid","type":"string"}},{"description":"Optional Prospect List filter.","required":false,"name":"prospectListId","in":"query","schema":{"format":"uuid","type":"string"}},{"description":"Number of records requested for this page.","required":false,"name":"limit","in":"query","schema":{"minimum":1,"maximum":50,"default":20,"type":"integer"}},{"description":"Offset from the start of the filtered result set.","required":false,"name":"offset","in":"query","schema":{"minimum":0,"maximum":2147483647,"default":0,"type":"integer"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetRecommendedListResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Direct Messages"],"security":[{"api-key":[]}]}},"/client/v2/dm-conversations/{connectionId}":{"get":{"operationId":"DmConversationsClientApiController_get","summary":"Get conversation","description":"Returns one LinkedIn conversation, its unique active reply, and a bounded message-history page. Reading does not clear unread state unless markAsRead is true. Use offset 0 for the latest page and increase it to load older messages.","parameters":[{"description":"Conversation (connection) ID the action addresses.","required":true,"name":"connectionId","in":"path","schema":{"format":"uuid","type":"string"}},{"description":"When true, request that Extrovert and LinkedIn mark the conversation read. Provider synchronization may finish after this response.","required":false,"name":"markAsRead","in":"query","schema":{"default":false,"type":"boolean"}},{"description":"Number of history messages requested for this page.","required":false,"name":"messageLimit","in":"query","schema":{"minimum":1,"maximum":30,"default":30,"type":"integer"}},{"description":"Offset from the newest message. 0 returns the latest page; larger offsets load older messages.","required":false,"name":"messageOffset","in":"query","schema":{"minimum":0,"maximum":2147483647,"default":0,"type":"integer"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetResponseDto4"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Direct Messages"],"security":[{"api-key":[]}]}},"/client/v2/dm-conversations/{connectionId}/replies":{"post":{"operationId":"DmConversationsClientApiController_prepareReply","summary":"Prepare reply","description":"Prepares one reviewable reply for a conversation from the exact supplied text, without Extrovert generation. It returns the exact dmId required for Send reply and never sends in the same call. Text that repeats a message the owner sent in this conversation in the last 24 hours (ignoring extra whitespace) is rejected with a conflict whose message starts with \"Duplicate reply:\", and nothing is prepared.","parameters":[{"name":"connectionId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrepareReplyRequestDto"}}}},"responses":{"200":{"description":"The connection's existing queued draft was promoted in place instead of creating a new reply.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrepareReplyResponseDto"}}}},"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrepareReplyResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Direct Messages"],"security":[{"api-key":[]}]}},"/client/v2/dm-conversations/{connectionId}/generate-or-improve-reply":{"post":{"operationId":"DmConversationsClientApiController_generateOrImproveReply","summary":"Generate or improve reply","description":"Generate creates a reply when none exists or only a queued recommendation exists, or writes a fresh variant of an existing reviewable draft, using the campaign Voice and optional one-off instructions. Improve rewrites an existing reviewable draft with text and requires instructions. Both modes replace the current draft text, including the user's edits, and the replaced text is not kept. Neither mode recovers a failed-send or history-changed draft. One-off instructions never change the Voice. Returns the reply with its exact dmId and text; it never sends. A generation that produces no text is an error, never an empty success.","parameters":[{"name":"connectionId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateOrImproveReplyRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateOrImproveReplyResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Direct Messages"],"security":[{"api-key":[]}]}},"/client/v2/dm-conversations/{connectionId}/snooze":{"post":{"operationId":"DmConversationsClientApiController_snooze","summary":"Snooze conversation","description":"Postpones a conversation until the start of an exact calendar day in the owner's timezone. Until then it is Snoozed: Extrovert recommends and sends nothing in it, and a current attention reason is cleared. A draft the user started keeps its text; an automatic recommendation draft loses its text, including the user's edits. On that day Extrovert may recommend a next step again if the conversation still qualifies. Works whether or not the conversation has a recommendation. Does not send or generate a message.","parameters":[{"name":"connectionId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnoozeRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnoozeResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Direct Messages"],"security":[{"api-key":[]}]}},"/client/v2/dm-conversations/{connectionId}/unskip":{"post":{"operationId":"DmConversationsClientApiController_unskip","summary":"Unskip conversation","description":"Ends Skip forever of a conversation so Extrovert may recommend its next step again. Keeps its snooze date, history, follow-up count and any draft unchanged. Repeating it is safe. Does not send or generate a message.","parameters":[{"name":"connectionId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnskipRequestDto2"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnskipResponseDto2"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Direct Messages"],"security":[{"api-key":[]}]}},"/client/v2/dm-conversations/{connectionId}/skip":{"post":{"operationId":"DmConversationsClientApiController_skip","summary":"Skip conversation forever","description":"Sets Skip forever on a conversation: Extrovert stops recommending, generating and sending anything in it, including planned follow-ups, until it is unskipped. Deletes the current recommendation or draft, if any, and clears the snooze date. Refused while a reply is Sending or Paused, and then nothing changes. Works whether or not the conversation has a recommendation. Does not send or generate a message. Repeating it is safe. A reply the user explicitly prepares and sends still goes out.","parameters":[{"name":"connectionId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkipRequestDto2"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkipResponseDto2"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Direct Messages"],"security":[{"api-key":[]}]}},"/client/v2/dm-conversations/generate-replies":{"post":{"operationId":"DmConversationsClientApiController_generateReplies","summary":"Generate replies","description":"Generates a fresh Extrovert reply for each listed conversation, exactly as Generate does for one. Each conversation is generated on its own and gets its own result in request order — the reply with its dmId and text, or the reason it failed; a failed conversation never hides or undoes the others. Conversations run in parallel, including conversations of the same account. Each generated reply replaces that conversation's current draft text, including the user's edits, and the replaced text is not kept. Batch generation never takes instructions and never improves; nothing is sent. Up to 10 conversations per call.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateRepliesRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateRepliesResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Direct Messages"],"security":[{"api-key":[]}]}},"/client/v2/dm-replies/{dmId}":{"patch":{"operationId":"DmRepliesClientApiController_editReply","summary":"Edit draft","description":"Sets the exact text of an existing unsent reviewable reply, replacing its current draft text; the text Extrovert generated stays stored, but earlier text the user wrote or edited is replaced and not kept. It sends nothing: the reply goes out only through Send reply. Call it again to change the text.","parameters":[{"name":"dmId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditReplyRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditReplyResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Direct Messages"],"security":[{"api-key":[]}]}},"/client/v2/dm-replies/{dmId}/send":{"post":{"operationId":"DmRepliesClientApiController_sendReply","summary":"Send reply","description":"Sends the exact prepared dmId to the LinkedIn prospect. Queued (the default) accepts the reply into the owner's send queue and returns its process ID, not provider confirmation; Extrovert then sends it spaced by the owner's send interval and only inside the owner's Working Hours, with no daily limit. Immediate sends now, outside that spacing and Working Hours, and waits for explicit provider acceptance, not a read receipt. An uncertain immediate outcome may already have sent the reply. History changed leaves the stale reply unsent and refreshes the conversation. A reply whose text repeats a message the owner sent in this conversation in the last 24 hours (ignoring extra whitespace) is never sent: the call fails with a conflict whose message starts with \"Duplicate reply:\", or a queued send ends as History changed with error code duplicate-reply.","parameters":[{"name":"dmId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendReplyRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendReplyResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Direct Messages"],"security":[{"api-key":[]}]}},"/client/v2/dm-replies/{dmId}/recover":{"post":{"operationId":"DmRepliesClientApiController_recoverDraft","summary":"Recover draft","description":"Recovers a failed DM workflow. A generic send failure returns the reply to Draft ready. History changed invalidates the stale reply; use Get conversation, then prepare a new reply before sending. A duplicate-reply error means the same text was already sent: prepare a different reply only if the conversation still needs one.","parameters":[{"name":"dmId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecoverDraftRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecoverDraftResponseDto"}}}},"401":{"description":"Invalid or missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientApiErrorResponseDto"}}}}},"tags":["Direct Messages"],"security":[{"api-key":[]}]}}},"info":{"title":"Extrovert Client API","description":"Public API for Extrovert platform integration. Use your API key for authentication.","version":"1.0","contact":{}},"tags":[],"servers":[{"url":"https://api.goextrovert.com/","description":"API Server"}],"components":{"securitySchemes":{"api-key":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API Key for authentication"}},"schemas":{"ListTeamMembersResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"User ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"User update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"User creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"firstName":{"type":"string","description":"User first name"},"lastName":{"type":"string","description":"User last name"},"name":{"type":"string","description":"Full display name — concatenation of `firstName` and `lastName`, computed on the backend (read-only)."},"linkedInProfile":{"description":"Saved LinkedIn profile data collected when the account was connected (read-only). It may remain after logout, so its presence does not prove a live connection. Current LinkedIn connection status is reported separately.","type":"object","properties":{"id":{"type":"string","description":"LinkedIn profile entity id"},"updatedAt":{"type":"string","description":"LinkedIn profile update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"LinkedIn profile creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Name from the LinkedIn profile (scraped; not user-editable in Extrovert)."},"email":{"type":"string","description":"Email used to log in to LinkedIn (may differ from the Extrovert account email)."},"avatarUrl":{"description":"LinkedIn profile avatar URL.","type":"string"},"linkedInUrl":{"description":"Public LinkedIn profile URL.","type":"string"}},"required":["id","updatedAt","createdAt","name","email"]},"selectedWorkspaceSettings":{"description":"The current user's member record in the currently selected team (role, creator flag, registrationType, LinkedIn-connected flag). `id` here is the member-record id and `user.id` is the user id; the team id itself is not part of this object.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Team member record id.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Member record update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Member record creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"user":{"description":"Reference to the user this member record belongs to — carries only `id` and `name`. Fetch the full user record separately if needed. May be missing if the user was removed.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},"role":{"type":"string","enum":["MEMBER","MANAGER","ADMIN"],"description":"The member's role in the team."},"isCreator":{"type":"boolean","description":"Whether this member holds a creator seat: may own campaigns. Not only the team founder."},"isLinkedInProfileConnected":{"type":"boolean","description":"Whether this member has a valid LinkedIn account connected. Can only be `true` for a member with a creator seat (and only when the profile is actually linked and valid)."},"registrationType":{"type":"string","enum":["NEW_USER_SIGNUP","NEW_USER_WORKSPACE_INVITE_CONFIRM","SUB_USER"],"description":"How this member entered the system. `NEW_USER_SIGNUP` — signed up themselves; `NEW_USER_WORKSPACE_INVITE_CONFIRM` — accepted a team invite; `SUB_USER` — created as a managed account by another user."},"onboardingState":{"type":"string","enum":["IN_PROGRESS","POSTPONED","COMPLETED","SKIPPED"],"description":"AI assistant onboarding progress. `IN_PROGRESS` — user is going through onboarding; `POSTPONED` — user dismissed onboarding temporarily; `COMPLETED` — onboarding finished; `SKIPPED` — user opted out."},"onboardingDate":{"type":"string","description":"ISO timestamp when `onboardingState` was last updated.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}},"required":["id","updatedAt","createdAt","role","isCreator","isLinkedInProfileConnected","registrationType","onboardingState","onboardingDate"]},"isDmHistorySynced":{"type":"boolean","description":"When an account is connected, Extrovert syncs its DMs. Can take several hours. Until this becomes `true`, the AI-DMs unibox is not functional."},"onboardingState":{"type":"string","enum":["IN_PROGRESS","POSTPONED","COMPLETED","SKIPPED"],"description":"AI assistant onboarding progress. `IN_PROGRESS` — user is going through onboarding; `POSTPONED` — user dismissed onboarding temporarily; `COMPLETED` — onboarding finished; `SKIPPED` — user opted out."},"onboardingDate":{"type":"string","description":"ISO timestamp when `onboardingState` was last updated.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"linkedinUrl":{"description":"User-provided LinkedIn profile URL stored at signup or profile update (distinct from scraped `linkedInProfile.linkedInUrl`).","type":"string"},"timezone":{"description":"IANA timezone of the user's work schedule; the Dashboard computes statistics in it. Returned by the profile and the team-member list.","examples":["Europe/Paris"],"type":"string"}},"required":["id","updatedAt","createdAt","firstName","lastName","name","isDmHistorySynced","onboardingState","onboardingDate"]},"description":"Users of the current user's team"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"ClientApiErrorResponseDto":{"type":"object","properties":{"status":{"type":"string","description":"Response status","example":"error","enum":["error"]},"data":{"type":"null","description":"Response data","example":null},"message":{"type":"string","description":"Error message","example":"An error occurred while processing the request"}},"required":["status","data"]},"GetLinkedinStatusResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"ownerId":{"type":"string","format":"uuid","description":"Id of the LinkedIn account (user) whose settings are read or changed."},"connectionStatus":{"type":"string","enum":["NOT_CONNECTED","CONNECTING","VERIFICATION_REQUIRED","CONNECTED","ERROR"],"description":"`CONNECTED` — LinkedIn is connected and working. `NOT_CONNECTED` — no LinkedIn account was connected. `CONNECTING` — a connection was requested and is still running. `VERIFICATION_REQUIRED` — LinkedIn asked for a verification code that has to be entered in the app. `ERROR` — the last login failed or LinkedIn ended the session; the account has to be reconnected in the app."},"salesNavigatorStatus":{"description":"Sales Navigator of the connected account: `CONNECTED` or `DISCONNECTED`; absent when unknown or the account has none.","type":"string","enum":["CONNECTED","DISCONNECTED"]},"isReconnectInProgress":{"type":"boolean","description":"Whether a reconnect of the connected account is still running."},"isLogoutInProgress":{"type":"boolean","description":"Whether a logout of the connected account is still running."},"runtimeStatus":{"type":"object","properties":{"isOutsideWorkingHours":{"type":"boolean","description":"Whether this owner is currently outside the scheduler's working window."},"actions":{"type":"array","items":{"type":"object","properties":{"actionGroup":{"type":"string","enum":["COMMENTS","REACTIONS","CONNECTION_REQUESTS"]},"dailyLimitReached":{"type":"boolean","description":"True only for a fresh exhausted-limit observation. False does not guarantee sending is available; reads never recalculate usage."},"dailyLimitObservedAt":{"description":"ISO timestamp of the existing scheduler check.","type":"string"},"dailyLimitValidUntil":{"description":"ISO expiry of that observation; an expired indicator no longer applies.","type":"string"},"backoffUntil":{"description":"Actual active scheduler lock expiry for this action group, in ISO format.","type":"string"}},"required":["actionGroup","dailyLimitReached"]}}},"required":["isOutsideWorkingHours","actions"]}},"required":["ownerId","connectionStatus","isReconnectInProgress","isLogoutInProgress"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetDailyLimitsResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"commentsPerDay":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Comments posted per day, 0–100. The actual number varies by about ±3 a day to mimic natural activity."},"reactionsPerDay":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Reactions to posts per day, 0–100. The actual number varies by about ±3 a day."},"connectionRequestsPerDay":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Connection requests sent per day, 0–50. The actual number varies by about ±3 a day."},"withdrawUserConnections":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Unaccepted connection requests withdrawn per day by the campaigns that withdraw them, 1–50. The actual number varies by about ±3 a day."}},"required":["commentsPerDay","reactionsPerDay","connectionRequestsPerDay","withdrawUserConnections"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"UpdateDailyLimitsRequestDto":{"type":"object","properties":{"ownerId":{"type":"string","format":"uuid","description":"Extrovert user ID, not the LinkedIn-profile or membership-record ID. You may manage your own account; another account requires account-management permission and a creator seat in this workspace. Campaign sharing alone is not enough."},"commentsPerDay":{"type":"integer","minimum":0,"maximum":100,"description":"Comments posted per day, 0–100. Configured daily action limit, not used or remaining actions. The comment, reaction and connection-request limits are required and replaced together; internal crawl/DM limits are retained. Scheduling applies daily variation with a minimum threshold of 1; 0 is neither a guaranteed pause nor unlimited."},"reactionsPerDay":{"type":"integer","minimum":0,"maximum":100,"description":"Reactions to posts per day, 0–100. Configured daily action limit, not used or remaining actions. The comment, reaction and connection-request limits are required and replaced together; internal crawl/DM limits are retained. Scheduling applies daily variation with a minimum threshold of 1; 0 is neither a guaranteed pause nor unlimited."},"connectionRequestsPerDay":{"type":"integer","minimum":0,"maximum":50,"description":"Connection requests sent per day, 0–50. Configured daily action limit, not used or remaining actions. The comment, reaction and connection-request limits are required and replaced together; internal crawl/DM limits are retained. Scheduling applies daily variation with a minimum threshold of 1; 0 is neither a guaranteed pause nor unlimited."},"withdrawUserConnections":{"type":"integer","description":"Unaccepted connection requests withdrawn per day, 1–50. Configured limit, not used or remaining actions; omitted keeps the stored value. Withdrawal is switched off per campaign, not with this limit.","minimum":1,"maximum":50}},"required":["ownerId","commentsPerDay","reactionsPerDay","connectionRequestsPerDay"]},"UpdateDailyLimitsResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"commentsPerDay":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Comments posted per day, 0–100. The actual number varies by about ±3 a day to mimic natural activity."},"reactionsPerDay":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Reactions to posts per day, 0–100. The actual number varies by about ±3 a day."},"connectionRequestsPerDay":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Connection requests sent per day, 0–50. The actual number varies by about ±3 a day."},"withdrawUserConnections":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Unaccepted connection requests withdrawn per day by the campaigns that withdraw them, 1–50. The actual number varies by about ±3 a day."}},"required":["commentsPerDay","reactionsPerDay","connectionRequestsPerDay","withdrawUserConnections"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetWorkingHoursResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"workTimeFromMinMonday":{"type":"integer","minimum":0,"maximum":1439,"description":"Monday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinMonday":{"type":"integer","minimum":0,"maximum":1439,"description":"Monday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"workTimeFromMinTuesday":{"type":"integer","minimum":0,"maximum":1439,"description":"Tuesday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinTuesday":{"type":"integer","minimum":0,"maximum":1439,"description":"Tuesday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"workTimeFromMinWednesday":{"type":"integer","minimum":0,"maximum":1439,"description":"Wednesday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinWednesday":{"type":"integer","minimum":0,"maximum":1439,"description":"Wednesday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"workTimeFromMinThursday":{"type":"integer","minimum":0,"maximum":1439,"description":"Thursday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinThursday":{"type":"integer","minimum":0,"maximum":1439,"description":"Thursday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"workTimeFromMinFriday":{"type":"integer","minimum":0,"maximum":1439,"description":"Friday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinFriday":{"type":"integer","minimum":0,"maximum":1439,"description":"Friday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"workTimeFromMinSaturday":{"type":"integer","minimum":0,"maximum":1439,"description":"Saturday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinSaturday":{"type":"integer","minimum":0,"maximum":1439,"description":"Saturday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"workTimeFromMinSunday":{"type":"integer","minimum":0,"maximum":1439,"description":"Sunday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinSunday":{"type":"integer","minimum":0,"maximum":1439,"description":"Sunday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"timezone":{"type":"string","minLength":1,"description":"IANA timezone the working windows are read in. An unknown timezone is refused with 400.","examples":["Europe/Berlin","America/New_York"]}},"required":["timezone"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"UpdateWorkingHoursRequestDto":{"type":"object","properties":{"ownerId":{"type":"string","format":"uuid","description":"Extrovert user ID, not the LinkedIn-profile or membership-record ID. You may manage your own account; another account requires account-management permission and a creator seat in this workspace. Campaign sharing alone is not enough."},"workTimeFromMinMonday":{"type":"integer","minimum":0,"maximum":1439,"description":"Monday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinMonday":{"type":"integer","minimum":0,"maximum":1439,"description":"Monday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"workTimeFromMinTuesday":{"type":"integer","minimum":0,"maximum":1439,"description":"Tuesday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinTuesday":{"type":"integer","minimum":0,"maximum":1439,"description":"Tuesday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"workTimeFromMinWednesday":{"type":"integer","minimum":0,"maximum":1439,"description":"Wednesday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinWednesday":{"type":"integer","minimum":0,"maximum":1439,"description":"Wednesday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"workTimeFromMinThursday":{"type":"integer","minimum":0,"maximum":1439,"description":"Thursday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinThursday":{"type":"integer","minimum":0,"maximum":1439,"description":"Thursday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"workTimeFromMinFriday":{"type":"integer","minimum":0,"maximum":1439,"description":"Friday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinFriday":{"type":"integer","minimum":0,"maximum":1439,"description":"Friday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"workTimeFromMinSaturday":{"type":"integer","minimum":0,"maximum":1439,"description":"Saturday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinSaturday":{"type":"integer","minimum":0,"maximum":1439,"description":"Saturday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"workTimeFromMinSunday":{"type":"integer","minimum":0,"maximum":1439,"description":"Sunday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinSunday":{"type":"integer","minimum":0,"maximum":1439,"description":"Sunday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"timezone":{"type":"string","minLength":1,"description":"IANA timezone the working windows are read in. An unknown timezone is refused with 400.","examples":["Europe/Berlin","America/New_York"]}},"required":["ownerId","timezone"],"dependentRequired":{"workTimeFromMinMonday":["workTimeToMinMonday"],"workTimeToMinMonday":["workTimeFromMinMonday"],"workTimeFromMinTuesday":["workTimeToMinTuesday"],"workTimeToMinTuesday":["workTimeFromMinTuesday"],"workTimeFromMinWednesday":["workTimeToMinWednesday"],"workTimeToMinWednesday":["workTimeFromMinWednesday"],"workTimeFromMinThursday":["workTimeToMinThursday"],"workTimeToMinThursday":["workTimeFromMinThursday"],"workTimeFromMinFriday":["workTimeToMinFriday"],"workTimeToMinFriday":["workTimeFromMinFriday"],"workTimeFromMinSaturday":["workTimeToMinSaturday"],"workTimeToMinSaturday":["workTimeFromMinSaturday"],"workTimeFromMinSunday":["workTimeToMinSunday"],"workTimeToMinSunday":["workTimeFromMinSunday"]}},"UpdateWorkingHoursResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"workTimeFromMinMonday":{"type":"integer","minimum":0,"maximum":1439,"description":"Monday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinMonday":{"type":"integer","minimum":0,"maximum":1439,"description":"Monday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"workTimeFromMinTuesday":{"type":"integer","minimum":0,"maximum":1439,"description":"Tuesday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinTuesday":{"type":"integer","minimum":0,"maximum":1439,"description":"Tuesday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"workTimeFromMinWednesday":{"type":"integer","minimum":0,"maximum":1439,"description":"Wednesday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinWednesday":{"type":"integer","minimum":0,"maximum":1439,"description":"Wednesday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"workTimeFromMinThursday":{"type":"integer","minimum":0,"maximum":1439,"description":"Thursday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinThursday":{"type":"integer","minimum":0,"maximum":1439,"description":"Thursday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"workTimeFromMinFriday":{"type":"integer","minimum":0,"maximum":1439,"description":"Friday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinFriday":{"type":"integer","minimum":0,"maximum":1439,"description":"Friday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"workTimeFromMinSaturday":{"type":"integer","minimum":0,"maximum":1439,"description":"Saturday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinSaturday":{"type":"integer","minimum":0,"maximum":1439,"description":"Saturday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"workTimeFromMinSunday":{"type":"integer","minimum":0,"maximum":1439,"description":"Sunday: start of the working window, minutes from midnight in `timezone` (0–1439). Sent together with the matching end; both absent means no work that day."},"workTimeToMinSunday":{"type":"integer","minimum":0,"maximum":1439,"description":"Sunday: end of the working window, minutes from midnight in `timezone` (0–1439), not before the start."},"timezone":{"type":"string","minLength":1,"description":"IANA timezone the working windows are read in. An unknown timezone is refused with 400.","examples":["Europe/Berlin","America/New_York"]}},"required":["timezone"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetCurrentPlanFeaturesResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"planName":{"type":"string","enum":["NO_PLAN","TRIAL","FREE","FREE_LIGHT","FREE_BUSINESS","FREE_PRO","FREE_SCALE","LIGHT","BUSINESS","SCALE","PRO_25","LIGHT_2025","BUSINESS_2025","PRO_2025","FULL","LEGACY_LIGHT"],"description":"Current plan technical name. `NO_PLAN` means no plan."},"isPlanActive":{"type":"boolean","description":"`true` when the workspace's plan is currently active (paid/trial plan in good standing, not expired). When `false`, `features` and `counters` are empty."},"features":{"type":"array","items":{"type":"string","enum":["CAN_CONNECT_LINKED_IN_PROFILE","CAN_START_CAMPAIGN","CAMPAIGN_COUNT_PER_USER","CAN_MANAGE_CAMPAIGN_SHARED_USERS","CAN_MANAGE_DELAYED_POSTING","CAN_FILTER_POSTS_BY_RELEVANT_TAGS","CAN_OBTAIN_KEYWORD_POSTS_WITHOUT_RESTRICTIONS","MAX_KEYWORDS_PER_USER","CAN_USE_TOPIC_CAMPAIGNS","RELEVANT_POST_TAGS_COUNT_PER_USER","VOICE_COUNT_PER_USER","COMMENT_EXAMPLES_COUNT_PER_VOICE","TALKING_POINTS_COUNT_PER_VOICE","SELLING_POINTS_COUNT_PER_VOICE","DM_TEMPLATES_COUNT_PER_VOICE","LEADS_COUNT_PER_USER","LEAD_LISTS_COUNT_PER_CAMPAIGN","MONTHLY_LEADS_ENRICH_COUNT_PER_USER","CAN_OBTAIN_REACTIONS","CAN_READ_DRAFT_RESPONSE","CAN_REGENERATE_DRAFT_RESPONSE","CAN_READ_NEED_TO_FOLLOW_UP_CONNECTIONS","CAN_USE_DIRECT_MESSAGES","CAN_INVITE_WORKSPACE_MEMBERS","CAN_MANAGE_SUB_USERS","CAN_USE_CREDITS","CAN_USE_API","CAN_MANAGE_WEBHOOKS"]},"description":"Boolean capability flags granted by the current plan. Each value is one of the boolean-style `PlanLimitationName` members; counter-style limitations appear in `counters` instead. A flag absent here means the corresponding feature is not granted by the plan. `CAN_OBTAIN_KEYWORD_POSTS_WITHOUT_RESTRICTIONS` is a legacy flag of the removed one-post-per-keyword-per-day limit that still affects part of the app's UI; it grants no Topic campaign access and no Topic Capacity."},"counters":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","enum":["CAN_CONNECT_LINKED_IN_PROFILE","CAN_START_CAMPAIGN","CAMPAIGN_COUNT_PER_USER","CAN_MANAGE_CAMPAIGN_SHARED_USERS","CAN_MANAGE_DELAYED_POSTING","CAN_FILTER_POSTS_BY_RELEVANT_TAGS","CAN_OBTAIN_KEYWORD_POSTS_WITHOUT_RESTRICTIONS","MAX_KEYWORDS_PER_USER","CAN_USE_TOPIC_CAMPAIGNS","RELEVANT_POST_TAGS_COUNT_PER_USER","VOICE_COUNT_PER_USER","COMMENT_EXAMPLES_COUNT_PER_VOICE","TALKING_POINTS_COUNT_PER_VOICE","SELLING_POINTS_COUNT_PER_VOICE","DM_TEMPLATES_COUNT_PER_VOICE","LEADS_COUNT_PER_USER","LEAD_LISTS_COUNT_PER_CAMPAIGN","MONTHLY_LEADS_ENRICH_COUNT_PER_USER","CAN_OBTAIN_REACTIONS","CAN_READ_DRAFT_RESPONSE","CAN_REGENERATE_DRAFT_RESPONSE","CAN_READ_NEED_TO_FOLLOW_UP_CONNECTIONS","CAN_USE_DIRECT_MESSAGES","CAN_INVITE_WORKSPACE_MEMBERS","CAN_MANAGE_SUB_USERS","CAN_USE_CREDITS","CAN_USE_API","CAN_MANAGE_WEBHOOKS"],"description":"Counter-style `PlanLimitationName` member identifying which quota this entry caps (e.g. `CAMPAIGN_COUNT_PER_USER`, `VOICE_COUNT_PER_USER`)."},"max":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Effective maximum for this counter on the workspace's current plan. The sentinel value `2147483647` means 'unlimited' — check the sibling `isUnlimited` flag for an explicit boolean."},"isUnlimited":{"type":"boolean","description":"`true` when the plan grants an unlimited counter on this limitation."}},"required":["name","max","isUnlimited"]},"description":"Numeric quotas granted by the current plan, each with its effective `max` and `isUnlimited` flag. Only counters granted by the plan appear here — a counter not in the list is not granted. Prospect and topic volumes are not plan counters: they are workspace Capacity pools and are reported by the workspace capacity action instead."}},"description":"Capabilities granted by the workspace's current plan.","required":["planName","isPlanActive","features","counters"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetCapacityResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"planState":{"type":"string","enum":["TRIAL","FREE","FULL","INACTIVE"],"description":"Plan state the pools were resolved under. `TRIAL` states its limits per campaign owner; `FREE` and `FULL` state them for the whole workspace; `INACTIVE` means an expired or missing plan, which admits nothing while reads and clean-up keep working."},"pools":{"type":"array","items":{"type":"object","properties":{"pool":{"type":"string","enum":["PROSPECT","TOPIC"],"description":"Which pool this entry reports. `PROSPECT` counts visible direct prospects; `TOPIC` counts topics attached to a visible topic campaign. The pools are independent — an operation must fit its own."},"used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Units of this pool the workspace occupies right now. Identical for every member of the workspace."},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Units this workspace may occupy. It is the cap new positive actions are admitted against, so a planned reduction lowers it while everything already stored is kept."},"available":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Units still free — `total - used`, never below zero."},"isOverLimit":{"type":"boolean","description":"`true` when `used` already exceeds `total`. Nothing is removed, hidden or trimmed because of it; only further positive actions on this pool are refused until room is freed."}},"required":["pool","used","total","available","isOverLimit"]},"description":"Both Capacity pools of the workspace."}},"description":"Capacity pools of the workspace and the plan state they were resolved under.","required":["planState","pools"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetCommentingResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"period":{"type":"object","properties":{"startDate":{"type":"string","description":"First calendar day of the period, included, `YYYY-MM-DD`."},"endDate":{"type":"string","description":"Last calendar day of the period, included, `YYYY-MM-DD`."},"timezone":{"type":"string","description":"IANA timezone the period was computed in."},"daysCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Number of calendar days in the period."}},"required":["startDate","endDate","timezone","daysCount"],"description":"The validated period the values were computed for."},"postedComments":{"description":"Comments posted in the period, with the comparison to the preceding range.","type":"object","properties":{"currentIntervalValue":{"type":"number","description":"Value for the period."},"changePercentVsPreviousPeriod":{"type":"number","description":"Percent change of `currentIntervalValue` against the preceding range of the same number of days (e.g. `-50` is half, `100` is double) — a change, not the preceding value itself. `0` both when nothing changed and when the preceding range had nothing."}},"required":["currentIntervalValue","changePercentVsPreviousPeriod"]},"postedCommentsPerDayAverage":{"description":"Comments posted per day: the period total divided by its number of days, with the comparison to the preceding range.","type":"object","properties":{"currentIntervalValue":{"type":"number","description":"Value for the period."},"changePercentVsPreviousPeriod":{"type":"number","description":"Percent change of `currentIntervalValue` against the preceding range of the same number of days (e.g. `-50` is half, `100` is double) — a change, not the preceding value itself. `0` both when nothing changed and when the preceding range had nothing."}},"required":["currentIntervalValue","changePercentVsPreviousPeriod"]},"dailyStatisticsList":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Calendar day, `YYYY-MM-DD`."},"pendingPostsCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Approved comments waiting to be posted, counted on the day they were approved. Pending counts approved actions waiting right now to be published or sent whose date lies in the period; actions still waiting for approval are not included, and it is not the historical size of the queue on that day."},"respondedPostsCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Comments posted on this day."}},"required":["date","pendingPostsCount","respondedPostsCount"]},"description":"One item per calendar day of the period, days without activity included."}},"description":"Commenting section for the period","required":["dailyStatisticsList"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetConnectionsResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"period":{"type":"object","properties":{"startDate":{"type":"string","description":"First calendar day of the period, included, `YYYY-MM-DD`."},"endDate":{"type":"string","description":"Last calendar day of the period, included, `YYYY-MM-DD`."},"timezone":{"type":"string","description":"IANA timezone the period was computed in."},"daysCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Number of calendar days in the period."}},"required":["startDate","endDate","timezone","daysCount"],"description":"The validated period the values were computed for."},"connectionRequestsSent":{"description":"Connection requests sent in the period, with the comparison to the preceding range.","type":"object","properties":{"currentIntervalValue":{"type":"number","description":"Value for the period."},"changePercentVsPreviousPeriod":{"type":"number","description":"Percent change of `currentIntervalValue` against the preceding range of the same number of days (e.g. `-50` is half, `100` is double) — a change, not the preceding value itself. `0` both when nothing changed and when the preceding range had nothing."}},"required":["currentIntervalValue","changePercentVsPreviousPeriod"]},"dailyStatisticsList":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Calendar day, `YYYY-MM-DD`."},"sentCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Connection requests sent on this day."},"acceptedCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Connection requests accepted on this day, counted by the day of acceptance whatever day the request was sent; not a subset of `sentCount`."}},"required":["date","sentCount","acceptedCount"]},"description":"One item per calendar day of the period, days without activity included."},"acceptanceRate":{"description":"All time: connection acceptance rate, not bound to the period.","type":"object","properties":{"totalRate":{"description":"Rate over all requests.","type":"object","properties":{"sentCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Connection requests sent, all time."},"acceptedCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Of those, requests accepted, all time."},"acceptanceRate":{"type":"number","description":"`acceptedCount / sentCount` in percent (0–100), all time."}},"required":["sentCount","acceptedCount","acceptanceRate"]},"perReasonRate":{"type":"array","items":{"type":"object","properties":{"reason":{"type":"string","enum":["DIRECT_COMMENTS","INDIRECT_COMMENTS","NO_COMMENTS"],"description":"Rule the requests were sent under."},"rate":{"type":"object","properties":{"sentCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Connection requests sent, all time."},"acceptedCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Of those, requests accepted, all time."},"acceptanceRate":{"type":"number","description":"`acceptedCount / sentCount` in percent (0–100), all time."}},"required":["sentCount","acceptedCount","acceptanceRate"]}},"required":["reason"]},"description":"Rate per rule the requests were sent under."}},"required":["perReasonRate"]}},"description":"Connections section for the period","required":["dailyStatisticsList"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetDirectMessagesResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"period":{"type":"object","properties":{"startDate":{"type":"string","description":"First calendar day of the period, included, `YYYY-MM-DD`."},"endDate":{"type":"string","description":"Last calendar day of the period, included, `YYYY-MM-DD`."},"timezone":{"type":"string","description":"IANA timezone the period was computed in."},"daysCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Number of calendar days in the period."}},"required":["startDate","endDate","timezone","daysCount"],"description":"The validated period the values were computed for."},"sentDmCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Direct messages sent in the period."},"dailyStatisticsList":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Calendar day, `YYYY-MM-DD`."},"pendingDmCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Approved direct messages waiting to be sent, counted on the day the message was created. Pending counts approved actions waiting right now to be published or sent whose date lies in the period; actions still waiting for approval are not included, and it is not the historical size of the queue on that day."},"sentDmCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Direct messages sent on this day."}},"required":["date","pendingDmCount","sentDmCount"]},"description":"One item per calendar day of the period, days without activity included."},"replyRate":{"description":"All time: direct message reply rate, not bound to the period.","type":"object","properties":{"replyRate":{"type":"number","description":"`repliedConversationsCount / conversationsWithSentMessage` in percent (0–100), all time."},"conversationsWithSentMessage":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Conversations with at least one sent message, all time."},"repliedConversationsCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Of those, conversations the prospect replied in, all time."}},"required":["replyRate","conversationsWithSentMessage","repliedConversationsCount"]}},"description":"Direct Messages section for the period","required":["sentDmCount","dailyStatisticsList"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetCampaignListsResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Prospect list ID","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]},"updatedAt":{"type":"string","description":"Prospect list update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Prospect list creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Prospect list name"},"campaignId":{"type":"string","format":"uuid","description":"Parent campaign ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"prospectsTotal":{"type":"number","description":"Total prospects in the list"},"isDeleted":{"type":"boolean","description":"Whether the prospect list has been deleted. Deleted lists are not usable and should be treated as removed."}},"required":["id","updatedAt","createdAt","name","campaignId","prospectsTotal","isDeleted"]},"description":"Prospect lists attached to the requested campaign"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetOneListResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","description":"Loaded prospect list","properties":{"id":{"type":"string","format":"uuid","description":"Prospect list ID","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]},"updatedAt":{"type":"string","description":"Prospect list update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Prospect list creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Prospect list name"},"campaignId":{"type":"string","format":"uuid","description":"Parent campaign ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"prospectsTotal":{"type":"number","description":"Total prospects in the list"},"isDeleted":{"type":"boolean","description":"Whether the prospect list has been deleted. Deleted lists are not usable and should be treated as removed."}},"required":["id","updatedAt","createdAt","name","campaignId","prospectsTotal","isDeleted"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"CreateListRequestDto":{"type":"object","properties":{"listName":{"type":"string","minLength":1,"description":"Human-readable list name."},"campaignId":{"type":"string","format":"uuid","description":"Use a non-deleted Prospects campaign as the destination. Capacity is normally workspace-wide, but a trial pool with a non-null `perOwnerCeiling` is measured for this campaign owner. An active plan is required; a new list also needs a free prospect-list slot in that campaign."},"userUrls":{"type":"array","minItems":1,"maxItems":1000,"items":{"type":"string","minLength":1},"description":"LinkedIn profile URLs to seed the list with."},"moveOwnDuplicated":{"type":"boolean","description":"For an active duplicate owned by the destination campaign owner, `true` moves the existing prospect record into this list and `false` skips it into `existedUrlsMap`. Same-list duplicates are skipped silently; deleted same-owner records are reactivated. Teammate duplicates are searched and skipped only when the destination campaign has `skipTeammatesLeads` enabled; this is not global team-wide deduplication."},"shouldBeDeletedIfInactive":{"type":"boolean","description":"If `true`, auto-remove prospects who have no posts on LinkedIn within the last 30 days (checked once, when the backend first pulls their posts). If `false`, keep them regardless of recent posting activity. Useful for pruning low-signal prospects on create."}},"required":["listName","campaignId","userUrls","moveOwnDuplicated","shouldBeDeletedIfInactive"],"description":"URL admission precedes asynchronous profile verification. Check `submittedUrls`, `validationRejectedUrls`, `existedUrlsMap` and `outOfLimitUrls`. With at least one accepted URL, partial success is returned; if none are accepted, including a wholly out-of-capacity batch, the default flow fails rather than returning empty success."},"CreateListResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"listId":{"type":"string","format":"uuid","description":"Created or updated prospect list ID","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]},"submittedUrls":{"type":"array","items":{"type":"string"},"description":"URLs submitted in this request"},"validationRejectedUrls":{"type":"array","items":{"type":"string"},"description":"URLs rejected by validation"},"existedUrlsMap":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"campaignName":{"type":"string","description":"Campaign name where duplicate prospects already exist"},"urls":{"type":"array","items":{"type":"string"},"description":"Duplicate LinkedIn profile URLs already present in that campaign"}},"required":["campaignName","urls"]},"description":"Duplicates grouped by campaign: the key is the ID of the campaign where the duplicate already exists; the value holds the campaign name and the list of already-existing URLs."},"outOfLimitUrls":{"type":"array","items":{"type":"string"},"description":"URLs that did not fit the workspace Prospect Capacity. The rest of the request is still applied — the operation is never rejected as a whole for this reason."},"totalUrlsLimit":{"type":"number","description":"Prospect Capacity of the whole workspace — the total the submitted URLs were measured against, not a per-user quota"}},"description":"Detailed result of the create-list operation","required":["listId","submittedUrls","validationRejectedUrls","existedUrlsMap","outOfLimitUrls","totalUrlsLimit"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"CreateEmptyListRequestDto":{"type":"object","properties":{"listName":{"type":"string","minLength":1,"description":"Human-readable list name."},"campaignId":{"type":"string","format":"uuid","description":"Non-deleted Prospects campaign the list is created in. An active plan and a free prospect-list slot in that campaign are required."}},"required":["listName","campaignId"]},"CreateEmptyListResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","description":"Created prospect list","properties":{"id":{"type":"string","format":"uuid","description":"Prospect list ID","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]},"updatedAt":{"type":"string","description":"Prospect list update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Prospect list creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Prospect list name"},"campaignId":{"type":"string","format":"uuid","description":"Parent campaign ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"prospectsTotal":{"type":"number","description":"Total prospects in the list"},"isDeleted":{"type":"boolean","description":"Whether the prospect list has been deleted. Deleted lists are not usable and should be treated as removed."}},"required":["id","updatedAt","createdAt","name","campaignId","prospectsTotal","isDeleted"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"CountInactiveRequestDto":{"type":"object","properties":{"campaignIds":{"type":"array","description":"Optional campaign IDs. Non-empty restricts this dimension; omitted or `[]` does not. Non-empty `campaignIds` and `listIds` intersect. Omitting or emptying both targets all reachable Prospects campaigns in the selected workspace for an MCP user; an API key must provide explicit scope.","maxItems":1000,"items":{"type":"string","format":"uuid"}},"listIds":{"type":"array","description":"Optional prospect-list IDs. Non-empty restricts this dimension; omitted or `[]` does not. Non-empty `listIds` and `campaignIds` intersect. Omitting or emptying both targets all reachable Prospects campaigns in the selected workspace for an MCP user; an API key must provide explicit scope.","maxItems":1000,"items":{"type":"string","format":"uuid"}}},"description":"Inactive means a non-deleted direct LEAD whose newest saved fetched-post date is over 30 days old, or with no saved post date after at least one successful fetch. Never-successfully-synced prospects are not confirmed inactive. Preview and delete must use the same scope; preview is a snapshot, not a reservation."},"CountInactiveResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"count":{"type":"number","description":"Number of prospects in the requested scope that are currently inactive."}},"required":["count"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"DeleteInactiveRequestDto":{"type":"object","properties":{"campaignIds":{"type":"array","description":"Optional campaign IDs. Non-empty restricts this dimension; omitted or `[]` does not. Non-empty `campaignIds` and `listIds` intersect. Omitting or emptying both targets all reachable Prospects campaigns in the selected workspace for an MCP user; an API key must provide explicit scope.","maxItems":1000,"items":{"type":"string","format":"uuid"}},"listIds":{"type":"array","description":"Optional prospect-list IDs. Non-empty restricts this dimension; omitted or `[]` does not. Non-empty `listIds` and `campaignIds` intersect. Omitting or emptying both targets all reachable Prospects campaigns in the selected workspace for an MCP user; an API key must provide explicit scope.","maxItems":1000,"items":{"type":"string","format":"uuid"}}},"description":"Inactive means a non-deleted direct LEAD whose newest saved fetched-post date is over 30 days old, or with no saved post date after at least one successful fetch. Never-successfully-synced prospects are not confirmed inactive. Preview and delete must use the same scope; preview is a snapshot, not a reservation."},"DeleteInactiveResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"AddUsersToListRequestDto":{"type":"object","properties":{"listId":{"type":"string","format":"uuid","description":"Prospect list id to add URLs to."},"userUrls":{"type":"array","minItems":1,"maxItems":1000,"items":{"type":"string","minLength":1},"description":"LinkedIn profile URLs to add."},"moveOwnDuplicated":{"type":"boolean","description":"For an active duplicate owned by the destination campaign owner, `true` moves the existing prospect record into this list and `false` skips it into `existedUrlsMap`. Same-list duplicates are skipped silently; deleted same-owner records are reactivated. Teammate duplicates are searched and skipped only when the destination campaign has `skipTeammatesLeads` enabled; this is not global team-wide deduplication."},"shouldBeDeletedIfInactive":{"type":"boolean","description":"If `true`, auto-remove prospects who have no posts on LinkedIn within the last 30 days (checked once, when the backend first pulls their posts). If `false`, keep them regardless of recent posting activity."}},"required":["listId","userUrls","moveOwnDuplicated","shouldBeDeletedIfInactive"],"description":"URL admission precedes asynchronous profile verification. Check `submittedUrls`, `validationRejectedUrls`, `existedUrlsMap` and `outOfLimitUrls`. With at least one accepted URL, partial success is returned; if none are accepted, including a wholly out-of-capacity batch, the default flow fails rather than returning empty success."},"AddUsersToListResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"listId":{"type":"string","format":"uuid","description":"Created or updated prospect list ID","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]},"submittedUrls":{"type":"array","items":{"type":"string"},"description":"URLs submitted in this request"},"validationRejectedUrls":{"type":"array","items":{"type":"string"},"description":"URLs rejected by validation"},"existedUrlsMap":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"campaignName":{"type":"string","description":"Campaign name where duplicate prospects already exist"},"urls":{"type":"array","items":{"type":"string"},"description":"Duplicate LinkedIn profile URLs already present in that campaign"}},"required":["campaignName","urls"]},"description":"Duplicates grouped by campaign: the key is the ID of the campaign where the duplicate already exists; the value holds the campaign name and the list of already-existing URLs."},"outOfLimitUrls":{"type":"array","items":{"type":"string"},"description":"URLs that did not fit the workspace Prospect Capacity. The rest of the request is still applied — the operation is never rejected as a whole for this reason."},"totalUrlsLimit":{"type":"number","description":"Prospect Capacity of the whole workspace — the total the submitted URLs were measured against, not a per-user quota"}},"description":"Detailed result of the add-users-to-list operation","required":["listId","submittedUrls","validationRejectedUrls","existedUrlsMap","outOfLimitUrls","totalUrlsLimit"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"UpdateRequestDto2":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Prospect list id to update."},"name":{"type":"string","minLength":1,"description":"New prospect list name."},"campaignId":{"type":"string","format":"uuid","description":"Resulting parent campaign ID. Keeping the current ID only renames the list. Changing it moves the list and prospects to a non-deleted Prospects campaign in the same team, requiring an active plan and an available prospect-list slot there. Existing visible prospects are capacity-neutral; a change of owner can return a different list ID."}},"required":["id","name","campaignId"]},"UpdateResponseDto2":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Created entity ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]}},"required":["id"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"DeleteRequestDto2":{"type":"object","properties":{"listId":{"type":"string","format":"uuid","description":"ID of the prospect list to delete."}},"required":["listId"]},"DeleteResponseDto2":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"ReplaceNotesBodyPublicApiDto":{"type":"object","properties":{"notes":{"type":"string","maxLength":2000,"description":"Exact manual note text; empty clears. Maximum 2000 characters."}},"required":["notes"]},"ReplaceNotesResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Prospect id","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Prospect update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Prospect creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"linkedInProfile":{"description":"LinkedIn profile details, if available","type":"object","properties":{"id":{"type":"string","description":"LinkedIn profile entity id"},"updatedAt":{"type":"string","description":"LinkedIn profile update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"LinkedIn profile creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Prospect full name from LinkedIn"},"headline":{"type":"string","description":"Prospect LinkedIn headline"},"avatarUrl":{"description":"Avatar image URL, if available","type":"string"},"linkedInUrl":{"type":"string","description":"Public LinkedIn profile URL"}},"required":["id","updatedAt","createdAt","name","headline","linkedInUrl"]},"list":{"description":"Reference to the prospect list this prospect currently belongs to — `id` plus `name`.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"lastNewPostsObtainFinishDate":{"description":"Latest new-post fetch finish date, if available","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"lastPostsFetchStatus":{"type":"string","description":"Status of the last attempt to fetch new posts for this prospect, an open string. Current states: `waiting_for_initialization`, `requested`, `success`, `target_user_not_found`, `unknown_error`, `crashed_or_cancelled`. A successful collection may find no new posts; `target_user_not_found` does not prove the profile was deleted. Use together with `lastNewPostsObtainFinishDate` to gauge fetch health."},"isDeleted":{"type":"boolean","description":"Whether the prospect is deleted"},"isImportant":{"type":"boolean","description":"Whether the prospect is marked as important"},"notes":{"description":"Owner-specific relationship context of this persisted LEAD prospect, when present.","type":"string"},"type":{"type":"string","description":"Prospect kind. `LEAD` — a prospect the user added to engage with directly; `RECENTLY_LIKED_RELATED_USER` — an indirect prospect (someone the LEAD recently engaged with), surfaced by the indirect-engagement feature when the campaign's `commenting.indirectCommentingEnabled` is on. Drives which actions are available on the prospect."},"parentTargetUser":{"description":"For indirect prospects (`type === RECENTLY_LIKED_RELATED_USER`): flat reference to the original LEAD, including its relationship note when present. Fetch the full parent record separately by its `id`. Missing for direct LEADs.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Parent prospect id"},"notes":{"description":"Relationship context of the parent LEAD prospect, when present.","type":"string"},"type":{"type":"string","description":"Parent prospect kind — same value space as the top-level `type` field."},"linkedInProfile":{"description":"LinkedIn profile of the parent prospect, if available","type":"object","properties":{"id":{"type":"string","description":"LinkedIn profile entity id"},"updatedAt":{"type":"string","description":"LinkedIn profile update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"LinkedIn profile creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Prospect full name from LinkedIn"},"headline":{"type":"string","description":"Prospect LinkedIn headline"},"avatarUrl":{"description":"Avatar image URL, if available","type":"string"},"linkedInUrl":{"type":"string","description":"Public LinkedIn profile URL"}},"required":["id","updatedAt","createdAt","name","headline","linkedInUrl"]}},"required":["id","type"]},"statistics":{"description":"Lightweight engagement statistics, if available","type":"object","properties":{"totalPostsCount":{"type":"number","description":"Total direct posts (posts the prospect authored themselves) fetched so far."},"oldestPostDate":{"description":"Oldest fetched direct post date, if available.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"newestPostDate":{"description":"Newest fetched direct post date, if available.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"answeredPostsCount":{"type":"number","description":"Number of direct comments already posted by the campaign owner under the prospect's own posts."},"pendingPostsAnswersCount":{"type":"number","description":"Number of direct comments approved and queued to be posted to LinkedIn (not yet sent)."},"oldestPostAnswerDate":{"description":"Oldest direct comment date, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"newestPostAnswerDate":{"description":"Newest direct comment date, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"postsLikesCount":{"type":"number","description":"Likes the campaign owner placed on the prospect's own posts."},"weeklyPostFrequency":{"type":"number","description":"Average weekly posting frequency of the prospect (their own posts)."},"lastNewSuccessPostsObtainFinishDate":{"description":"Last successful post sync finish date, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"indirectPostsLikesCount":{"type":"number","description":"Likes the campaign owner placed on indirect posts (posts from people the prospect engages with)."},"indirectOldestResponseCommentDate":{"description":"Oldest indirect-comment date (comment under an indirect post), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"indirectNewestResponseCommentDate":{"description":"Newest indirect-comment date (comment under an indirect post), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"indirectAnsweredPostsCount":{"type":"number","description":"Number of indirect comments already posted (comments under indirect posts)."},"indirectPendingResponseCommentsCount":{"type":"number","description":"Number of indirect comments approved and queued to be posted to LinkedIn (not yet sent)."},"lastNewSuccessPostsTotalCount":{"type":"number","description":"Number of new posts fetched during the last successful post-fetch run."},"totalIndirectPostActivitiesCount":{"type":"number","description":"Total indirect posts (posts from people the prospect engages with) fetched so far."},"weeklyIndirectPostActivityFrequency":{"type":"number","description":"Average weekly frequency of indirect post activities."},"newestPostReactionDate":{"description":"Newest date of any reaction/like by the prospect on a post, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"totalAnsweredPostsCount":{"type":"number","description":"Total comments already posted by the campaign owner (direct + indirect)."},"totalOldestResponseCommentDate":{"description":"Oldest comment date across all activity (direct + indirect), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"totalNewestResponseCommentDate":{"description":"Newest comment date across all activity (direct + indirect), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}},"required":["totalPostsCount","answeredPostsCount","pendingPostsAnswersCount","postsLikesCount","weeklyPostFrequency","indirectPostsLikesCount","indirectAnsweredPostsCount","indirectPendingResponseCommentsCount","lastNewSuccessPostsTotalCount","totalIndirectPostActivitiesCount","weeklyIndirectPostActivityFrequency","totalAnsweredPostsCount"]},"campaign":{"description":"Reference to the parent campaign — `id` plus `name`.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"sharedBy":{"description":"Team member who shared this prospect, if applicable","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"user":{"description":"Reference to the user who owns this prospect — `id` plus `name`. Missing if not available.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"userConnection":{"description":"LinkedIn connection data, if available","type":"object","properties":{"id":{"type":"string","description":"Connection entity id"},"updatedAt":{"type":"string","description":"Connection update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Connection creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"userId":{"type":"string","format":"uuid","description":"Team member id that owns the connection"},"prospectLinkedInProfileId":{"type":"string","description":"LinkedIn profile id for the prospect"},"status":{"type":"string","description":"Current connection status"},"connectedDate":{"description":"Date when the connection was established, if available","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"wasConnectionRequestSuccessfulAttemptMade":{"type":"boolean","description":"Whether Extrovert has successfully sent a connection request to this prospect. If `false` and `status` is `CONNECTED`, the connection was already in place before Extrovert started tracking it."},"connectionRequestSuccessfulAttemptMadeDate":{"description":"Date when Extrovert successfully sent the connection request, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"latestDmHistoryMessageDate":{"description":"Latest synced DM history message date, if available","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"connectionRequestWithdrawCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How many times Extrovert has withdrawn this prospect's unaccepted connection request in the current campaign. Moving a prospect who is not Connected to another campaign resets it to 0."},"connectionRequestWithdrawnAt":{"description":"When Extrovert last withdrew the unaccepted connection request, set only while that withdrawal is the current state (`status` is `not_connected`). The app shows it as Withdrawn.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"isConnectionRequestWithdrawQueued":{"type":"boolean","description":"Whether the pending connection request is queued for automatic withdrawal because it was not accepted in time. The app shows it as Withdrawal queued."}},"required":["id","updatedAt","createdAt","userId","prospectLinkedInProfileId","status","wasConnectionRequestSuccessfulAttemptMade","connectionRequestWithdrawCount","isConnectionRequestWithdrawQueued"]}},"required":["id","updatedAt","createdAt","lastPostsFetchStatus","isDeleted","isImportant","type"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"AddNoteFactBodyPublicApiDto":{"type":"object","properties":{"fact":{"type":"string","description":"Relationship fact to add, without normalization or a manual-note length limit."}},"required":["fact"]},"AddNoteFactResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Prospect id","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Prospect update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Prospect creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"linkedInProfile":{"description":"LinkedIn profile details, if available","type":"object","properties":{"id":{"type":"string","description":"LinkedIn profile entity id"},"updatedAt":{"type":"string","description":"LinkedIn profile update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"LinkedIn profile creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Prospect full name from LinkedIn"},"headline":{"type":"string","description":"Prospect LinkedIn headline"},"avatarUrl":{"description":"Avatar image URL, if available","type":"string"},"linkedInUrl":{"type":"string","description":"Public LinkedIn profile URL"}},"required":["id","updatedAt","createdAt","name","headline","linkedInUrl"]},"list":{"description":"Reference to the prospect list this prospect currently belongs to — `id` plus `name`.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"lastNewPostsObtainFinishDate":{"description":"Latest new-post fetch finish date, if available","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"lastPostsFetchStatus":{"type":"string","description":"Status of the last attempt to fetch new posts for this prospect, an open string. Current states: `waiting_for_initialization`, `requested`, `success`, `target_user_not_found`, `unknown_error`, `crashed_or_cancelled`. A successful collection may find no new posts; `target_user_not_found` does not prove the profile was deleted. Use together with `lastNewPostsObtainFinishDate` to gauge fetch health."},"isDeleted":{"type":"boolean","description":"Whether the prospect is deleted"},"isImportant":{"type":"boolean","description":"Whether the prospect is marked as important"},"notes":{"description":"Owner-specific relationship context of this persisted LEAD prospect, when present.","type":"string"},"type":{"type":"string","description":"Prospect kind. `LEAD` — a prospect the user added to engage with directly; `RECENTLY_LIKED_RELATED_USER` — an indirect prospect (someone the LEAD recently engaged with), surfaced by the indirect-engagement feature when the campaign's `commenting.indirectCommentingEnabled` is on. Drives which actions are available on the prospect."},"parentTargetUser":{"description":"For indirect prospects (`type === RECENTLY_LIKED_RELATED_USER`): flat reference to the original LEAD, including its relationship note when present. Fetch the full parent record separately by its `id`. Missing for direct LEADs.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Parent prospect id"},"notes":{"description":"Relationship context of the parent LEAD prospect, when present.","type":"string"},"type":{"type":"string","description":"Parent prospect kind — same value space as the top-level `type` field."},"linkedInProfile":{"description":"LinkedIn profile of the parent prospect, if available","type":"object","properties":{"id":{"type":"string","description":"LinkedIn profile entity id"},"updatedAt":{"type":"string","description":"LinkedIn profile update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"LinkedIn profile creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Prospect full name from LinkedIn"},"headline":{"type":"string","description":"Prospect LinkedIn headline"},"avatarUrl":{"description":"Avatar image URL, if available","type":"string"},"linkedInUrl":{"type":"string","description":"Public LinkedIn profile URL"}},"required":["id","updatedAt","createdAt","name","headline","linkedInUrl"]}},"required":["id","type"]},"statistics":{"description":"Lightweight engagement statistics, if available","type":"object","properties":{"totalPostsCount":{"type":"number","description":"Total direct posts (posts the prospect authored themselves) fetched so far."},"oldestPostDate":{"description":"Oldest fetched direct post date, if available.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"newestPostDate":{"description":"Newest fetched direct post date, if available.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"answeredPostsCount":{"type":"number","description":"Number of direct comments already posted by the campaign owner under the prospect's own posts."},"pendingPostsAnswersCount":{"type":"number","description":"Number of direct comments approved and queued to be posted to LinkedIn (not yet sent)."},"oldestPostAnswerDate":{"description":"Oldest direct comment date, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"newestPostAnswerDate":{"description":"Newest direct comment date, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"postsLikesCount":{"type":"number","description":"Likes the campaign owner placed on the prospect's own posts."},"weeklyPostFrequency":{"type":"number","description":"Average weekly posting frequency of the prospect (their own posts)."},"lastNewSuccessPostsObtainFinishDate":{"description":"Last successful post sync finish date, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"indirectPostsLikesCount":{"type":"number","description":"Likes the campaign owner placed on indirect posts (posts from people the prospect engages with)."},"indirectOldestResponseCommentDate":{"description":"Oldest indirect-comment date (comment under an indirect post), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"indirectNewestResponseCommentDate":{"description":"Newest indirect-comment date (comment under an indirect post), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"indirectAnsweredPostsCount":{"type":"number","description":"Number of indirect comments already posted (comments under indirect posts)."},"indirectPendingResponseCommentsCount":{"type":"number","description":"Number of indirect comments approved and queued to be posted to LinkedIn (not yet sent)."},"lastNewSuccessPostsTotalCount":{"type":"number","description":"Number of new posts fetched during the last successful post-fetch run."},"totalIndirectPostActivitiesCount":{"type":"number","description":"Total indirect posts (posts from people the prospect engages with) fetched so far."},"weeklyIndirectPostActivityFrequency":{"type":"number","description":"Average weekly frequency of indirect post activities."},"newestPostReactionDate":{"description":"Newest date of any reaction/like by the prospect on a post, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"totalAnsweredPostsCount":{"type":"number","description":"Total comments already posted by the campaign owner (direct + indirect)."},"totalOldestResponseCommentDate":{"description":"Oldest comment date across all activity (direct + indirect), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"totalNewestResponseCommentDate":{"description":"Newest comment date across all activity (direct + indirect), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}},"required":["totalPostsCount","answeredPostsCount","pendingPostsAnswersCount","postsLikesCount","weeklyPostFrequency","indirectPostsLikesCount","indirectAnsweredPostsCount","indirectPendingResponseCommentsCount","lastNewSuccessPostsTotalCount","totalIndirectPostActivitiesCount","weeklyIndirectPostActivityFrequency","totalAnsweredPostsCount"]},"campaign":{"description":"Reference to the parent campaign — `id` plus `name`.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"sharedBy":{"description":"Team member who shared this prospect, if applicable","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"user":{"description":"Reference to the user who owns this prospect — `id` plus `name`. Missing if not available.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"userConnection":{"description":"LinkedIn connection data, if available","type":"object","properties":{"id":{"type":"string","description":"Connection entity id"},"updatedAt":{"type":"string","description":"Connection update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Connection creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"userId":{"type":"string","format":"uuid","description":"Team member id that owns the connection"},"prospectLinkedInProfileId":{"type":"string","description":"LinkedIn profile id for the prospect"},"status":{"type":"string","description":"Current connection status"},"connectedDate":{"description":"Date when the connection was established, if available","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"wasConnectionRequestSuccessfulAttemptMade":{"type":"boolean","description":"Whether Extrovert has successfully sent a connection request to this prospect. If `false` and `status` is `CONNECTED`, the connection was already in place before Extrovert started tracking it."},"connectionRequestSuccessfulAttemptMadeDate":{"description":"Date when Extrovert successfully sent the connection request, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"latestDmHistoryMessageDate":{"description":"Latest synced DM history message date, if available","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"connectionRequestWithdrawCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How many times Extrovert has withdrawn this prospect's unaccepted connection request in the current campaign. Moving a prospect who is not Connected to another campaign resets it to 0."},"connectionRequestWithdrawnAt":{"description":"When Extrovert last withdrew the unaccepted connection request, set only while that withdrawal is the current state (`status` is `not_connected`). The app shows it as Withdrawn.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"isConnectionRequestWithdrawQueued":{"type":"boolean","description":"Whether the pending connection request is queued for automatic withdrawal because it was not accepted in time. The app shows it as Withdrawal queued."}},"required":["id","updatedAt","createdAt","userId","prospectLinkedInProfileId","status","wasConnectionRequestSuccessfulAttemptMade","connectionRequestWithdrawCount","isConnectionRequestWithdrawQueued"]}},"required":["id","updatedAt","createdAt","lastPostsFetchStatus","isDeleted","isImportant","type"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"ListResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Prospect id","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Prospect update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Prospect creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"linkedInProfile":{"description":"LinkedIn profile details, if available","type":"object","properties":{"id":{"type":"string","description":"LinkedIn profile entity id"},"updatedAt":{"type":"string","description":"LinkedIn profile update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"LinkedIn profile creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Prospect full name from LinkedIn"},"headline":{"type":"string","description":"Prospect LinkedIn headline"},"avatarUrl":{"description":"Avatar image URL, if available","type":"string"},"linkedInUrl":{"type":"string","description":"Public LinkedIn profile URL"}},"required":["id","updatedAt","createdAt","name","headline","linkedInUrl"]},"list":{"description":"Reference to the prospect list this prospect currently belongs to — `id` plus `name`.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"lastNewPostsObtainFinishDate":{"description":"Latest new-post fetch finish date, if available","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"lastPostsFetchStatus":{"type":"string","description":"Status of the last attempt to fetch new posts for this prospect, an open string. Current states: `waiting_for_initialization`, `requested`, `success`, `target_user_not_found`, `unknown_error`, `crashed_or_cancelled`. A successful collection may find no new posts; `target_user_not_found` does not prove the profile was deleted. Use together with `lastNewPostsObtainFinishDate` to gauge fetch health."},"isDeleted":{"type":"boolean","description":"Whether the prospect is deleted"},"isImportant":{"type":"boolean","description":"Whether the prospect is marked as important"},"notes":{"description":"Owner-specific relationship context of this persisted LEAD prospect, when present.","type":"string"},"type":{"type":"string","description":"Prospect kind. `LEAD` — a prospect the user added to engage with directly; `RECENTLY_LIKED_RELATED_USER` — an indirect prospect (someone the LEAD recently engaged with), surfaced by the indirect-engagement feature when the campaign's `commenting.indirectCommentingEnabled` is on. Drives which actions are available on the prospect."},"parentTargetUser":{"description":"For indirect prospects (`type === RECENTLY_LIKED_RELATED_USER`): flat reference to the original LEAD, including its relationship note when present. Fetch the full parent record separately by its `id`. Missing for direct LEADs.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Parent prospect id"},"notes":{"description":"Relationship context of the parent LEAD prospect, when present.","type":"string"},"type":{"type":"string","description":"Parent prospect kind — same value space as the top-level `type` field."},"linkedInProfile":{"description":"LinkedIn profile of the parent prospect, if available","type":"object","properties":{"id":{"type":"string","description":"LinkedIn profile entity id"},"updatedAt":{"type":"string","description":"LinkedIn profile update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"LinkedIn profile creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Prospect full name from LinkedIn"},"headline":{"type":"string","description":"Prospect LinkedIn headline"},"avatarUrl":{"description":"Avatar image URL, if available","type":"string"},"linkedInUrl":{"type":"string","description":"Public LinkedIn profile URL"}},"required":["id","updatedAt","createdAt","name","headline","linkedInUrl"]}},"required":["id","type"]},"statistics":{"description":"Lightweight engagement statistics, if available","type":"object","properties":{"totalPostsCount":{"type":"number","description":"Total direct posts (posts the prospect authored themselves) fetched so far."},"oldestPostDate":{"description":"Oldest fetched direct post date, if available.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"newestPostDate":{"description":"Newest fetched direct post date, if available.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"answeredPostsCount":{"type":"number","description":"Number of direct comments already posted by the campaign owner under the prospect's own posts."},"pendingPostsAnswersCount":{"type":"number","description":"Number of direct comments approved and queued to be posted to LinkedIn (not yet sent)."},"oldestPostAnswerDate":{"description":"Oldest direct comment date, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"newestPostAnswerDate":{"description":"Newest direct comment date, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"postsLikesCount":{"type":"number","description":"Likes the campaign owner placed on the prospect's own posts."},"weeklyPostFrequency":{"type":"number","description":"Average weekly posting frequency of the prospect (their own posts)."},"lastNewSuccessPostsObtainFinishDate":{"description":"Last successful post sync finish date, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"indirectPostsLikesCount":{"type":"number","description":"Likes the campaign owner placed on indirect posts (posts from people the prospect engages with)."},"indirectOldestResponseCommentDate":{"description":"Oldest indirect-comment date (comment under an indirect post), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"indirectNewestResponseCommentDate":{"description":"Newest indirect-comment date (comment under an indirect post), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"indirectAnsweredPostsCount":{"type":"number","description":"Number of indirect comments already posted (comments under indirect posts)."},"indirectPendingResponseCommentsCount":{"type":"number","description":"Number of indirect comments approved and queued to be posted to LinkedIn (not yet sent)."},"lastNewSuccessPostsTotalCount":{"type":"number","description":"Number of new posts fetched during the last successful post-fetch run."},"totalIndirectPostActivitiesCount":{"type":"number","description":"Total indirect posts (posts from people the prospect engages with) fetched so far."},"weeklyIndirectPostActivityFrequency":{"type":"number","description":"Average weekly frequency of indirect post activities."},"newestPostReactionDate":{"description":"Newest date of any reaction/like by the prospect on a post, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"totalAnsweredPostsCount":{"type":"number","description":"Total comments already posted by the campaign owner (direct + indirect)."},"totalOldestResponseCommentDate":{"description":"Oldest comment date across all activity (direct + indirect), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"totalNewestResponseCommentDate":{"description":"Newest comment date across all activity (direct + indirect), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}},"required":["totalPostsCount","answeredPostsCount","pendingPostsAnswersCount","postsLikesCount","weeklyPostFrequency","indirectPostsLikesCount","indirectAnsweredPostsCount","indirectPendingResponseCommentsCount","lastNewSuccessPostsTotalCount","totalIndirectPostActivitiesCount","weeklyIndirectPostActivityFrequency","totalAnsweredPostsCount"]},"campaign":{"description":"Reference to the parent campaign — `id` plus `name`.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"sharedBy":{"description":"Team member who shared this prospect, if applicable","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"user":{"description":"Reference to the user who owns this prospect — `id` plus `name`. Missing if not available.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"userConnection":{"description":"LinkedIn connection data, if available","type":"object","properties":{"id":{"type":"string","description":"Connection entity id"},"updatedAt":{"type":"string","description":"Connection update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Connection creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"userId":{"type":"string","format":"uuid","description":"Team member id that owns the connection"},"prospectLinkedInProfileId":{"type":"string","description":"LinkedIn profile id for the prospect"},"status":{"type":"string","description":"Current connection status"},"connectedDate":{"description":"Date when the connection was established, if available","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"wasConnectionRequestSuccessfulAttemptMade":{"type":"boolean","description":"Whether Extrovert has successfully sent a connection request to this prospect. If `false` and `status` is `CONNECTED`, the connection was already in place before Extrovert started tracking it."},"connectionRequestSuccessfulAttemptMadeDate":{"description":"Date when Extrovert successfully sent the connection request, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"latestDmHistoryMessageDate":{"description":"Latest synced DM history message date, if available","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"connectionRequestWithdrawCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How many times Extrovert has withdrawn this prospect's unaccepted connection request in the current campaign. Moving a prospect who is not Connected to another campaign resets it to 0."},"connectionRequestWithdrawnAt":{"description":"When Extrovert last withdrew the unaccepted connection request, set only while that withdrawal is the current state (`status` is `not_connected`). The app shows it as Withdrawn.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"isConnectionRequestWithdrawQueued":{"type":"boolean","description":"Whether the pending connection request is queued for automatic withdrawal because it was not accepted in time. The app shows it as Withdrawal queued."}},"required":["id","updatedAt","createdAt","userId","prospectLinkedInProfileId","status","wasConnectionRequestSuccessfulAttemptMade","connectionRequestWithdrawCount","isConnectionRequestWithdrawQueued"]}},"required":["id","updatedAt","createdAt","lastPostsFetchStatus","isDeleted","isImportant","type"]},"description":"Prospect items"},"pagination":{"description":"Pagination information, if returned by the backend","type":"object","properties":{"limit":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of records requested for this page."},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Offset from the start of the filtered result set."},"total":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Total records available for the same filters."}},"required":["limit","offset","total"]}},"description":"Prospects response with optional pagination","required":["users"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"FindByLinkedinUrlResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"exists":{"type":"boolean","description":"Whether at least one prospect already exists for the given LinkedIn URL"},"prospects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Prospect id","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Prospect update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Prospect creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"linkedInProfile":{"description":"LinkedIn profile details, if available","type":"object","properties":{"id":{"type":"string","description":"LinkedIn profile entity id"},"updatedAt":{"type":"string","description":"LinkedIn profile update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"LinkedIn profile creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Prospect full name from LinkedIn"},"headline":{"type":"string","description":"Prospect LinkedIn headline"},"avatarUrl":{"description":"Avatar image URL, if available","type":"string"},"linkedInUrl":{"type":"string","description":"Public LinkedIn profile URL"}},"required":["id","updatedAt","createdAt","name","headline","linkedInUrl"]},"list":{"description":"Reference to the prospect list this prospect currently belongs to — `id` plus `name`.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"lastNewPostsObtainFinishDate":{"description":"Latest new-post fetch finish date, if available","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"lastPostsFetchStatus":{"type":"string","description":"Status of the last attempt to fetch new posts for this prospect, an open string. Current states: `waiting_for_initialization`, `requested`, `success`, `target_user_not_found`, `unknown_error`, `crashed_or_cancelled`. A successful collection may find no new posts; `target_user_not_found` does not prove the profile was deleted. Use together with `lastNewPostsObtainFinishDate` to gauge fetch health."},"isDeleted":{"type":"boolean","description":"Whether the prospect is deleted"},"isImportant":{"type":"boolean","description":"Whether the prospect is marked as important"},"notes":{"description":"Owner-specific relationship context of this persisted LEAD prospect, when present.","type":"string"},"type":{"type":"string","description":"Prospect kind. `LEAD` — a prospect the user added to engage with directly; `RECENTLY_LIKED_RELATED_USER` — an indirect prospect (someone the LEAD recently engaged with), surfaced by the indirect-engagement feature when the campaign's `commenting.indirectCommentingEnabled` is on. Drives which actions are available on the prospect."},"parentTargetUser":{"description":"For indirect prospects (`type === RECENTLY_LIKED_RELATED_USER`): flat reference to the original LEAD, including its relationship note when present. Fetch the full parent record separately by its `id`. Missing for direct LEADs.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Parent prospect id"},"notes":{"description":"Relationship context of the parent LEAD prospect, when present.","type":"string"},"type":{"type":"string","description":"Parent prospect kind — same value space as the top-level `type` field."},"linkedInProfile":{"description":"LinkedIn profile of the parent prospect, if available","type":"object","properties":{"id":{"type":"string","description":"LinkedIn profile entity id"},"updatedAt":{"type":"string","description":"LinkedIn profile update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"LinkedIn profile creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Prospect full name from LinkedIn"},"headline":{"type":"string","description":"Prospect LinkedIn headline"},"avatarUrl":{"description":"Avatar image URL, if available","type":"string"},"linkedInUrl":{"type":"string","description":"Public LinkedIn profile URL"}},"required":["id","updatedAt","createdAt","name","headline","linkedInUrl"]}},"required":["id","type"]},"statistics":{"description":"Lightweight engagement statistics, if available","type":"object","properties":{"totalPostsCount":{"type":"number","description":"Total direct posts (posts the prospect authored themselves) fetched so far."},"oldestPostDate":{"description":"Oldest fetched direct post date, if available.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"newestPostDate":{"description":"Newest fetched direct post date, if available.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"answeredPostsCount":{"type":"number","description":"Number of direct comments already posted by the campaign owner under the prospect's own posts."},"pendingPostsAnswersCount":{"type":"number","description":"Number of direct comments approved and queued to be posted to LinkedIn (not yet sent)."},"oldestPostAnswerDate":{"description":"Oldest direct comment date, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"newestPostAnswerDate":{"description":"Newest direct comment date, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"postsLikesCount":{"type":"number","description":"Likes the campaign owner placed on the prospect's own posts."},"weeklyPostFrequency":{"type":"number","description":"Average weekly posting frequency of the prospect (their own posts)."},"lastNewSuccessPostsObtainFinishDate":{"description":"Last successful post sync finish date, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"indirectPostsLikesCount":{"type":"number","description":"Likes the campaign owner placed on indirect posts (posts from people the prospect engages with)."},"indirectOldestResponseCommentDate":{"description":"Oldest indirect-comment date (comment under an indirect post), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"indirectNewestResponseCommentDate":{"description":"Newest indirect-comment date (comment under an indirect post), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"indirectAnsweredPostsCount":{"type":"number","description":"Number of indirect comments already posted (comments under indirect posts)."},"indirectPendingResponseCommentsCount":{"type":"number","description":"Number of indirect comments approved and queued to be posted to LinkedIn (not yet sent)."},"lastNewSuccessPostsTotalCount":{"type":"number","description":"Number of new posts fetched during the last successful post-fetch run."},"totalIndirectPostActivitiesCount":{"type":"number","description":"Total indirect posts (posts from people the prospect engages with) fetched so far."},"weeklyIndirectPostActivityFrequency":{"type":"number","description":"Average weekly frequency of indirect post activities."},"newestPostReactionDate":{"description":"Newest date of any reaction/like by the prospect on a post, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"totalAnsweredPostsCount":{"type":"number","description":"Total comments already posted by the campaign owner (direct + indirect)."},"totalOldestResponseCommentDate":{"description":"Oldest comment date across all activity (direct + indirect), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"totalNewestResponseCommentDate":{"description":"Newest comment date across all activity (direct + indirect), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}},"required":["totalPostsCount","answeredPostsCount","pendingPostsAnswersCount","postsLikesCount","weeklyPostFrequency","indirectPostsLikesCount","indirectAnsweredPostsCount","indirectPendingResponseCommentsCount","lastNewSuccessPostsTotalCount","totalIndirectPostActivitiesCount","weeklyIndirectPostActivityFrequency","totalAnsweredPostsCount"]},"campaign":{"description":"Reference to the parent campaign — `id` plus `name`.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"sharedBy":{"description":"Team member who shared this prospect, if applicable","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"user":{"description":"Reference to the user who owns this prospect — `id` plus `name`. Missing if not available.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"userConnection":{"description":"LinkedIn connection data, if available","type":"object","properties":{"id":{"type":"string","description":"Connection entity id"},"updatedAt":{"type":"string","description":"Connection update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Connection creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"userId":{"type":"string","format":"uuid","description":"Team member id that owns the connection"},"prospectLinkedInProfileId":{"type":"string","description":"LinkedIn profile id for the prospect"},"status":{"type":"string","description":"Current connection status"},"connectedDate":{"description":"Date when the connection was established, if available","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"wasConnectionRequestSuccessfulAttemptMade":{"type":"boolean","description":"Whether Extrovert has successfully sent a connection request to this prospect. If `false` and `status` is `CONNECTED`, the connection was already in place before Extrovert started tracking it."},"connectionRequestSuccessfulAttemptMadeDate":{"description":"Date when Extrovert successfully sent the connection request, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"latestDmHistoryMessageDate":{"description":"Latest synced DM history message date, if available","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"connectionRequestWithdrawCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How many times Extrovert has withdrawn this prospect's unaccepted connection request in the current campaign. Moving a prospect who is not Connected to another campaign resets it to 0."},"connectionRequestWithdrawnAt":{"description":"When Extrovert last withdrew the unaccepted connection request, set only while that withdrawal is the current state (`status` is `not_connected`). The app shows it as Withdrawn.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"isConnectionRequestWithdrawQueued":{"type":"boolean","description":"Whether the pending connection request is queued for automatic withdrawal because it was not accepted in time. The app shows it as Withdrawal queued."}},"required":["id","updatedAt","createdAt","userId","prospectLinkedInProfileId","status","wasConnectionRequestSuccessfulAttemptMade","connectionRequestWithdrawCount","isConnectionRequestWithdrawQueued"]}},"required":["id","updatedAt","createdAt","lastPostsFetchStatus","isDeleted","isImportant","type"]},"description":"Matching prospects found in the current team"}},"description":"Search result for the LinkedIn profile URL","required":["exists","prospects"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetResponseDto2":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","description":"Loaded prospect","properties":{"id":{"type":"string","format":"uuid","description":"Prospect id","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Prospect update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Prospect creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"linkedInProfile":{"description":"LinkedIn profile details, if available","type":"object","properties":{"id":{"type":"string","description":"LinkedIn profile entity id"},"updatedAt":{"type":"string","description":"LinkedIn profile update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"LinkedIn profile creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Prospect full name from LinkedIn"},"headline":{"type":"string","description":"Prospect LinkedIn headline"},"avatarUrl":{"description":"Avatar image URL, if available","type":"string"},"linkedInUrl":{"type":"string","description":"Public LinkedIn profile URL"}},"required":["id","updatedAt","createdAt","name","headline","linkedInUrl"]},"list":{"description":"Reference to the prospect list this prospect currently belongs to — `id` plus `name`.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"lastNewPostsObtainFinishDate":{"description":"Latest new-post fetch finish date, if available","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"lastPostsFetchStatus":{"type":"string","description":"Status of the last attempt to fetch new posts for this prospect, an open string. Current states: `waiting_for_initialization`, `requested`, `success`, `target_user_not_found`, `unknown_error`, `crashed_or_cancelled`. A successful collection may find no new posts; `target_user_not_found` does not prove the profile was deleted. Use together with `lastNewPostsObtainFinishDate` to gauge fetch health."},"isDeleted":{"type":"boolean","description":"Whether the prospect is deleted"},"isImportant":{"type":"boolean","description":"Whether the prospect is marked as important"},"notes":{"description":"Owner-specific relationship context of this persisted LEAD prospect, when present.","type":"string"},"type":{"type":"string","description":"Prospect kind. `LEAD` — a prospect the user added to engage with directly; `RECENTLY_LIKED_RELATED_USER` — an indirect prospect (someone the LEAD recently engaged with), surfaced by the indirect-engagement feature when the campaign's `commenting.indirectCommentingEnabled` is on. Drives which actions are available on the prospect."},"parentTargetUser":{"description":"For indirect prospects (`type === RECENTLY_LIKED_RELATED_USER`): flat reference to the original LEAD, including its relationship note when present. Fetch the full parent record separately by its `id`. Missing for direct LEADs.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Parent prospect id"},"notes":{"description":"Relationship context of the parent LEAD prospect, when present.","type":"string"},"type":{"type":"string","description":"Parent prospect kind — same value space as the top-level `type` field."},"linkedInProfile":{"description":"LinkedIn profile of the parent prospect, if available","type":"object","properties":{"id":{"type":"string","description":"LinkedIn profile entity id"},"updatedAt":{"type":"string","description":"LinkedIn profile update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"LinkedIn profile creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Prospect full name from LinkedIn"},"headline":{"type":"string","description":"Prospect LinkedIn headline"},"avatarUrl":{"description":"Avatar image URL, if available","type":"string"},"linkedInUrl":{"type":"string","description":"Public LinkedIn profile URL"}},"required":["id","updatedAt","createdAt","name","headline","linkedInUrl"]}},"required":["id","type"]},"statistics":{"description":"Lightweight engagement statistics, if available","type":"object","properties":{"totalPostsCount":{"type":"number","description":"Total direct posts (posts the prospect authored themselves) fetched so far."},"oldestPostDate":{"description":"Oldest fetched direct post date, if available.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"newestPostDate":{"description":"Newest fetched direct post date, if available.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"answeredPostsCount":{"type":"number","description":"Number of direct comments already posted by the campaign owner under the prospect's own posts."},"pendingPostsAnswersCount":{"type":"number","description":"Number of direct comments approved and queued to be posted to LinkedIn (not yet sent)."},"oldestPostAnswerDate":{"description":"Oldest direct comment date, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"newestPostAnswerDate":{"description":"Newest direct comment date, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"postsLikesCount":{"type":"number","description":"Likes the campaign owner placed on the prospect's own posts."},"weeklyPostFrequency":{"type":"number","description":"Average weekly posting frequency of the prospect (their own posts)."},"lastNewSuccessPostsObtainFinishDate":{"description":"Last successful post sync finish date, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"indirectPostsLikesCount":{"type":"number","description":"Likes the campaign owner placed on indirect posts (posts from people the prospect engages with)."},"indirectOldestResponseCommentDate":{"description":"Oldest indirect-comment date (comment under an indirect post), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"indirectNewestResponseCommentDate":{"description":"Newest indirect-comment date (comment under an indirect post), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"indirectAnsweredPostsCount":{"type":"number","description":"Number of indirect comments already posted (comments under indirect posts)."},"indirectPendingResponseCommentsCount":{"type":"number","description":"Number of indirect comments approved and queued to be posted to LinkedIn (not yet sent)."},"lastNewSuccessPostsTotalCount":{"type":"number","description":"Number of new posts fetched during the last successful post-fetch run."},"totalIndirectPostActivitiesCount":{"type":"number","description":"Total indirect posts (posts from people the prospect engages with) fetched so far."},"weeklyIndirectPostActivityFrequency":{"type":"number","description":"Average weekly frequency of indirect post activities."},"newestPostReactionDate":{"description":"Newest date of any reaction/like by the prospect on a post, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"totalAnsweredPostsCount":{"type":"number","description":"Total comments already posted by the campaign owner (direct + indirect)."},"totalOldestResponseCommentDate":{"description":"Oldest comment date across all activity (direct + indirect), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"totalNewestResponseCommentDate":{"description":"Newest comment date across all activity (direct + indirect), if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}},"required":["totalPostsCount","answeredPostsCount","pendingPostsAnswersCount","postsLikesCount","weeklyPostFrequency","indirectPostsLikesCount","indirectAnsweredPostsCount","indirectPendingResponseCommentsCount","lastNewSuccessPostsTotalCount","totalIndirectPostActivitiesCount","weeklyIndirectPostActivityFrequency","totalAnsweredPostsCount"]},"campaign":{"description":"Reference to the parent campaign — `id` plus `name`.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"sharedBy":{"description":"Team member who shared this prospect, if applicable","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"user":{"description":"Reference to the user who owns this prospect — `id` plus `name`. Missing if not available.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"userConnection":{"description":"LinkedIn connection data, if available","type":"object","properties":{"id":{"type":"string","description":"Connection entity id"},"updatedAt":{"type":"string","description":"Connection update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Connection creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"userId":{"type":"string","format":"uuid","description":"Team member id that owns the connection"},"prospectLinkedInProfileId":{"type":"string","description":"LinkedIn profile id for the prospect"},"status":{"type":"string","description":"Current connection status"},"connectedDate":{"description":"Date when the connection was established, if available","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"wasConnectionRequestSuccessfulAttemptMade":{"type":"boolean","description":"Whether Extrovert has successfully sent a connection request to this prospect. If `false` and `status` is `CONNECTED`, the connection was already in place before Extrovert started tracking it."},"connectionRequestSuccessfulAttemptMadeDate":{"description":"Date when Extrovert successfully sent the connection request, if any.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"latestDmHistoryMessageDate":{"description":"Latest synced DM history message date, if available","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"connectionRequestWithdrawCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How many times Extrovert has withdrawn this prospect's unaccepted connection request in the current campaign. Moving a prospect who is not Connected to another campaign resets it to 0."},"connectionRequestWithdrawnAt":{"description":"When Extrovert last withdrew the unaccepted connection request, set only while that withdrawal is the current state (`status` is `not_connected`). The app shows it as Withdrawn.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"isConnectionRequestWithdrawQueued":{"type":"boolean","description":"Whether the pending connection request is queued for automatic withdrawal because it was not accepted in time. The app shows it as Withdrawal queued."}},"required":["id","updatedAt","createdAt","userId","prospectLinkedInProfileId","status","wasConnectionRequestSuccessfulAttemptMade","connectionRequestWithdrawCount","isConnectionRequestWithdrawQueued"]}},"required":["id","updatedAt","createdAt","lastPostsFetchStatus","isDeleted","isImportant","type"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"DeleteSelectedRequestDto":{"type":"object","properties":{"targetUsersData":{"type":"array","items":{"type":"object","properties":{"userId":{"type":"string","format":"uuid","description":"Owner user id — the teammate whose prospect records should be deleted."},"targetUserProfileId":{"type":"string","format":"uuid","description":"LinkedIn profile id of the person to delete. Every prospect record with this LinkedIn profile owned by `userId` will be deleted across all of that user's campaigns in the team."}},"required":["userId","targetUserProfileId"]},"description":"Owner-user/profile pairs to delete in explicit mode. Each pair deletes that person across the owner's Prospects campaigns in the selected team, not one record or campaign. Read `user.id` and `linkedInProfile.id` to construct the pair. Ignored when `areAllSelected=true`; pass `[]` in that mode. With `areAllSelected=false`, `[]` is a no-op, while a non-empty set matching no record returns not found."},"areAllSelected":{"type":"boolean","description":"True selects by `variant` and `listId` and ignores `targetUsersData`. False deletes by the supplied owner-user/profile pairs across that owner's campaigns in the selected team; `variant` does not control this selection. A supplied `listId` still triggers a lookup/permission check, so omit it in explicit-pair mode."},"variant":{"type":"string","description":"Required only for `areAllSelected=true`. `list` requires `listId`; `all` selects accessible bulk scope and is still narrowed if `listId` is supplied; `campaign` is unsupported and returns BadRequest. Omit in explicit owner/profile-pair mode.","enum":["all","list","campaign"]},"listId":{"type":"string","description":"List ID required for bulk `variant=list`. If supplied with bulk `variant=all` it still restricts the query. In explicit owner/profile-pair mode it does not narrow deletion, but still triggers a list lookup and permission check; omit it in that mode.","format":"uuid"}},"required":["targetUsersData","areAllSelected"]},"DeleteSelectedResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"MoveRequestDto":{"type":"object","properties":{"prospectsIds":{"type":"array","maxItems":1000,"items":{"type":"string","format":"uuid"},"description":"Explicit prospect record IDs, not profile IDs. Ignored when `areAllSelected=true`; pass `[]` in that mode. In explicit mode use a non-empty selection: `[]` moves no prospects, but `newListName` may still create an empty destination list before selection is resolved."},"areAllSelected":{"type":"boolean","description":"True selects by `variant` and optional `oldListId` and ignores `prospectsIds`. False selects the explicit prospect record IDs; `variant` is then ignored by selection but remains required and validated. In both modes `oldListId`, when supplied, triggers a permission check and requires every selected record to belong to that list."},"variant":{"type":"string","enum":["all","list","campaign"],"description":"Required validated selector. With `areAllSelected=true`: `list` requires `oldListId`; `all` selects the accessible bulk scope and is still narrowed if `oldListId` is supplied; `campaign` is unsupported and returns BadRequest. With `areAllSelected=false`, selection ignores `variant`, but a valid enum value is still required."},"oldListId":{"type":"string","description":"Optional source-list constraint. Required for bulk `variant=list`; when supplied with explicit IDs or bulk `variant=all`, every selected record must belong to this list. It also causes a read/permission check; omit it when no source-list guard is intended.","format":"uuid"},"newListId":{"type":"string","description":"Existing destination list ID; it must belong to `campaignId`. Supply exactly one of `newListId` and `newListName`; omit `newListName`, do not pass null or an empty string.","format":"uuid"},"newListName":{"type":"string","description":"Non-empty destination list name to create in `campaignId`; this creates a new list, not a rename. Supply exactly one of `newListId` and `newListName`; omit `newListId`, do not pass null or an empty string.","minLength":1},"campaignId":{"type":"string","format":"uuid","description":"Destination campaign ID, not the source-selection scope. If `newListId` is used, that list must belong to this campaign. The destination must be a usable Prospects campaign in the same team and the plan must be active; moving already-visible prospects does not require free Prospect Capacity."}},"required":["prospectsIds","areAllSelected","variant","campaignId"],"oneOf":[{"required":["newListId"]},{"required":["newListName"]}]},"MoveResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","description":"Bulk move result","properties":{"existedUsers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."},"description":{"description":"Optional extra description, if available","type":"string"}},"required":["id","name"]},"description":"Prospects that already existed in the destination"},"totalUsersLimit":{"type":"number","description":"Prospect Capacity of the workspace — the total this move was resolved against"},"newListId":{"type":"string","format":"uuid","description":"Destination list id after the move"}},"required":["existedUsers","totalUsersLimit","newListId"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"MarkImportantRequestDto":{"type":"object","properties":{"prospectId":{"type":"string","format":"uuid","description":"Prospect id to update."},"isImportant":{"type":"boolean","description":"Whether the prospect should be marked as important."}},"required":["prospectId","isImportant"]},"MarkImportantResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetListResponseDto2":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Prospect ID.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]},"fullName":{"type":"string","description":"Prospect full name."},"firstName":{"type":"string","description":"Prospect first name."},"lastName":{"type":"string","description":"Prospect last name."},"campaignId":{"type":"string","format":"uuid","description":"ID of the campaign the prospect belongs to.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"campaignName":{"type":"string","description":"Name of the campaign the prospect belongs to."},"listId":{"type":"string","format":"uuid","description":"ID of the prospect list the prospect belongs to.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]},"listName":{"type":"string","description":"Name of the prospect list the prospect belongs to."},"createdAt":{"type":"string","description":"Timestamp when the prospect was added to the campaign, ISO 8601.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"postsFetched":{"type":"number","description":"Total posts pulled from the prospect's LinkedIn profile so far."},"directComments":{"type":"number","description":"Direct comments: comments the campaign owner has already posted under the prospect's own posts."},"indirectComments":{"type":"number","description":"Indirect comments: comments the campaign owner has already posted under indirect posts — posts from people the prospect engages with (content the prospect is likely to see in their feed)."},"likes":{"type":"number","description":"Likes the campaign owner has placed on the prospect's posts."},"oldestFetchedPost":{"description":"Date of the oldest post fetched for the prospect, ISO 8601.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"],"type":"string"},"newestFetchedPost":{"description":"Date of the newest post fetched for the prospect, ISO 8601.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"],"type":"string"},"recentDirectCommentDate":{"description":"Date of the most recent direct comment on the prospect's own posts, ISO 8601.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"],"type":"string"},"recentIndirectCommentDate":{"description":"Date of the most recent indirect comment involving the prospect, ISO 8601.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"],"type":"string"},"prospectProfileUrl":{"type":"string","description":"Prospect's LinkedIn profile URL.","examples":["https://www.linkedin.com/in/john-doe","https://www.linkedin.com/in/jane-smith-123456789"]},"wasConnectionRequestSentViaExtrovert":{"description":"Whether a LinkedIn connection request has been initiated to the prospect via Extrovert.","type":"boolean"},"connectionRequestSentDate":{"description":"Date when the connection request was sent, ISO 8601.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"],"type":"string"},"connectionStatus":{"description":"Current LinkedIn connection status between the campaign owner and the prospect. queued: the connection request is waiting in Extrovert to be sent; pending: the request was sent to LinkedIn and is not accepted yet.","type":"string","enum":["unknown","not_connected","queued","pending","email_required","target_user_not_found","unable_to_connect","connected","error"]},"connectedDate":{"description":"Date when the connection with the prospect was established, ISO 8601.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"],"type":"string"}},"required":["id","fullName","firstName","lastName","campaignId","campaignName","listId","listName","createdAt","postsFetched","directComments","indirectComments","likes","prospectProfileUrl"]},"description":"Prospects list with statistics"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"CreateRequestDto2":{"type":"object","properties":{"prospectListId":{"type":"string","format":"uuid","description":"ID of the prospect list to add the prospect to.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]},"prospectProfileUrl":{"type":"string","description":"LinkedIn profile URL of the prospect to add.","examples":["https://www.linkedin.com/in/john-doe","https://www.linkedin.com/in/jane-smith-123456789"]},"campaignId":{"type":"string","format":"uuid","description":"ID of the campaign that owns the prospect list.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"moveDuplicatedProspect":{"type":"boolean","description":"Controls behavior when the prospect already exists in another list or campaign of the same owner. If true, the prospect is moved into this list and campaign. If false, the request fails with an error."}},"required":["prospectListId","prospectProfileUrl","campaignId","moveDuplicatedProspect"]},"CreateResponseDto2":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"DeleteRequestDto3":{"type":"object","properties":{"prospectProfileUrl":{"type":"string","description":"LinkedIn profile URL of the prospect to remove.","examples":["https://www.linkedin.com/in/john-doe","https://www.linkedin.com/in/jane-smith-123456789"]},"campaignId":{"type":"string","format":"uuid","description":"ID of the campaign to remove the prospect from.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]}},"required":["prospectProfileUrl","campaignId"]},"DeleteResponseDto3":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"DeleteFromWorkspaceRequestDto":{"type":"object","properties":{"prospectProfileUrl":{"type":"string","description":"LinkedIn profile URL of the prospect to remove from the entire team.","examples":["https://www.linkedin.com/in/john-doe","https://www.linkedin.com/in/jane-smith-123456789"]}},"required":["prospectProfileUrl"]},"DeleteFromWorkspaceResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetListResponseDto3":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"comments":{"type":"array","items":{"type":"object","properties":{"postId":{"type":"string","format":"uuid","description":"LinkedIn post identity inside Extrovert.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"ownerId":{"type":"string","format":"uuid","description":"LinkedIn account owner whose profile will engage with the post.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"author":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"],"description":"Person whose post receives the engagement."},"prospect":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"]},{"type":"null"}],"description":"Primary relationship target: the author for Direct, another person for Indirect, and null for Topical engagement."},"engagementRoute":{"type":"string","enum":["Direct","Indirect","Topical"]},"campaign":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},"prospectList":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}]},"keyword":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}]},"topic":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}]},"engagementContexts":{"minItems":1,"type":"array","items":{"type":"object","properties":{"campaign":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"],"description":"Campaign in which this engagement context is visible."},"prospectList":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Prospect List for this context, or null outside a Prospect List."},"keyword":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Tracked keyword for this context, or null outside Keyword collection."},"topic":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Matched Monitored Topic, or null when no topic was assigned."},"engagementRoute":{"type":"string","enum":["Direct","Indirect","Topical"],"description":"Direct means engaging on the prospect's post; Indirect means engaging on another author's post to warm the prospect; Topical has no prospect."},"prospect":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"]},{"type":"null"}],"description":"Effective relationship target for this context; null only for Topical engagement without a prospect."}},"required":["campaign","prospectList","keyword","topic","engagementRoute","prospect"]},"description":"All visible relationship contexts for this physical comment. The first context is mirrored in the top-level context fields."},"post":{"type":"object","properties":{"text":{"description":"LinkedIn post text, or null when the post contains no stored text.","type":["string","null"]},"linkedInUrl":{"type":"string","format":"uri","description":"LinkedIn URL of the post receiving the engagement."},"publishedAt":{"type":"string","description":"When the post was published on LinkedIn.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"format":{"type":"string","enum":["Text","Image","Video","Link","Article","Poll","Job","Celebration"],"description":"Customer-facing post format."},"likeCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"LinkedIn like count, or null when it cannot be parsed reliably."},"media":{"type":"object","properties":{"kind":{"type":"string","enum":["None","Image","Video"],"description":"Media kind indicated by the LinkedIn post."},"urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"Available media URLs. Empty for no media and currently also for video posts because production does not persist a video URL."}},"required":["kind","urls"]},"externalLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Destination linked from the LinkedIn post."},"caption":{"description":"Link/article caption, or null when LinkedIn did not provide one.","type":["string","null"]},"summary":{"description":"Available post/link summary, or null when none was stored.","type":["string","null"]}},"required":["url","caption","summary"]},{"type":"null"}],"description":"Link/article metadata, or null when the post has no external link."},"originalPost":{"anyOf":[{"type":"object","properties":{"text":{"description":"Original post text, or null when unavailable.","type":["string","null"]},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Original post URL, or null when unavailable."},"publishedAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Original LinkedIn publication time, or null when unavailable."},"author":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"],"description":"Original post author. ID and LinkedIn URL are null when the repost source did not provide them."},"media":{"type":"object","properties":{"kind":{"type":"string","enum":["None","Image","Video"],"description":"Media kind indicated by the LinkedIn post."},"urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"Available media URLs. Empty for no media and currently also for video posts because production does not persist a video URL."}},"required":["kind","urls"]},"externalLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Destination linked from the LinkedIn post."},"caption":{"description":"Link/article caption, or null when LinkedIn did not provide one.","type":["string","null"]},"summary":{"description":"Available post/link summary, or null when none was stored.","type":["string","null"]}},"required":["url","caption","summary"]},{"type":"null"}]}},"required":["text","linkedInUrl","publishedAt","author","media","externalLink"]},{"type":"null"}],"description":"Original post for a repost-with-text, or null when this is not a repost."}},"required":["text","linkedInUrl","publishedAt","format","likeCount","media","externalLink","originalPost"]},"draft":{"anyOf":[{"type":"object","properties":{"text":{"type":"string","minLength":1,"description":"Effective comment text that will be posted if the action includes a comment."},"source":{"type":"string","enum":["Extrovert-generated","Agent-authored"],"description":"Who supplied the effective text. Agent-authored includes edits that override an Extrovert-generated body."},"updatedAt":{"type":"string","description":"When the effective draft last changed.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}},"required":["text","source","updatedAt"]},{"type":"null"}],"description":"Current effective draft, or null when no comment text exists or React only needs none."},"reactionBehavior":{"anyOf":[{"oneOf":[{"type":"object","properties":{"behavior":{"type":"string","const":"Comment only"},"reaction":{"type":"null","description":"No LinkedIn reaction is sent in Comment only mode."}},"required":["behavior","reaction"]},{"type":"object","properties":{"behavior":{"type":"string","const":"Comment and react"},"reaction":{"type":"string","enum":["Like","Celebrate","Support","Love","Insightful","Funny"],"description":"LinkedIn reaction sent with the approved comment."}},"required":["behavior","reaction"]},{"type":"object","properties":{"behavior":{"type":"string","const":"React only"},"reaction":{"type":"string","enum":["Like","Celebrate","Support","Love","Insightful","Funny"],"description":"LinkedIn reaction sent without a comment."}},"required":["behavior","reaction"]}]},{"type":"null"}],"description":"Selected comment/reaction behavior, or null before a behavior has been initialized."},"state":{"type":"string","enum":["Generating","Need approval","Pending","Error","Posted","Skipped"]},"plannedAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Planned posting time. Set only when the campaign spaces approved comments with a posting interval; null when posting starts immediately after approval — even while the comment is Pending or already Posted."},"completedAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Posting/skip completion time, or null before a terminal result."},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","description":"Stable public error code suitable for branching. It is not a raw provider or backend status."},"message":{"type":"string","description":"Safe explanation of what failed and what the caller should do next."},"retryable":{"type":"boolean","description":"Whether retrying may succeed after the stated condition is resolved."},"occurredAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"When this failure was recorded, or null when no reliable timestamp exists."}},"required":["code","message","retryable","occurredAt"]},{"type":"null"}],"description":"Current generation/posting failure, or null when no failure is active."},"allowedActions":{"type":"array","items":{"type":"string","enum":["generate-or-improve-draft","set-draft-text","skip-and-react","approve","cancel-posting","skip","unskip"]},"description":"Actions valid for the current state."},"updatedAt":{"type":"string","description":"Latest owner-global comment state change.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}},"required":["postId","ownerId","author","prospect","engagementRoute","campaign","prospectList","keyword","topic","engagementContexts","post","draft","reactionBehavior","state","plannedAt","completedAt","error","allowedActions","updatedAt"]}},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of records requested for this page."},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Offset from the start of the filtered result set."},"total":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Total records available for the same filters."}},"required":["limit","offset","total"],"description":"Pagination information, if returned by the backend"}},"required":["comments","pagination"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetResponseDto3":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"postId":{"type":"string","format":"uuid","description":"LinkedIn post identity inside Extrovert.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"ownerId":{"type":"string","format":"uuid","description":"LinkedIn account owner whose profile will engage with the post.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"author":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"],"description":"Person whose post receives the engagement."},"prospect":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"]},{"type":"null"}],"description":"Primary relationship target: the author for Direct, another person for Indirect, and null for Topical engagement."},"engagementRoute":{"type":"string","enum":["Direct","Indirect","Topical"]},"campaign":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},"prospectList":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}]},"keyword":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}]},"topic":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}]},"engagementContexts":{"minItems":1,"type":"array","items":{"type":"object","properties":{"campaign":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"],"description":"Campaign in which this engagement context is visible."},"prospectList":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Prospect List for this context, or null outside a Prospect List."},"keyword":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Tracked keyword for this context, or null outside Keyword collection."},"topic":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Matched Monitored Topic, or null when no topic was assigned."},"engagementRoute":{"type":"string","enum":["Direct","Indirect","Topical"],"description":"Direct means engaging on the prospect's post; Indirect means engaging on another author's post to warm the prospect; Topical has no prospect."},"prospect":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"]},{"type":"null"}],"description":"Effective relationship target for this context; null only for Topical engagement without a prospect."}},"required":["campaign","prospectList","keyword","topic","engagementRoute","prospect"]},"description":"All visible relationship contexts for this physical comment. The first context is mirrored in the top-level context fields."},"post":{"type":"object","properties":{"text":{"description":"LinkedIn post text, or null when the post contains no stored text.","type":["string","null"]},"linkedInUrl":{"type":"string","format":"uri","description":"LinkedIn URL of the post receiving the engagement."},"publishedAt":{"type":"string","description":"When the post was published on LinkedIn.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"format":{"type":"string","enum":["Text","Image","Video","Link","Article","Poll","Job","Celebration"],"description":"Customer-facing post format."},"likeCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"LinkedIn like count, or null when it cannot be parsed reliably."},"media":{"type":"object","properties":{"kind":{"type":"string","enum":["None","Image","Video"],"description":"Media kind indicated by the LinkedIn post."},"urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"Available media URLs. Empty for no media and currently also for video posts because production does not persist a video URL."}},"required":["kind","urls"]},"externalLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Destination linked from the LinkedIn post."},"caption":{"description":"Link/article caption, or null when LinkedIn did not provide one.","type":["string","null"]},"summary":{"description":"Available post/link summary, or null when none was stored.","type":["string","null"]}},"required":["url","caption","summary"]},{"type":"null"}],"description":"Link/article metadata, or null when the post has no external link."},"originalPost":{"anyOf":[{"type":"object","properties":{"text":{"description":"Original post text, or null when unavailable.","type":["string","null"]},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Original post URL, or null when unavailable."},"publishedAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Original LinkedIn publication time, or null when unavailable."},"author":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"],"description":"Original post author. ID and LinkedIn URL are null when the repost source did not provide them."},"media":{"type":"object","properties":{"kind":{"type":"string","enum":["None","Image","Video"],"description":"Media kind indicated by the LinkedIn post."},"urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"Available media URLs. Empty for no media and currently also for video posts because production does not persist a video URL."}},"required":["kind","urls"]},"externalLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Destination linked from the LinkedIn post."},"caption":{"description":"Link/article caption, or null when LinkedIn did not provide one.","type":["string","null"]},"summary":{"description":"Available post/link summary, or null when none was stored.","type":["string","null"]}},"required":["url","caption","summary"]},{"type":"null"}]}},"required":["text","linkedInUrl","publishedAt","author","media","externalLink"]},{"type":"null"}],"description":"Original post for a repost-with-text, or null when this is not a repost."}},"required":["text","linkedInUrl","publishedAt","format","likeCount","media","externalLink","originalPost"]},"draft":{"anyOf":[{"type":"object","properties":{"text":{"type":"string","minLength":1,"description":"Effective comment text that will be posted if the action includes a comment."},"source":{"type":"string","enum":["Extrovert-generated","Agent-authored"],"description":"Who supplied the effective text. Agent-authored includes edits that override an Extrovert-generated body."},"updatedAt":{"type":"string","description":"When the effective draft last changed.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}},"required":["text","source","updatedAt"]},{"type":"null"}],"description":"Current effective draft, or null when no comment text exists or React only needs none."},"reactionBehavior":{"anyOf":[{"oneOf":[{"type":"object","properties":{"behavior":{"type":"string","const":"Comment only"},"reaction":{"type":"null","description":"No LinkedIn reaction is sent in Comment only mode."}},"required":["behavior","reaction"]},{"type":"object","properties":{"behavior":{"type":"string","const":"Comment and react"},"reaction":{"type":"string","enum":["Like","Celebrate","Support","Love","Insightful","Funny"],"description":"LinkedIn reaction sent with the approved comment."}},"required":["behavior","reaction"]},{"type":"object","properties":{"behavior":{"type":"string","const":"React only"},"reaction":{"type":"string","enum":["Like","Celebrate","Support","Love","Insightful","Funny"],"description":"LinkedIn reaction sent without a comment."}},"required":["behavior","reaction"]}]},{"type":"null"}],"description":"Selected comment/reaction behavior, or null before a behavior has been initialized."},"state":{"type":"string","enum":["Generating","Need approval","Pending","Error","Posted","Skipped"]},"plannedAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Planned posting time. Set only when the campaign spaces approved comments with a posting interval; null when posting starts immediately after approval — even while the comment is Pending or already Posted."},"completedAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Posting/skip completion time, or null before a terminal result."},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","description":"Stable public error code suitable for branching. It is not a raw provider or backend status."},"message":{"type":"string","description":"Safe explanation of what failed and what the caller should do next."},"retryable":{"type":"boolean","description":"Whether retrying may succeed after the stated condition is resolved."},"occurredAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"When this failure was recorded, or null when no reliable timestamp exists."}},"required":["code","message","retryable","occurredAt"]},{"type":"null"}],"description":"Current generation/posting failure, or null when no failure is active."},"allowedActions":{"type":"array","items":{"type":"string","enum":["generate-or-improve-draft","set-draft-text","skip-and-react","approve","cancel-posting","skip","unskip"]},"description":"Actions valid for the current state."},"updatedAt":{"type":"string","description":"Latest owner-global comment state change.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}},"required":["postId","ownerId","author","prospect","engagementRoute","campaign","prospectList","keyword","topic","engagementContexts","post","draft","reactionBehavior","state","plannedAt","completedAt","error","allowedActions","updatedAt"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GenerateOrImproveDraftRequestDto":{"type":"object","properties":{"postId":{"type":"string","format":"uuid","description":"LinkedIn post identity inside Extrovert."},"ownerId":{"type":"string","format":"uuid","description":"LinkedIn account owner whose comment is addressed. Often a managed account rather than the authenticated user — call `user_list-shared` first and pick the owner whose LinkedIn profile runs the campaign."},"campaignId":{"type":"string","format":"uuid","description":"Accessible campaign whose Voice must be used for generation."},"mode":{"type":"string","enum":["Generate","Improve"],"description":"Generate writes a new draft; Improve rewrites the current draft text and requires instructions."},"instructions":{"type":"string","description":"Plain-text direction: optional for Generate, required for Improve.","minLength":1,"maxLength":1250}},"required":["postId","ownerId","campaignId","mode"]},"GenerateOrImproveDraftResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"postId":{"type":"string","format":"uuid","description":"LinkedIn post identity inside Extrovert.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"ownerId":{"type":"string","format":"uuid","description":"LinkedIn account owner whose profile will engage with the post.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"author":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"],"description":"Person whose post receives the engagement."},"prospect":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"]},{"type":"null"}],"description":"Primary relationship target: the author for Direct, another person for Indirect, and null for Topical engagement."},"engagementRoute":{"type":"string","enum":["Direct","Indirect","Topical"]},"campaign":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},"prospectList":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}]},"keyword":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}]},"topic":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}]},"engagementContexts":{"minItems":1,"type":"array","items":{"type":"object","properties":{"campaign":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"],"description":"Campaign in which this engagement context is visible."},"prospectList":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Prospect List for this context, or null outside a Prospect List."},"keyword":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Tracked keyword for this context, or null outside Keyword collection."},"topic":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Matched Monitored Topic, or null when no topic was assigned."},"engagementRoute":{"type":"string","enum":["Direct","Indirect","Topical"],"description":"Direct means engaging on the prospect's post; Indirect means engaging on another author's post to warm the prospect; Topical has no prospect."},"prospect":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"]},{"type":"null"}],"description":"Effective relationship target for this context; null only for Topical engagement without a prospect."}},"required":["campaign","prospectList","keyword","topic","engagementRoute","prospect"]},"description":"All visible relationship contexts for this physical comment. The first context is mirrored in the top-level context fields."},"post":{"type":"object","properties":{"text":{"description":"LinkedIn post text, or null when the post contains no stored text.","type":["string","null"]},"linkedInUrl":{"type":"string","format":"uri","description":"LinkedIn URL of the post receiving the engagement."},"publishedAt":{"type":"string","description":"When the post was published on LinkedIn.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"format":{"type":"string","enum":["Text","Image","Video","Link","Article","Poll","Job","Celebration"],"description":"Customer-facing post format."},"likeCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"LinkedIn like count, or null when it cannot be parsed reliably."},"media":{"type":"object","properties":{"kind":{"type":"string","enum":["None","Image","Video"],"description":"Media kind indicated by the LinkedIn post."},"urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"Available media URLs. Empty for no media and currently also for video posts because production does not persist a video URL."}},"required":["kind","urls"]},"externalLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Destination linked from the LinkedIn post."},"caption":{"description":"Link/article caption, or null when LinkedIn did not provide one.","type":["string","null"]},"summary":{"description":"Available post/link summary, or null when none was stored.","type":["string","null"]}},"required":["url","caption","summary"]},{"type":"null"}],"description":"Link/article metadata, or null when the post has no external link."},"originalPost":{"anyOf":[{"type":"object","properties":{"text":{"description":"Original post text, or null when unavailable.","type":["string","null"]},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Original post URL, or null when unavailable."},"publishedAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Original LinkedIn publication time, or null when unavailable."},"author":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"],"description":"Original post author. ID and LinkedIn URL are null when the repost source did not provide them."},"media":{"type":"object","properties":{"kind":{"type":"string","enum":["None","Image","Video"],"description":"Media kind indicated by the LinkedIn post."},"urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"Available media URLs. Empty for no media and currently also for video posts because production does not persist a video URL."}},"required":["kind","urls"]},"externalLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Destination linked from the LinkedIn post."},"caption":{"description":"Link/article caption, or null when LinkedIn did not provide one.","type":["string","null"]},"summary":{"description":"Available post/link summary, or null when none was stored.","type":["string","null"]}},"required":["url","caption","summary"]},{"type":"null"}]}},"required":["text","linkedInUrl","publishedAt","author","media","externalLink"]},{"type":"null"}],"description":"Original post for a repost-with-text, or null when this is not a repost."}},"required":["text","linkedInUrl","publishedAt","format","likeCount","media","externalLink","originalPost"]},"draft":{"anyOf":[{"type":"object","properties":{"text":{"type":"string","minLength":1,"description":"Effective comment text that will be posted if the action includes a comment."},"source":{"type":"string","enum":["Extrovert-generated","Agent-authored"],"description":"Who supplied the effective text. Agent-authored includes edits that override an Extrovert-generated body."},"updatedAt":{"type":"string","description":"When the effective draft last changed.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}},"required":["text","source","updatedAt"]},{"type":"null"}],"description":"Current effective draft, or null when no comment text exists or React only needs none."},"reactionBehavior":{"anyOf":[{"oneOf":[{"type":"object","properties":{"behavior":{"type":"string","const":"Comment only"},"reaction":{"type":"null","description":"No LinkedIn reaction is sent in Comment only mode."}},"required":["behavior","reaction"]},{"type":"object","properties":{"behavior":{"type":"string","const":"Comment and react"},"reaction":{"type":"string","enum":["Like","Celebrate","Support","Love","Insightful","Funny"],"description":"LinkedIn reaction sent with the approved comment."}},"required":["behavior","reaction"]},{"type":"object","properties":{"behavior":{"type":"string","const":"React only"},"reaction":{"type":"string","enum":["Like","Celebrate","Support","Love","Insightful","Funny"],"description":"LinkedIn reaction sent without a comment."}},"required":["behavior","reaction"]}]},{"type":"null"}],"description":"Selected comment/reaction behavior, or null before a behavior has been initialized."},"state":{"type":"string","enum":["Generating","Need approval","Pending","Error","Posted","Skipped"]},"plannedAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Planned posting time. Set only when the campaign spaces approved comments with a posting interval; null when posting starts immediately after approval — even while the comment is Pending or already Posted."},"completedAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Posting/skip completion time, or null before a terminal result."},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","description":"Stable public error code suitable for branching. It is not a raw provider or backend status."},"message":{"type":"string","description":"Safe explanation of what failed and what the caller should do next."},"retryable":{"type":"boolean","description":"Whether retrying may succeed after the stated condition is resolved."},"occurredAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"When this failure was recorded, or null when no reliable timestamp exists."}},"required":["code","message","retryable","occurredAt"]},{"type":"null"}],"description":"Current generation/posting failure, or null when no failure is active."},"allowedActions":{"type":"array","items":{"type":"string","enum":["generate-or-improve-draft","set-draft-text","skip-and-react","approve","cancel-posting","skip","unskip"]},"description":"Actions valid for the current state."},"updatedAt":{"type":"string","description":"Latest owner-global comment state change.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}},"required":["postId","ownerId","author","prospect","engagementRoute","campaign","prospectList","keyword","topic","engagementContexts","post","draft","reactionBehavior","state","plannedAt","completedAt","error","allowedActions","updatedAt"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GenerateDraftsRequestDto":{"type":"object","properties":{"ownerId":{"type":"string","format":"uuid","description":"LinkedIn account owner whose comments are addressed. Often a managed account rather than the authenticated user."},"items":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"object","properties":{"postId":{"type":"string","format":"uuid","description":"Post to generate a comment draft for."},"campaignId":{"description":"Accessible campaign whose Voice must be used. When omitted, the post's own campaign is used.","type":"string","format":"uuid"}},"required":["postId"]},"description":"Freshly generate 1–10 drafts. This replaces existing reviewable text for each post+owner and may change React only to Comment and react; review results before approval."}},"required":["ownerId","items"]},"GenerateDraftsResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Position of the element in the request list, starting at 0."},"id":{"description":"Element ID. Present for every updated or deleted element, and for a created element once it was saved.","type":"string","format":"uuid"},"item":{"description":"The element as saved. Absent when the element failed.","type":"object","properties":{"postId":{"type":"string","format":"uuid","description":"LinkedIn post identity inside Extrovert.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"ownerId":{"type":"string","format":"uuid","description":"LinkedIn account owner whose profile will engage with the post.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"author":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"],"description":"Person whose post receives the engagement."},"prospect":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"]},{"type":"null"}],"description":"Primary relationship target: the author for Direct, another person for Indirect, and null for Topical engagement."},"engagementRoute":{"type":"string","enum":["Direct","Indirect","Topical"]},"campaign":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},"prospectList":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}]},"keyword":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}]},"topic":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}]},"engagementContexts":{"minItems":1,"type":"array","items":{"type":"object","properties":{"campaign":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"],"description":"Campaign in which this engagement context is visible."},"prospectList":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Prospect List for this context, or null outside a Prospect List."},"keyword":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Tracked keyword for this context, or null outside Keyword collection."},"topic":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Matched Monitored Topic, or null when no topic was assigned."},"engagementRoute":{"type":"string","enum":["Direct","Indirect","Topical"],"description":"Direct means engaging on the prospect's post; Indirect means engaging on another author's post to warm the prospect; Topical has no prospect."},"prospect":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"]},{"type":"null"}],"description":"Effective relationship target for this context; null only for Topical engagement without a prospect."}},"required":["campaign","prospectList","keyword","topic","engagementRoute","prospect"]},"description":"All visible relationship contexts for this physical comment. The first context is mirrored in the top-level context fields."},"post":{"type":"object","properties":{"text":{"description":"LinkedIn post text, or null when the post contains no stored text.","type":["string","null"]},"linkedInUrl":{"type":"string","format":"uri","description":"LinkedIn URL of the post receiving the engagement."},"publishedAt":{"type":"string","description":"When the post was published on LinkedIn.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"format":{"type":"string","enum":["Text","Image","Video","Link","Article","Poll","Job","Celebration"],"description":"Customer-facing post format."},"likeCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"LinkedIn like count, or null when it cannot be parsed reliably."},"media":{"type":"object","properties":{"kind":{"type":"string","enum":["None","Image","Video"],"description":"Media kind indicated by the LinkedIn post."},"urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"Available media URLs. Empty for no media and currently also for video posts because production does not persist a video URL."}},"required":["kind","urls"]},"externalLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Destination linked from the LinkedIn post."},"caption":{"description":"Link/article caption, or null when LinkedIn did not provide one.","type":["string","null"]},"summary":{"description":"Available post/link summary, or null when none was stored.","type":["string","null"]}},"required":["url","caption","summary"]},{"type":"null"}],"description":"Link/article metadata, or null when the post has no external link."},"originalPost":{"anyOf":[{"type":"object","properties":{"text":{"description":"Original post text, or null when unavailable.","type":["string","null"]},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Original post URL, or null when unavailable."},"publishedAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Original LinkedIn publication time, or null when unavailable."},"author":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"],"description":"Original post author. ID and LinkedIn URL are null when the repost source did not provide them."},"media":{"type":"object","properties":{"kind":{"type":"string","enum":["None","Image","Video"],"description":"Media kind indicated by the LinkedIn post."},"urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"Available media URLs. Empty for no media and currently also for video posts because production does not persist a video URL."}},"required":["kind","urls"]},"externalLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Destination linked from the LinkedIn post."},"caption":{"description":"Link/article caption, or null when LinkedIn did not provide one.","type":["string","null"]},"summary":{"description":"Available post/link summary, or null when none was stored.","type":["string","null"]}},"required":["url","caption","summary"]},{"type":"null"}]}},"required":["text","linkedInUrl","publishedAt","author","media","externalLink"]},{"type":"null"}],"description":"Original post for a repost-with-text, or null when this is not a repost."}},"required":["text","linkedInUrl","publishedAt","format","likeCount","media","externalLink","originalPost"]},"draft":{"anyOf":[{"type":"object","properties":{"text":{"type":"string","minLength":1,"description":"Effective comment text that will be posted if the action includes a comment."},"source":{"type":"string","enum":["Extrovert-generated","Agent-authored"],"description":"Who supplied the effective text. Agent-authored includes edits that override an Extrovert-generated body."},"updatedAt":{"type":"string","description":"When the effective draft last changed.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}},"required":["text","source","updatedAt"]},{"type":"null"}],"description":"Current effective draft, or null when no comment text exists or React only needs none."},"reactionBehavior":{"anyOf":[{"oneOf":[{"type":"object","properties":{"behavior":{"type":"string","const":"Comment only"},"reaction":{"type":"null","description":"No LinkedIn reaction is sent in Comment only mode."}},"required":["behavior","reaction"]},{"type":"object","properties":{"behavior":{"type":"string","const":"Comment and react"},"reaction":{"type":"string","enum":["Like","Celebrate","Support","Love","Insightful","Funny"],"description":"LinkedIn reaction sent with the approved comment."}},"required":["behavior","reaction"]},{"type":"object","properties":{"behavior":{"type":"string","const":"React only"},"reaction":{"type":"string","enum":["Like","Celebrate","Support","Love","Insightful","Funny"],"description":"LinkedIn reaction sent without a comment."}},"required":["behavior","reaction"]}]},{"type":"null"}],"description":"Selected comment/reaction behavior, or null before a behavior has been initialized."},"state":{"type":"string","enum":["Generating","Need approval","Pending","Error","Posted","Skipped"]},"plannedAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Planned posting time. Set only when the campaign spaces approved comments with a posting interval; null when posting starts immediately after approval — even while the comment is Pending or already Posted."},"completedAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Posting/skip completion time, or null before a terminal result."},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","description":"Stable public error code suitable for branching. It is not a raw provider or backend status."},"message":{"type":"string","description":"Safe explanation of what failed and what the caller should do next."},"retryable":{"type":"boolean","description":"Whether retrying may succeed after the stated condition is resolved."},"occurredAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"When this failure was recorded, or null when no reliable timestamp exists."}},"required":["code","message","retryable","occurredAt"]},{"type":"null"}],"description":"Current generation/posting failure, or null when no failure is active."},"allowedActions":{"type":"array","items":{"type":"string","enum":["generate-or-improve-draft","set-draft-text","skip-and-react","approve","cancel-posting","skip","unskip"]},"description":"Actions valid for the current state."},"updatedAt":{"type":"string","description":"Latest owner-global comment state change.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}},"required":["postId","ownerId","author","prospect","engagementRoute","campaign","prospectList","keyword","topic","engagementContexts","post","draft","reactionBehavior","state","plannedAt","completedAt","error","allowedActions","updatedAt"]},"error":{"description":"Why this element was not applied. Absent when the element succeeded; the other elements are unaffected.","type":"object","properties":{"code":{"type":"string","description":"Status name of the failure, e.g. `NOT_FOUND`, `PERMISSION_DENIED`, `INVALID_ARGUMENT`, `INTERNAL`."},"message":{"type":"string","description":"Human-readable reason this element was not applied."}},"required":["code","message"]}},"required":["index"]},"description":"One result per requested post, in request order: the generated comment, or the reason it was not generated"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"SetDraftTextRequestDto":{"type":"object","properties":{"postId":{"type":"string","format":"uuid","description":"LinkedIn post identity inside Extrovert."},"ownerId":{"type":"string","format":"uuid","description":"LinkedIn account owner whose comment is addressed. Often a managed account rather than the authenticated user — call `user_list-shared` first and pick the owner whose LinkedIn profile runs the campaign."},"text":{"type":"string","minLength":1,"maxLength":1250,"description":"Replacement draft text; surrounding whitespace is trimmed. Empty text cannot clear it. This does not generate or post."}},"required":["postId","ownerId","text"]},"SetDraftTextResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"SkipAndReactRequestDto":{"type":"object","properties":{"postId":{"type":"string","format":"uuid","description":"LinkedIn post identity inside Extrovert."},"ownerId":{"type":"string","format":"uuid","description":"LinkedIn account owner whose comment is addressed. Often a managed account rather than the authenticated user — call `user_list-shared` first and pick the owner whose LinkedIn profile runs the campaign."},"reaction":{"type":"string","enum":["Like","Celebrate","Support","Love","Insightful","Funny"],"description":"LinkedIn reaction to queue instead of publishing the comment."}},"required":["postId","ownerId","reaction"]},"SkipAndReactResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"ApproveRequestDto":{"type":"object","properties":{"postId":{"type":"string","format":"uuid","description":"LinkedIn post identity inside Extrovert."},"ownerId":{"type":"string","format":"uuid","description":"LinkedIn account owner whose comment is addressed. Often a managed account rather than the authenticated user — call `user_list-shared` first and pick the owner whose LinkedIn profile runs the campaign."}},"required":["postId","ownerId"]},"ApproveResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"BulkApproveRequestDto":{"type":"object","properties":{"ownerId":{"type":"string","format":"uuid","description":"LinkedIn account owner whose comment is addressed. Often a managed account rather than the authenticated user — call `user_list-shared` first and pick the owner whose LinkedIn profile runs the campaign."},"campaignId":{"type":"string","description":"Campaign to stay inside. Omit for the owner-wide feed — every campaign of this owner the caller may update.","format":"uuid"},"count":{"type":"integer","minimum":1,"maximum":100,"description":"How many of the scope's most relevant comments to attempt, from 1 to 100. The upper bound is a per-request transport limit, not a daily or product maximum.","examples":[10]}},"required":["ownerId","count"]},"BulkApproveResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"accepted":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Comments approved by this request. Accepted is not published: each one enters the ordinary Pending/publication lifecycle and adds 1 to today's Comment Today progress."},"skippedStale":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Comments that were no longer approvable when their turn came — already taken by a concurrent action or no longer eligible. They are left untouched."},"failedToAccept":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Comments that failed with an error while being approved. The comments already accepted by this request are unaffected."}},"required":["accepted","skippedStale","failedToAccept"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"CancelPostingRequestDto":{"type":"object","properties":{"postId":{"type":"string","format":"uuid","description":"LinkedIn post identity inside Extrovert."},"ownerId":{"type":"string","format":"uuid","description":"LinkedIn account owner whose comment is addressed. Often a managed account rather than the authenticated user — call `user_list-shared` first and pick the owner whose LinkedIn profile runs the campaign."}},"required":["postId","ownerId"]},"CancelPostingResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"SkipRequestDto":{"type":"object","properties":{"postId":{"type":"string","format":"uuid","description":"LinkedIn post identity inside Extrovert."},"ownerId":{"type":"string","format":"uuid","description":"LinkedIn account owner whose comment is addressed. Often a managed account rather than the authenticated user — call `user_list-shared` first and pick the owner whose LinkedIn profile runs the campaign."}},"required":["postId","ownerId"]},"SkipResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"UnskipRequestDto":{"type":"object","properties":{"postId":{"type":"string","format":"uuid","description":"LinkedIn post identity inside Extrovert."},"ownerId":{"type":"string","format":"uuid","description":"LinkedIn account owner whose comment is addressed. Often a managed account rather than the authenticated user — call `user_list-shared` first and pick the owner whose LinkedIn profile runs the campaign."}},"required":["postId","ownerId"]},"UnskipResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetListResponseDto4":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"comments":{"type":"array","items":{"type":"object","properties":{"postId":{"type":"string","format":"uuid","description":"LinkedIn post identity inside Extrovert.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"ownerId":{"type":"string","format":"uuid","description":"LinkedIn account owner whose profile will engage with the post.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"author":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"],"description":"Person whose post receives the engagement."},"prospect":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"]},{"type":"null"}],"description":"Primary relationship target: the author for Direct, another person for Indirect, and null for Topical engagement."},"engagementRoute":{"type":"string","enum":["Direct","Indirect","Topical"]},"campaign":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},"prospectList":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}]},"keyword":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}]},"topic":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}]},"engagementContexts":{"minItems":1,"type":"array","items":{"type":"object","properties":{"campaign":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"],"description":"Campaign in which this engagement context is visible."},"prospectList":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Prospect List for this context, or null outside a Prospect List."},"keyword":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Tracked keyword for this context, or null outside Keyword collection."},"topic":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Matched Monitored Topic, or null when no topic was assigned."},"engagementRoute":{"type":"string","enum":["Direct","Indirect","Topical"],"description":"Direct means engaging on the prospect's post; Indirect means engaging on another author's post to warm the prospect; Topical has no prospect."},"prospect":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"]},{"type":"null"}],"description":"Effective relationship target for this context; null only for Topical engagement without a prospect."}},"required":["campaign","prospectList","keyword","topic","engagementRoute","prospect"]},"description":"All visible relationship contexts for this physical comment. The first context is mirrored in the top-level context fields."},"post":{"type":"object","properties":{"text":{"description":"LinkedIn post text, or null when the post contains no stored text.","type":["string","null"]},"linkedInUrl":{"type":"string","format":"uri","description":"LinkedIn URL of the post receiving the engagement."},"publishedAt":{"type":"string","description":"When the post was published on LinkedIn.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"format":{"type":"string","enum":["Text","Image","Video","Link","Article","Poll","Job","Celebration"],"description":"Customer-facing post format."},"likeCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"LinkedIn like count, or null when it cannot be parsed reliably."},"media":{"type":"object","properties":{"kind":{"type":"string","enum":["None","Image","Video"],"description":"Media kind indicated by the LinkedIn post."},"urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"Available media URLs. Empty for no media and currently also for video posts because production does not persist a video URL."}},"required":["kind","urls"]},"externalLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Destination linked from the LinkedIn post."},"caption":{"description":"Link/article caption, or null when LinkedIn did not provide one.","type":["string","null"]},"summary":{"description":"Available post/link summary, or null when none was stored.","type":["string","null"]}},"required":["url","caption","summary"]},{"type":"null"}],"description":"Link/article metadata, or null when the post has no external link."},"originalPost":{"anyOf":[{"type":"object","properties":{"text":{"description":"Original post text, or null when unavailable.","type":["string","null"]},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Original post URL, or null when unavailable."},"publishedAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Original LinkedIn publication time, or null when unavailable."},"author":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"],"description":"Original post author. ID and LinkedIn URL are null when the repost source did not provide them."},"media":{"type":"object","properties":{"kind":{"type":"string","enum":["None","Image","Video"],"description":"Media kind indicated by the LinkedIn post."},"urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"Available media URLs. Empty for no media and currently also for video posts because production does not persist a video URL."}},"required":["kind","urls"]},"externalLink":{"anyOf":[{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Destination linked from the LinkedIn post."},"caption":{"description":"Link/article caption, or null when LinkedIn did not provide one.","type":["string","null"]},"summary":{"description":"Available post/link summary, or null when none was stored.","type":["string","null"]}},"required":["url","caption","summary"]},{"type":"null"}]}},"required":["text","linkedInUrl","publishedAt","author","media","externalLink"]},{"type":"null"}],"description":"Original post for a repost-with-text, or null when this is not a repost."}},"required":["text","linkedInUrl","publishedAt","format","likeCount","media","externalLink","originalPost"]},"draft":{"anyOf":[{"type":"object","properties":{"text":{"type":"string","minLength":1,"description":"Effective comment text that will be posted if the action includes a comment."},"source":{"type":"string","enum":["Extrovert-generated","Agent-authored"],"description":"Who supplied the effective text. Agent-authored includes edits that override an Extrovert-generated body."},"updatedAt":{"type":"string","description":"When the effective draft last changed.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}},"required":["text","source","updatedAt"]},{"type":"null"}],"description":"Current effective draft, or null when no comment text exists or React only needs none."},"reactionBehavior":{"anyOf":[{"oneOf":[{"type":"object","properties":{"behavior":{"type":"string","const":"Comment only"},"reaction":{"type":"null","description":"No LinkedIn reaction is sent in Comment only mode."}},"required":["behavior","reaction"]},{"type":"object","properties":{"behavior":{"type":"string","const":"Comment and react"},"reaction":{"type":"string","enum":["Like","Celebrate","Support","Love","Insightful","Funny"],"description":"LinkedIn reaction sent with the approved comment."}},"required":["behavior","reaction"]},{"type":"object","properties":{"behavior":{"type":"string","const":"React only"},"reaction":{"type":"string","enum":["Like","Celebrate","Support","Love","Insightful","Funny"],"description":"LinkedIn reaction sent without a comment."}},"required":["behavior","reaction"]}]},{"type":"null"}],"description":"Selected comment/reaction behavior, or null before a behavior has been initialized."},"state":{"type":"string","enum":["Generating","Need approval","Pending","Error","Posted","Skipped"]},"plannedAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Planned posting time. Set only when the campaign spaces approved comments with a posting interval; null when posting starts immediately after approval — even while the comment is Pending or already Posted."},"completedAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Posting/skip completion time, or null before a terminal result."},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","description":"Stable public error code suitable for branching. It is not a raw provider or backend status."},"message":{"type":"string","description":"Safe explanation of what failed and what the caller should do next."},"retryable":{"type":"boolean","description":"Whether retrying may succeed after the stated condition is resolved."},"occurredAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"When this failure was recorded, or null when no reliable timestamp exists."}},"required":["code","message","retryable","occurredAt"]},{"type":"null"}],"description":"Current generation/posting failure, or null when no failure is active."},"allowedActions":{"type":"array","items":{"type":"string","enum":["generate-or-improve-draft","set-draft-text","skip-and-react","approve","cancel-posting","skip","unskip"]},"description":"Actions valid for the current state."},"updatedAt":{"type":"string","description":"Latest owner-global comment state change.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}},"required":["postId","ownerId","author","prospect","engagementRoute","campaign","prospectList","keyword","topic","engagementContexts","post","draft","reactionBehavior","state","plannedAt","completedAt","error","allowedActions","updatedAt"]}},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of records requested for this page."},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Offset from the start of the filtered result set."},"total":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Total records available for the same filters."}},"required":["limit","offset","total"],"description":"Pagination information, if returned by the backend"}},"required":["comments","pagination"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetResponseDto5":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"dailyGoal":{"type":"integer","minimum":1,"maximum":9007199254740991,"description":"Daily approval goal currently in effect for the owner. The backend default applies when no explicit goal was set."},"progress":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of comment approvals accepted today for the owner-local calendar day. May exceed the goal."}},"required":["dailyGoal","progress"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"SetGoalRequestDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"ID of the publishing owner (user) whose Comment Today state is addressed. The daily goal and progress are tracked per owner.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"dailyGoal":{"type":"integer","minimum":1,"maximum":9007199254740991,"description":"New daily approval goal. Positive integer, minimum 1.","examples":[10]}},"required":["id","dailyGoal"]},"SetGoalResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetVoiceListResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Comment Example ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Comment Example update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Comment Example creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"text":{"type":"string","description":"Text of the example comment — used as a writing-style sample when generating comments under the parent Voice. All Comment Examples attached to a Voice are used together. Up to 1250 characters."},"voiceId":{"type":"string","format":"uuid","description":"ID of the Voice this Comment Example belongs to. See the `voices` config for the full Voice shape. When the Voice is deleted, all its Comment Examples are deleted in cascade.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]}},"required":["id","updatedAt","createdAt","text","voiceId"]},"description":"Comment Examples attached to the requested Voice"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetByIdResponseDto2":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","description":"Loaded Comment Example","properties":{"id":{"type":"string","format":"uuid","description":"Comment Example ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Comment Example update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Comment Example creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"text":{"type":"string","description":"Text of the example comment — used as a writing-style sample when generating comments under the parent Voice. All Comment Examples attached to a Voice are used together. Up to 1250 characters."},"voiceId":{"type":"string","format":"uuid","description":"ID of the Voice this Comment Example belongs to. See the `voices` config for the full Voice shape. When the Voice is deleted, all its Comment Examples are deleted in cascade.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]}},"required":["id","updatedAt","createdAt","text","voiceId"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"CreateRequestDto4":{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"object","properties":{"voiceId":{"type":"string","format":"uuid","description":"Shared Voice to attach this comment example to; future comment generations across its campaigns and workspaces can use it."},"text":{"type":"string","description":"Text of the example comment. Up to 1250 characters, must be non-blank."}},"required":["voiceId","text"]},"description":"Elements to apply, 1 to 25. Each element is applied on its own and gets its own result, in the same order; a failed element does not affect the others."}},"required":["items"]},"CreateResponseDto4":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Position of the element in the request list, starting at 0."},"id":{"description":"Element ID. Present for every updated or deleted element, and for a created element once it was saved.","type":"string","format":"uuid"},"item":{"description":"The element as saved. Absent when the element failed.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Comment Example ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Comment Example update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Comment Example creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"text":{"type":"string","description":"Text of the example comment — used as a writing-style sample when generating comments under the parent Voice. All Comment Examples attached to a Voice are used together. Up to 1250 characters."},"voiceId":{"type":"string","format":"uuid","description":"ID of the Voice this Comment Example belongs to. See the `voices` config for the full Voice shape. When the Voice is deleted, all its Comment Examples are deleted in cascade.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]}},"required":["id","updatedAt","createdAt","text","voiceId"]},"error":{"description":"Why this element was not applied. Absent when the element succeeded; the other elements are unaffected.","type":"object","properties":{"code":{"type":"string","description":"Status name of the failure, e.g. `NOT_FOUND`, `PERMISSION_DENIED`, `INVALID_ARGUMENT`, `INTERNAL`."},"message":{"type":"string","description":"Human-readable reason this element was not applied."}},"required":["code","message"]}},"required":["index"]},"description":"One result per requested Comment Example, in request order"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"UpdateRequestDto4":{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Example to replace on its shared Voice; future generations across the Voice’s campaigns and workspaces can use the change."},"text":{"type":"string","description":"New text for the example comment. Up to 1250 characters, must be non-blank."}},"required":["id","text"]},"description":"Elements to apply, 1 to 25. Each element is applied on its own and gets its own result, in the same order; a failed element does not affect the others."}},"required":["items"]},"UpdateResponseDto4":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Position of the element in the request list, starting at 0."},"id":{"description":"Element ID. Present for every updated or deleted element, and for a created element once it was saved.","type":"string","format":"uuid"},"item":{"description":"The element as saved. Absent when the element failed.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Comment Example ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Comment Example update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Comment Example creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"text":{"type":"string","description":"Text of the example comment — used as a writing-style sample when generating comments under the parent Voice. All Comment Examples attached to a Voice are used together. Up to 1250 characters."},"voiceId":{"type":"string","format":"uuid","description":"ID of the Voice this Comment Example belongs to. See the `voices` config for the full Voice shape. When the Voice is deleted, all its Comment Examples are deleted in cascade.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]}},"required":["id","updatedAt","createdAt","text","voiceId"]},"error":{"description":"Why this element was not applied. Absent when the element succeeded; the other elements are unaffected.","type":"object","properties":{"code":{"type":"string","description":"Status name of the failure, e.g. `NOT_FOUND`, `PERMISSION_DENIED`, `INVALID_ARGUMENT`, `INTERNAL`."},"message":{"type":"string","description":"Human-readable reason this element was not applied."}},"required":["code","message"]}},"required":["index"]},"description":"One result per requested Comment Example, in request order"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"DeleteResponseDto5":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Position of the element in the request list, starting at 0."},"id":{"description":"Element ID. Present for every updated or deleted element, and for a created element once it was saved.","type":"string","format":"uuid"},"error":{"description":"Why this element was not applied. Absent when the element succeeded; the other elements are unaffected.","type":"object","properties":{"code":{"type":"string","description":"Status name of the failure, e.g. `NOT_FOUND`, `PERMISSION_DENIED`, `INVALID_ARGUMENT`, `INTERNAL`."},"message":{"type":"string","description":"Human-readable reason this element was not applied."}},"required":["code","message"]}},"required":["index"]},"description":"One result per requested id, in request order"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetOwnerListResponseDto2":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Monitored Topic ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Timestamp of the most recent update to the Monitored Topic.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Timestamp when the Monitored Topic was created.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Short topic name (e.g. 'AI agents', 'B2B SaaS pricing')."},"description":{"type":"string","description":"Describe what makes a post qualify for this topic — what it should be about, and what should be excluded. Used by the AI matcher when scanning posts."},"campaign":{"description":"Topic campaign this Monitored Topic is bound to, if any - only `id` and `name` are exposed. Omitted in JSON when the topic is not bound to a campaign.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]}},"required":["id","updatedAt","createdAt","name","description"]},"description":"Monitored Topics owned by the requested user."},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"CreateRequestDto5":{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Topic name also feeds search-string generation with its description; it is not only a display label.","examples":["AI agents","B2B SaaS pricing"]},"description":{"type":"string","minLength":1,"maxLength":400,"description":"Matching scope and exclusions (up to 400 characters); used with the name to generate Topic-campaign searches and classify posts. Editing a bound topic regenerates its campaign's full topic set before an atomic save."},"ownerId":{"type":"string","format":"uuid","description":"Owner user ID. You may use your own account; access to another owner requires permitted workspace customization access to that creator or access through a campaign shared by that owner. Workspace membership alone is not sufficient.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]}},"required":["name","description","ownerId"]},"description":"Elements to apply, 1 to 25. Each element is applied on its own and gets its own result, in the same order; a failed element does not affect the others."}},"required":["items"]},"CreateResponseDto5":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Position of the element in the request list, starting at 0."},"id":{"description":"Element ID. Present for every updated or deleted element, and for a created element once it was saved.","type":"string","format":"uuid"},"item":{"description":"The element as saved. Absent when the element failed.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Monitored Topic ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Timestamp of the most recent update to the Monitored Topic.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Timestamp when the Monitored Topic was created.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Short topic name (e.g. 'AI agents', 'B2B SaaS pricing')."},"description":{"type":"string","description":"Describe what makes a post qualify for this topic — what it should be about, and what should be excluded. Used by the AI matcher when scanning posts."},"campaign":{"description":"Topic campaign this Monitored Topic is bound to, if any - only `id` and `name` are exposed. Omitted in JSON when the topic is not bound to a campaign.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]}},"required":["id","updatedAt","createdAt","name","description"]},"error":{"description":"Why this element was not applied. Absent when the element succeeded; the other elements are unaffected.","type":"object","properties":{"code":{"type":"string","description":"Status name of the failure, e.g. `NOT_FOUND`, `PERMISSION_DENIED`, `INVALID_ARGUMENT`, `INTERNAL`."},"message":{"type":"string","description":"Human-readable reason this element was not applied."}},"required":["code","message"]}},"required":["index"]},"description":"One result per requested Monitored Topic, in request order."},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"UpdateRequestDto5":{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"ID of the Monitored Topic to update.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","minLength":1,"description":"Topic name also feeds search-string generation with its description; it is not only a display label.","examples":["AI agents","B2B SaaS pricing"]},"description":{"type":"string","minLength":1,"maxLength":400,"description":"Matching scope and exclusions (up to 400 characters); used with the name to generate Topic-campaign searches and classify posts. Editing a bound topic regenerates its campaign's full topic set before an atomic save."}},"required":["id","name","description"]},"description":"Elements to apply, 1 to 25. Each element is applied on its own and gets its own result, in the same order; a failed element does not affect the others."}},"required":["items"]},"UpdateResponseDto5":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Position of the element in the request list, starting at 0."},"id":{"description":"Element ID. Present for every updated or deleted element, and for a created element once it was saved.","type":"string","format":"uuid"},"item":{"description":"The element as saved. Absent when the element failed.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Monitored Topic ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Timestamp of the most recent update to the Monitored Topic.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Timestamp when the Monitored Topic was created.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Short topic name (e.g. 'AI agents', 'B2B SaaS pricing')."},"description":{"type":"string","description":"Describe what makes a post qualify for this topic — what it should be about, and what should be excluded. Used by the AI matcher when scanning posts."},"campaign":{"description":"Topic campaign this Monitored Topic is bound to, if any - only `id` and `name` are exposed. Omitted in JSON when the topic is not bound to a campaign.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]}},"required":["id","updatedAt","createdAt","name","description"]},"error":{"description":"Why this element was not applied. Absent when the element succeeded; the other elements are unaffected.","type":"object","properties":{"code":{"type":"string","description":"Status name of the failure, e.g. `NOT_FOUND`, `PERMISSION_DENIED`, `INVALID_ARGUMENT`, `INTERNAL`."},"message":{"type":"string","description":"Human-readable reason this element was not applied."}},"required":["code","message"]}},"required":["index"]},"description":"One result per requested Monitored Topic, in request order."},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"DeleteResponseDto6":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Position of the element in the request list, starting at 0."},"id":{"description":"Element ID. Present for every updated or deleted element, and for a created element once it was saved.","type":"string","format":"uuid"},"error":{"description":"Why this element was not applied. Absent when the element succeeded; the other elements are unaffected.","type":"object","properties":{"code":{"type":"string","description":"Status name of the failure, e.g. `NOT_FOUND`, `PERMISSION_DENIED`, `INVALID_ARGUMENT`, `INTERNAL`."},"message":{"type":"string","description":"Human-readable reason this element was not applied."}},"required":["code","message"]}},"required":["index"]},"description":"One result per requested id, in request order."},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetByCampaignResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"ID of the Topic binding that links a Topic campaign to a Monitored Topic.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Timestamp of the most recent update to the binding.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Timestamp when the binding was created.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"campaignId":{"type":"string","format":"uuid","description":"ID of the Topic campaign this binding belongs to.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]},"monitoredTopic":{"description":"Reference to the Monitored Topic attached to this binding — carries only `id` and `name`. The topic's `description`, which the AI matcher uses to decide whether a post qualifies, is NOT included here. Missing when the source Monitored Topic has been deleted — in that case fall back to `monitoredTopicName` for the last known name.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Monitored Topic ID. See the `monitored-topics` config for the full Monitored Topic shape.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Monitored Topic name. See the `monitored-topics` config for the full Monitored Topic shape."}},"required":["id","name"]},"monitoredTopicName":{"type":"string","description":"Name of the Monitored Topic (the user-facing \"Topic name\"), denormalized onto the binding so it survives deletion of the source Monitored Topic. When `monitoredTopic` is present this matches `monitoredTopic.name`; when it is missing this is the only source of the name."},"statistics":{"description":"Lightweight stats block for the binding.","type":"object","properties":{"lastSuccessfulPostFetchDate":{"description":"Timestamp of the last successful run that fetched new relevant posts for this binding, if any run has completed.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}}}},"required":["id","updatedAt","createdAt","campaignId","monitoredTopicName"]},"description":"Monitored Topic bindings currently attached to the requested Topic campaign."},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"ToggleBulkRequestDto":{"type":"object","properties":{"campaignId":{"type":"string","format":"uuid","description":"ID of the Topic campaign to update."},"monitoredTopicIds":{"type":"array","maxItems":1000,"items":{"type":"string","format":"uuid"},"description":"Full replacement of attached topic IDs; `[]` detaches all. Each topic must belong to the campaign owner and may have only one active Topic-campaign binding. New attachments require `CAN_USE_TOPIC_CAMPAIGNS` and Topic Capacity; resubmitting/removing needs no new feature admission."},"rejectPendingPostsForDetachedTopics":{"type":"boolean","description":"Reject pending-approval posts only for topics detached by this call. No detached topics means no effect; this does not clear the entire campaign queue. One-shot action, not persisted state."}},"required":["campaignId","monitoredTopicIds","rejectPendingPostsForDetachedTopics"]},"ToggleBulkResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetVoiceListResponseDto2":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Talking Point ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Talking Point update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Talking Point creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"text":{"type":"string","description":"A single idea, fact, or point of view used as context when generating comments — industry observations, product benefits, hot takes, advice you'd give peers, thoughts that add value. All Talking Points attached to the parent Voice are used together as comment-generation context. Up to 750 characters."},"voiceId":{"type":"string","format":"uuid","description":"ID of the Voice this Talking Point belongs to. See the `voices` config for the full Voice shape. When the Voice is deleted, all its Talking Points are deleted in cascade.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]}},"required":["id","updatedAt","createdAt","text","voiceId"]},"description":"Talking Points attached to the requested Voice"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetByIdResponseDto3":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Talking Point ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Talking Point update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Talking Point creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"text":{"type":"string","description":"A single idea, fact, or point of view used as context when generating comments — industry observations, product benefits, hot takes, advice you'd give peers, thoughts that add value. All Talking Points attached to the parent Voice are used together as comment-generation context. Up to 750 characters."},"voiceId":{"type":"string","format":"uuid","description":"ID of the Voice this Talking Point belongs to. See the `voices` config for the full Voice shape. When the Voice is deleted, all its Talking Points are deleted in cascade.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]}},"description":"Loaded Talking Point","required":["id","updatedAt","createdAt","text","voiceId"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"CreateRequestDto7":{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"object","properties":{"voiceId":{"type":"string","format":"uuid","description":"Shared Voice to attach this talking point to; future comment generations across its campaigns and workspaces can use it."},"text":{"type":"string","minLength":1,"description":"The Talking Point text — one self-contained thought. Up to 750 characters."}},"required":["voiceId","text"]},"description":"Elements to apply, 1 to 25. Each element is applied on its own and gets its own result, in the same order; a failed element does not affect the others."}},"required":["items"]},"CreateResponseDto7":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Position of the element in the request list, starting at 0."},"id":{"description":"Element ID. Present for every updated or deleted element, and for a created element once it was saved.","type":"string","format":"uuid"},"item":{"description":"The element as saved. Absent when the element failed.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Talking Point ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Talking Point update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Talking Point creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"text":{"type":"string","description":"A single idea, fact, or point of view used as context when generating comments — industry observations, product benefits, hot takes, advice you'd give peers, thoughts that add value. All Talking Points attached to the parent Voice are used together as comment-generation context. Up to 750 characters."},"voiceId":{"type":"string","format":"uuid","description":"ID of the Voice this Talking Point belongs to. See the `voices` config for the full Voice shape. When the Voice is deleted, all its Talking Points are deleted in cascade.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]}},"required":["id","updatedAt","createdAt","text","voiceId"]},"error":{"description":"Why this element was not applied. Absent when the element succeeded; the other elements are unaffected.","type":"object","properties":{"code":{"type":"string","description":"Status name of the failure, e.g. `NOT_FOUND`, `PERMISSION_DENIED`, `INVALID_ARGUMENT`, `INTERNAL`."},"message":{"type":"string","description":"Human-readable reason this element was not applied."}},"required":["code","message"]}},"required":["index"]},"description":"One result per requested Talking Point, in request order"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"UpdateRequestDto7":{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Talking point to replace on its shared Voice; future comment generations across its campaigns and workspaces can use the change."},"text":{"type":"string","minLength":1,"description":"New Talking Point text. Up to 750 characters."}},"required":["id","text"]},"description":"Elements to apply, 1 to 25. Each element is applied on its own and gets its own result, in the same order; a failed element does not affect the others."}},"required":["items"]},"UpdateResponseDto7":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Position of the element in the request list, starting at 0."},"id":{"description":"Element ID. Present for every updated or deleted element, and for a created element once it was saved.","type":"string","format":"uuid"},"item":{"description":"The element as saved. Absent when the element failed.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Talking Point ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Talking Point update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Talking Point creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"text":{"type":"string","description":"A single idea, fact, or point of view used as context when generating comments — industry observations, product benefits, hot takes, advice you'd give peers, thoughts that add value. All Talking Points attached to the parent Voice are used together as comment-generation context. Up to 750 characters."},"voiceId":{"type":"string","format":"uuid","description":"ID of the Voice this Talking Point belongs to. See the `voices` config for the full Voice shape. When the Voice is deleted, all its Talking Points are deleted in cascade.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]}},"required":["id","updatedAt","createdAt","text","voiceId"]},"error":{"description":"Why this element was not applied. Absent when the element succeeded; the other elements are unaffected.","type":"object","properties":{"code":{"type":"string","description":"Status name of the failure, e.g. `NOT_FOUND`, `PERMISSION_DENIED`, `INVALID_ARGUMENT`, `INTERNAL`."},"message":{"type":"string","description":"Human-readable reason this element was not applied."}},"required":["code","message"]}},"required":["index"]},"description":"One result per requested Talking Point, in request order"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"DeleteResponseDto8":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Position of the element in the request list, starting at 0."},"id":{"description":"Element ID. Present for every updated or deleted element, and for a created element once it was saved.","type":"string","format":"uuid"},"error":{"description":"Why this element was not applied. Absent when the element succeeded; the other elements are unaffected.","type":"object","properties":{"code":{"type":"string","description":"Status name of the failure, e.g. `NOT_FOUND`, `PERMISSION_DENIED`, `INVALID_ARGUMENT`, `INTERNAL`."},"message":{"type":"string","description":"Human-readable reason this element was not applied."}},"required":["code","message"]}},"required":["index"]},"description":"One result per requested id, in request order"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetVoiceListResponseDto3":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Selling Point ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Selling Point update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Selling Point creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"text":{"type":"string","description":"One fact, benefit, proof point, product capability or value proposition the AI may weave into a direct message when relevant. Up to 750 characters."},"voiceId":{"type":"string","format":"uuid","description":"ID of the Voice this Selling Point belongs to. See the `voices` config for the full Voice shape. When the Voice is deleted, all its Selling Points are deleted in cascade.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]}},"required":["id","updatedAt","createdAt","text","voiceId"]},"description":"Selling Points attached to the requested Voice"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetByIdResponseDto4":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Selling Point ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Selling Point update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Selling Point creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"text":{"type":"string","description":"One fact, benefit, proof point, product capability or value proposition the AI may weave into a direct message when relevant. Up to 750 characters."},"voiceId":{"type":"string","format":"uuid","description":"ID of the Voice this Selling Point belongs to. See the `voices` config for the full Voice shape. When the Voice is deleted, all its Selling Points are deleted in cascade.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]}},"description":"Loaded Selling Point","required":["id","updatedAt","createdAt","text","voiceId"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"CreateRequestDto8":{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"object","properties":{"voiceId":{"type":"string","format":"uuid","description":"Shared Voice to attach this selling point to; future DM generations across its campaigns and workspaces can use it."},"text":{"type":"string","minLength":1,"maxLength":750,"description":"The Selling Point text. Up to 750 characters."}},"required":["voiceId","text"]},"description":"Elements to apply, 1 to 25. Each element is applied on its own and gets its own result, in the same order; a failed element does not affect the others."}},"required":["items"]},"CreateResponseDto8":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Position of the element in the request list, starting at 0."},"id":{"description":"Element ID. Present for every updated or deleted element, and for a created element once it was saved.","type":"string","format":"uuid"},"item":{"description":"The element as saved. Absent when the element failed.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Selling Point ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Selling Point update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Selling Point creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"text":{"type":"string","description":"One fact, benefit, proof point, product capability or value proposition the AI may weave into a direct message when relevant. Up to 750 characters."},"voiceId":{"type":"string","format":"uuid","description":"ID of the Voice this Selling Point belongs to. See the `voices` config for the full Voice shape. When the Voice is deleted, all its Selling Points are deleted in cascade.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]}},"required":["id","updatedAt","createdAt","text","voiceId"]},"error":{"description":"Why this element was not applied. Absent when the element succeeded; the other elements are unaffected.","type":"object","properties":{"code":{"type":"string","description":"Status name of the failure, e.g. `NOT_FOUND`, `PERMISSION_DENIED`, `INVALID_ARGUMENT`, `INTERNAL`."},"message":{"type":"string","description":"Human-readable reason this element was not applied."}},"required":["code","message"]}},"required":["index"]},"description":"One result per requested Selling Point, in request order"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"UpdateRequestDto8":{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Selling point to replace on its shared Voice; future DM generations across its campaigns and workspaces can use the change."},"text":{"type":"string","minLength":1,"maxLength":750,"description":"New Selling Point text. Up to 750 characters."}},"required":["id","text"]},"description":"Elements to apply, 1 to 25. Each element is applied on its own and gets its own result, in the same order; a failed element does not affect the others."}},"required":["items"]},"UpdateResponseDto8":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Position of the element in the request list, starting at 0."},"id":{"description":"Element ID. Present for every updated or deleted element, and for a created element once it was saved.","type":"string","format":"uuid"},"item":{"description":"The element as saved. Absent when the element failed.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Selling Point ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Selling Point update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Selling Point creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"text":{"type":"string","description":"One fact, benefit, proof point, product capability or value proposition the AI may weave into a direct message when relevant. Up to 750 characters."},"voiceId":{"type":"string","format":"uuid","description":"ID of the Voice this Selling Point belongs to. See the `voices` config for the full Voice shape. When the Voice is deleted, all its Selling Points are deleted in cascade.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]}},"required":["id","updatedAt","createdAt","text","voiceId"]},"error":{"description":"Why this element was not applied. Absent when the element succeeded; the other elements are unaffected.","type":"object","properties":{"code":{"type":"string","description":"Status name of the failure, e.g. `NOT_FOUND`, `PERMISSION_DENIED`, `INVALID_ARGUMENT`, `INTERNAL`."},"message":{"type":"string","description":"Human-readable reason this element was not applied."}},"required":["code","message"]}},"required":["index"]},"description":"One result per requested Selling Point, in request order"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"DeleteResponseDto9":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Position of the element in the request list, starting at 0."},"id":{"description":"Element ID. Present for every updated or deleted element, and for a created element once it was saved.","type":"string","format":"uuid"},"error":{"description":"Why this element was not applied. Absent when the element succeeded; the other elements are unaffected.","type":"object","properties":{"code":{"type":"string","description":"Status name of the failure, e.g. `NOT_FOUND`, `PERMISSION_DENIED`, `INVALID_ARGUMENT`, `INTERNAL`."},"message":{"type":"string","description":"Human-readable reason this element was not applied."}},"required":["code","message"]}},"required":["index"]},"description":"One result per requested id, in request order"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetVoiceListResponseDto4":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"DM Template ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"DM Template update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"DM Template creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"text":{"type":"string","description":"Example DM text the AI may adapt for a matching situation. This is guidance, not a fixed script. Up to 750 characters."},"whenToUse":{"type":"string","description":"Short description of the situation in which this template is useful. Up to 250 characters."},"adaptation":{"type":"string","description":"Short instruction for how the AI should personalize or alter the template. Up to 250 characters."},"voiceId":{"type":"string","format":"uuid","description":"ID of the Voice this DM Template belongs to. See the `voices` config for the full Voice shape. When the Voice is deleted, all its DM Templates are deleted in cascade.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]}},"required":["id","updatedAt","createdAt","text","whenToUse","adaptation","voiceId"]},"description":"DM Templates attached to the requested Voice"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetByIdResponseDto5":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"DM Template ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"DM Template update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"DM Template creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"text":{"type":"string","description":"Example DM text the AI may adapt for a matching situation. This is guidance, not a fixed script. Up to 750 characters."},"whenToUse":{"type":"string","description":"Short description of the situation in which this template is useful. Up to 250 characters."},"adaptation":{"type":"string","description":"Short instruction for how the AI should personalize or alter the template. Up to 250 characters."},"voiceId":{"type":"string","format":"uuid","description":"ID of the Voice this DM Template belongs to. See the `voices` config for the full Voice shape. When the Voice is deleted, all its DM Templates are deleted in cascade.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]}},"description":"Loaded DM Template","required":["id","updatedAt","createdAt","text","whenToUse","adaptation","voiceId"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"CreateRequestDto9":{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"object","properties":{"voiceId":{"type":"string","format":"uuid","description":"Shared Voice to attach this DM template to; future DM generations across its campaigns and workspaces can use it."},"text":{"type":"string","minLength":1,"maxLength":750,"description":"Example DM text. Up to 750 characters."},"whenToUse":{"type":"string","minLength":1,"maxLength":250,"description":"When this template is useful. Up to 250 characters."},"adaptation":{"type":"string","minLength":1,"maxLength":250,"description":"How the AI should adapt it. Up to 250 characters."}},"required":["voiceId","text","whenToUse","adaptation"]},"description":"Elements to apply, 1 to 25. Each element is applied on its own and gets its own result, in the same order; a failed element does not affect the others."}},"required":["items"]},"CreateResponseDto9":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Position of the element in the request list, starting at 0."},"id":{"description":"Element ID. Present for every updated or deleted element, and for a created element once it was saved.","type":"string","format":"uuid"},"item":{"description":"The element as saved. Absent when the element failed.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"DM Template ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"DM Template update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"DM Template creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"text":{"type":"string","description":"Example DM text the AI may adapt for a matching situation. This is guidance, not a fixed script. Up to 750 characters."},"whenToUse":{"type":"string","description":"Short description of the situation in which this template is useful. Up to 250 characters."},"adaptation":{"type":"string","description":"Short instruction for how the AI should personalize or alter the template. Up to 250 characters."},"voiceId":{"type":"string","format":"uuid","description":"ID of the Voice this DM Template belongs to. See the `voices` config for the full Voice shape. When the Voice is deleted, all its DM Templates are deleted in cascade.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]}},"required":["id","updatedAt","createdAt","text","whenToUse","adaptation","voiceId"]},"error":{"description":"Why this element was not applied. Absent when the element succeeded; the other elements are unaffected.","type":"object","properties":{"code":{"type":"string","description":"Status name of the failure, e.g. `NOT_FOUND`, `PERMISSION_DENIED`, `INVALID_ARGUMENT`, `INTERNAL`."},"message":{"type":"string","description":"Human-readable reason this element was not applied."}},"required":["code","message"]}},"required":["index"]},"description":"One result per requested DM Template, in request order"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"UpdateRequestDto9":{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Template to update on its shared Voice. Supply `text`, `whenToUse` and `adaptation` together; omitted content fields are not preserved."},"text":{"type":"string","minLength":1,"maxLength":750,"description":"New example DM text. Up to 750 characters."},"whenToUse":{"type":"string","minLength":1,"maxLength":250,"description":"New when-to-use guidance. Up to 250 characters."},"adaptation":{"type":"string","minLength":1,"maxLength":250,"description":"New adaptation guidance. Up to 250 characters."}},"required":["id","text","whenToUse","adaptation"]},"description":"Elements to apply, 1 to 25. Each element is applied on its own and gets its own result, in the same order; a failed element does not affect the others."}},"required":["items"]},"UpdateResponseDto9":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Position of the element in the request list, starting at 0."},"id":{"description":"Element ID. Present for every updated or deleted element, and for a created element once it was saved.","type":"string","format":"uuid"},"item":{"description":"The element as saved. Absent when the element failed.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"DM Template ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"DM Template update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"DM Template creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"text":{"type":"string","description":"Example DM text the AI may adapt for a matching situation. This is guidance, not a fixed script. Up to 750 characters."},"whenToUse":{"type":"string","description":"Short description of the situation in which this template is useful. Up to 250 characters."},"adaptation":{"type":"string","description":"Short instruction for how the AI should personalize or alter the template. Up to 250 characters."},"voiceId":{"type":"string","format":"uuid","description":"ID of the Voice this DM Template belongs to. See the `voices` config for the full Voice shape. When the Voice is deleted, all its DM Templates are deleted in cascade.","examples":["cf33282b-b171-4d23-ae02-848499d793e4"]}},"required":["id","updatedAt","createdAt","text","whenToUse","adaptation","voiceId"]},"error":{"description":"Why this element was not applied. Absent when the element succeeded; the other elements are unaffected.","type":"object","properties":{"code":{"type":"string","description":"Status name of the failure, e.g. `NOT_FOUND`, `PERMISSION_DENIED`, `INVALID_ARGUMENT`, `INTERNAL`."},"message":{"type":"string","description":"Human-readable reason this element was not applied."}},"required":["code","message"]}},"required":["index"]},"description":"One result per requested DM Template, in request order"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"DeleteResponseDto10":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Position of the element in the request list, starting at 0."},"id":{"description":"Element ID. Present for every updated or deleted element, and for a created element once it was saved.","type":"string","format":"uuid"},"error":{"description":"Why this element was not applied. Absent when the element succeeded; the other elements are unaffected.","type":"object","properties":{"code":{"type":"string","description":"Status name of the failure, e.g. `NOT_FOUND`, `PERMISSION_DENIED`, `INVALID_ARGUMENT`, `INTERNAL`."},"message":{"type":"string","description":"Human-readable reason this element was not applied."}},"required":["code","message"]}},"required":["index"]},"description":"One result per requested id, in request order"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetListResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Campaign ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Campaign update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Campaign creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Campaign name"},"voice":{"description":"Voice linked to the campaign — only its `id`. Absent when the campaign has no Voice. Load the campaign or the Voice itself for the Voice name, learning mode and timestamps.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Voice ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]}},"required":["id"]},"isActive":{"type":"boolean","description":"Whether the campaign is running. When `false` (paused), the post feed stops updating, no DM drafts are suggested, and no connection requests are sent."},"sharedUsers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},"description":"Team members explicitly granted access to this campaign — only their `id` and `name`. Independent of whole-team sharing via `shareWithAllWorkspaceUsers`. Load the campaign for the full user records."},"skipTeammatesLeads":{"type":"boolean","description":"If `true`, skip prospects that are already present in teammates' campaigns in the same team — avoids double outreach to the same person."},"owner":{"description":"Campaign owner — reduced projection of the user shape: `linkedInProfile` is omitted, and `selectedWorkspaceSettings.isLinkedInProfileConnected` here reflects the owner's own selected workspace (may differ from the campaign's workspace).","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"User ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"User update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"User creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"firstName":{"type":"string","description":"User first name"},"lastName":{"type":"string","description":"User last name"},"name":{"type":"string","description":"Full display name — concatenation of `firstName` and `lastName`, computed on the backend (read-only)."},"linkedInProfile":{"description":"Saved LinkedIn profile data collected when the account was connected (read-only). It may remain after logout, so its presence does not prove a live connection. Current LinkedIn connection status is reported separately.","type":"object","properties":{"id":{"type":"string","description":"LinkedIn profile entity id"},"updatedAt":{"type":"string","description":"LinkedIn profile update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"LinkedIn profile creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Name from the LinkedIn profile (scraped; not user-editable in Extrovert)."},"email":{"type":"string","description":"Email used to log in to LinkedIn (may differ from the Extrovert account email)."},"avatarUrl":{"description":"LinkedIn profile avatar URL.","type":"string"},"linkedInUrl":{"description":"Public LinkedIn profile URL.","type":"string"}},"required":["id","updatedAt","createdAt","name","email"]},"selectedWorkspaceSettings":{"description":"The current user's member record in the currently selected team (role, creator flag, registrationType, LinkedIn-connected flag). `id` here is the member-record id and `user.id` is the user id; the team id itself is not part of this object.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Team member record id.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Member record update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Member record creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"user":{"description":"Reference to the user this member record belongs to — carries only `id` and `name`. Fetch the full user record separately if needed. May be missing if the user was removed.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},"role":{"type":"string","enum":["MEMBER","MANAGER","ADMIN"],"description":"The member's role in the team."},"isCreator":{"type":"boolean","description":"Whether this member holds a creator seat: may own campaigns. Not only the team founder."},"isLinkedInProfileConnected":{"type":"boolean","description":"Whether this member has a valid LinkedIn account connected. Can only be `true` for a member with a creator seat (and only when the profile is actually linked and valid)."},"registrationType":{"type":"string","enum":["NEW_USER_SIGNUP","NEW_USER_WORKSPACE_INVITE_CONFIRM","SUB_USER"],"description":"How this member entered the system. `NEW_USER_SIGNUP` — signed up themselves; `NEW_USER_WORKSPACE_INVITE_CONFIRM` — accepted a team invite; `SUB_USER` — created as a managed account by another user."},"onboardingState":{"type":"string","enum":["IN_PROGRESS","POSTPONED","COMPLETED","SKIPPED"],"description":"AI assistant onboarding progress. `IN_PROGRESS` — user is going through onboarding; `POSTPONED` — user dismissed onboarding temporarily; `COMPLETED` — onboarding finished; `SKIPPED` — user opted out."},"onboardingDate":{"type":"string","description":"ISO timestamp when `onboardingState` was last updated.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}},"required":["id","updatedAt","createdAt","role","isCreator","isLinkedInProfileConnected","registrationType","onboardingState","onboardingDate"]},"isDmHistorySynced":{"type":"boolean","description":"When an account is connected, Extrovert syncs its DMs. Can take several hours. Until this becomes `true`, the AI-DMs unibox is not functional."},"onboardingState":{"type":"string","enum":["IN_PROGRESS","POSTPONED","COMPLETED","SKIPPED"],"description":"AI assistant onboarding progress. `IN_PROGRESS` — user is going through onboarding; `POSTPONED` — user dismissed onboarding temporarily; `COMPLETED` — onboarding finished; `SKIPPED` — user opted out."},"onboardingDate":{"type":"string","description":"ISO timestamp when `onboardingState` was last updated.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"linkedinUrl":{"description":"User-provided LinkedIn profile URL stored at signup or profile update (distinct from scraped `linkedInProfile.linkedInUrl`).","type":"string"},"timezone":{"description":"IANA timezone of the user's work schedule; the Dashboard computes statistics in it. Returned by the profile and the team-member list.","examples":["Europe/Paris"],"type":"string"}},"required":["id","updatedAt","createdAt","firstName","lastName","name","isDmHistorySynced","onboardingState","onboardingDate"]},"isDeleted":{"type":"boolean","description":"Whether the campaign has been deleted. Deleted campaigns are not usable and should be treated as removed."},"commenting":{"description":"Whole comment policy of the campaign: strategy, frequency, indirect commenting, post filters, feed cleanup and publishing pace. See `commentingResponseSchema` for the individual fields.","type":"object","properties":{"strategy":{"type":"string","enum":["FRESHNESS_FIRST","FINISH_FIRST","EVENLY_DISTRIBUTE"],"description":"Order in which comment opportunities are offered."},"frequency":{"description":"How often the campaign may comment on the same prospect.","type":"object","properties":{"intervalDays":{"description":"Minimum days between two comments on the same prospect. Absent means the campaign comments on every eligible post.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"changeAfterPublishedComments":{"description":"Change of the frequency once enough comments have been published for a prospect.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether the comment frequency changes once a published-comment threshold is reached."},"directCommentCount":{"description":"Published direct comments after which the change applies. The stored value is preserved while its switch is off, so it can be restored later.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"indirectCommentCount":{"description":"Published indirect comments after which the change applies. The stored value is preserved while its switch is off, so it can be restored later.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"modeAfterThreshold":{"description":"What happens once a threshold is reached. The stored value is preserved while its switch is off, so it can be restored later.","type":"string","enum":["LOWER_FREQUENCY","STOP"]},"intervalDaysAfterThreshold":{"description":"Days between comments once the threshold is reached. The stored value is preserved while its switch is off, so it can be restored later.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["enabled"]}}},"indirectCommentingEnabled":{"type":"boolean","description":"Whether the campaign also pulls indirect posts — posts from the people a prospect engages with most, content the prospect is likely to see in their own feed."},"postFilters":{"description":"Which posts qualify for a comment at all.","type":"object","properties":{"maximumAgeDays":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How old an eligible post may be, in days. The filter is always on."},"excludedPostCategories":{"type":"array","items":{"type":"string","enum":["THOUGHT_LEADERSHIP","BUSINESS_ISSUES","COMPANY_NEWS_OR_ACHIEVEMENTS","OFFLINE_EVENTS","ONLINE_EVENTS","SOCIAL_ISSUES","OWN_PRODUCT_PROMOTION","JOB_RELATED","PERSONAL_LIFE_BLOG","POLITICS","COMMENT_X_TO_GET_Y","EXTRA_SENSITIVE","OTHER"]},"description":"AI-detected post categories the campaign does not comment on. Empty means every category is allowed."},"monitoredTopicIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Monitored Topic ids a post must match. Empty means the campaign comments regardless of topic."},"minimumReactionCount":{"description":"Total reactions a post needs to qualify. Absent means the threshold is off. Applies to `KEYWORD` (Topic) campaigns only — omit it for `TARGET_USER` (Prospects) campaigns; the backend rejects it there.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["maximumAgeDays","excludedPostCategories","monitoredTopicIds"]},"feedCleanup":{"description":"Automatic skip of a prospect's surplus active posts; revertable from the Skipped tab.","type":"object","properties":{"autoRejectOverflowPostsEnabled":{"type":"boolean","description":"Whether a prospect's surplus active posts are automatically skipped, owner-wide; each is revertable from the Skipped tab."},"maxActivePostsPerProspect":{"description":"How many posts of one prospect may stay active. The stored value is preserved while its switch is off, so it can be restored later.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["autoRejectOverflowPostsEnabled"]},"publishingPace":{"description":"Spacing between publications of approved comments for the same prospect.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether publication of approved comments for the same prospect is spaced out. It spaces direct comments only — the ones under the prospect's own posts; indirect comments are never spaced by it."},"minimumIntervalHours":{"description":"Minimum pause between two publications under the same prospect's own posts, in hours. Absent exactly when the pace is off.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["enabled"]}},"required":["strategy","indirectCommentingEnabled"]},"type":{"type":"string","enum":["TARGET_USER","KEYWORD"],"description":"Campaign type. `TARGET_USER` engages with a specific list of LinkedIn profiles; `KEYWORD` discovers posts by bound topics. Backend values `TARGET_USER` / `KEYWORD` correspond to user-facing 'Prospects campaign' / 'Topic campaign'."},"outreach":{"description":"Private-outreach settings of this campaign: the `warmUp` comment prerequisite, the independent `connectionRequests` switch, and the `directMessages` settings. See `outreachSettingsResponseSchema` in `campaign/outreach.ts`.","type":"object","properties":{"warmUp":{"description":"Comment prerequisite for automatic private outreach. See `warmUpSchema` for the individual switches.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether the comment prerequisite applies. Warm up is only the comment prerequisite for automatic private outreach: it decides WHEN a prospect becomes eligible, never WHETHER connection requests or direct messages are enabled. Turning it off waives the prerequisite and leaves `connectionRequests` and `directMessages` untouched."},"direct":{"description":"Comments published under the prospect's own posts.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether comments on this path count toward warm up."},"commentTarget":{"description":"Number of successfully published comments on this path that satisfies warm up. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["enabled"]},"indirect":{"description":"Comments published under indirect posts — posts from the people the prospect engages with.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether comments on this path count toward warm up."},"commentTarget":{"description":"Number of successfully published comments on this path that satisfies warm up. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["enabled"]},"skipWarmUpWhenNoRecentPosts":{"type":"boolean","description":"Whether the comment prerequisite is waived when none of the post sources enabled for warm up has a post from the last 30 days."},"stopWaiting":{"description":"Time-based waiver of the comment prerequisite.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether the comment prerequisite is waived after a fixed time in the campaign."},"afterDays":{"description":"Number of days in the campaign after which warm up is waived. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["enabled"]}},"required":["enabled","skipWarmUpWhenNoRecentPosts"]},"connectionRequests":{"description":"Automatic connection requests of this campaign and the withdrawal of the ones that stay unaccepted.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether the campaign sends automatic connection requests to prospects that satisfy warm up."},"withdraw":{"description":"Automatic withdrawal of connection requests that stay unaccepted.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether invitations still not accepted after `afterDays` are withdrawn. Only invitations Extrovert sent for this campaign are withdrawn, never ones that were already pending; it runs only while `connectionRequests.enabled` is on."},"afterDays":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Days an invitation waits for acceptance before it is withdrawn. The stored value is preserved while the switch is off, so it can be restored later."},"resendCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How many times a withdrawn prospect is invited again; 0 never sends again. The stored value is preserved while the switch is off, so it can be restored later."}},"required":["enabled","afterDays","resendCount"]}},"required":["enabled"]},"directMessages":{"description":"Direct-message automation settings for this campaign.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether direct-message automation is on for this campaign."},"firstOutreach":{"description":"First message to a prospect the campaign has not written to yet.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether the campaign recommends the very first message to a newly connected prospect."},"waitAfterAcceptance":{"description":"Delay between an accepted connection and the first recommended message.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether the first outreach waits a fixed time after the connection was accepted."},"days":{"description":"Number of days to wait after the connection was accepted. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["enabled"]},"autoEnabled":{"type":"boolean","description":"Whether Extrovert sends a due first message automatically."}},"required":["enabled","autoEnabled"]},"followUps":{"description":"Repeat messages to a prospect who has not replied yet.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether the campaign recommends follow-up messages to prospects who have not replied."},"limit":{"description":"Cap on the number of follow-ups in one unanswered series.","type":"object","properties":{"isUnlimited":{"type":"boolean","description":"Whether the number of automatic follow-ups in one unanswered series is uncapped."},"maxFollowUps":{"description":"Number of automatic follow-ups allowed in one unanswered series. Absent exactly when the count is unlimited.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["isUnlimited"]},"cadenceDays":{"type":"array","items":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"description":"Ladder of pauses in days, indexed by follow-up number. Always the full ladder, including the steps the current `limit` hides."},"tailCadenceDays":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Pause in days used from the follow-up right after the last `cadenceDays` step onwards."},"relevantPostAcceleration":{"description":"Bring a follow-up forward when the prospect publishes a post worth reacting to.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether a fresh, referenceable post by the prospect may bring the next follow-up forward."}},"required":["enabled"]},"autoEnabled":{"type":"boolean","description":"Whether Extrovert sends due follow-ups automatically."}},"required":["enabled","cadenceDays","tailCadenceDays","autoEnabled"]},"automaticSending":{"description":"Limits of the automatic DM steps of this campaign.","type":"object","properties":{"dailyCap":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Automatic DM send attempts per owner-local day."},"windowFromMin":{"description":"Start of the automatic sending window, minutes from midnight in the owner's timezone; absent while working hours apply.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"windowToMin":{"description":"End of the automatic sending window; absent while working hours apply.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["dailyCap"]}},"required":["enabled"]}}},"shareWithAllWorkspaceUsers":{"type":"boolean","description":"Whether the campaign is shared with all members of the team."},"manualPostsSyncAvailableAfter":{"description":"ISO 8601: earliest time the manual 'Check for new posts' action may be triggered again. Omitted when the action is available immediately.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"automaticCommentsSettings":{"description":"Automatic Comments settings for this campaign. See the update action for field semantics.","type":"object","properties":{"isEnabled":{"type":"boolean","description":"Whether Automatic Comments mode is on. When `true`, the campaign automatically publishes top eligible comments from its approval feed without manual review."},"dailyCap":{"type":"number","description":"Target maximum of automatic comments per day. The effective daily number may vary slightly around this value."},"windowFromMin":{"description":"Active window start, minutes from midnight in the campaign owner's timezone. Absent until the first enable copies the LinkedIn account's working hours into the campaign window.","type":"number"},"windowToMin":{"description":"Active window end, minutes from midnight in the campaign owner's timezone. Absent together with `windowFromMin`.","type":"number"},"mainFeedPriority":{"type":"string","enum":["LESS_OFTEN","BALANCED","MORE_OFTEN"],"description":"Relative priority of this campaign's posts in the owner's Main Feed compared with the owner's other campaigns. It is not the frequency or cadence of automatic comment publishing."}},"required":["isEnabled","dailyCap","mainFeedPriority"]},"stepsSummary":{"description":"Who performs each outreach step — connection requests, the first message and follow-ups — with the automatic DM limits. Present in lists and detail.","type":"object","properties":{"connectionRequestsEnabled":{"type":"boolean","description":"Whether the campaign sends connection requests automatically."},"firstDmMode":{"type":"string","enum":["off","manual","auto"],"description":"Who sends the first message: off, manual (a person) or auto (Extrovert)."},"followUpsMode":{"type":"string","enum":["off","manual","auto"],"description":"Who sends follow-ups: off, manual (a person) or auto (Extrovert)."},"followUpLimit":{"description":"Follow-up limit of one unanswered series; absent when unlimited.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"dmAutoDailyCap":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Automatic DM send attempts per owner-local day."},"dmAutoWindowFromMin":{"description":"Start of the automatic sending window; absent while working hours apply.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"dmAutoWindowToMin":{"description":"End of the automatic sending window; absent while working hours apply.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["connectionRequestsEnabled","firstDmMode","followUpsMode","dmAutoDailyCap"]}},"required":["id","updatedAt","createdAt","name","isActive","sharedUsers","skipTeammatesLeads","isDeleted","type","shareWithAllWorkspaceUsers"]},"description":"Campaign items visible to the current user"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetOneResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","description":"Loaded campaign","properties":{"id":{"type":"string","format":"uuid","description":"Campaign ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Campaign update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Campaign creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Campaign name"},"voice":{"description":"Voice linked to the campaign — everything the campaign feeds into comment and direct-message generation. Carries only the Voice header (id, name, timestamps, learning mode); load the full Voice separately when its background or tone texts are needed.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Voice ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Voice update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Voice creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Voice name"},"isLearningModeEnabled":{"type":"boolean","description":"If `true`, comments the user both approved AND edited are auto-saved as Comment Examples on this Voice (capped at 20 entries). Untouched auto-approved comments and direct messages are not learned."}},"required":["id","updatedAt","createdAt","name","isLearningModeEnabled"]},"isActive":{"type":"boolean","description":"Whether the campaign is running. When `false` (paused), the post feed stops updating, no DM drafts are suggested, and no connection requests are sent."},"sharedUsers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"User ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"User update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"User creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"firstName":{"type":"string","description":"User first name"},"lastName":{"type":"string","description":"User last name"},"name":{"type":"string","description":"Full display name — concatenation of `firstName` and `lastName`, computed on the backend (read-only)."},"linkedInProfile":{"description":"Saved LinkedIn profile data collected when the account was connected (read-only). It may remain after logout, so its presence does not prove a live connection. Current LinkedIn connection status is reported separately.","type":"object","properties":{"id":{"type":"string","description":"LinkedIn profile entity id"},"updatedAt":{"type":"string","description":"LinkedIn profile update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"LinkedIn profile creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Name from the LinkedIn profile (scraped; not user-editable in Extrovert)."},"email":{"type":"string","description":"Email used to log in to LinkedIn (may differ from the Extrovert account email)."},"avatarUrl":{"description":"LinkedIn profile avatar URL.","type":"string"},"linkedInUrl":{"description":"Public LinkedIn profile URL.","type":"string"}},"required":["id","updatedAt","createdAt","name","email"]},"selectedWorkspaceSettings":{"description":"The current user's member record in the currently selected team (role, creator flag, registrationType, LinkedIn-connected flag). `id` here is the member-record id and `user.id` is the user id; the team id itself is not part of this object.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Team member record id.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Member record update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Member record creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"user":{"description":"Reference to the user this member record belongs to — carries only `id` and `name`. Fetch the full user record separately if needed. May be missing if the user was removed.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},"role":{"type":"string","enum":["MEMBER","MANAGER","ADMIN"],"description":"The member's role in the team."},"isCreator":{"type":"boolean","description":"Whether this member holds a creator seat: may own campaigns. Not only the team founder."},"isLinkedInProfileConnected":{"type":"boolean","description":"Whether this member has a valid LinkedIn account connected. Can only be `true` for a member with a creator seat (and only when the profile is actually linked and valid)."},"registrationType":{"type":"string","enum":["NEW_USER_SIGNUP","NEW_USER_WORKSPACE_INVITE_CONFIRM","SUB_USER"],"description":"How this member entered the system. `NEW_USER_SIGNUP` — signed up themselves; `NEW_USER_WORKSPACE_INVITE_CONFIRM` — accepted a team invite; `SUB_USER` — created as a managed account by another user."},"onboardingState":{"type":"string","enum":["IN_PROGRESS","POSTPONED","COMPLETED","SKIPPED"],"description":"AI assistant onboarding progress. `IN_PROGRESS` — user is going through onboarding; `POSTPONED` — user dismissed onboarding temporarily; `COMPLETED` — onboarding finished; `SKIPPED` — user opted out."},"onboardingDate":{"type":"string","description":"ISO timestamp when `onboardingState` was last updated.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}},"required":["id","updatedAt","createdAt","role","isCreator","isLinkedInProfileConnected","registrationType","onboardingState","onboardingDate"]},"isDmHistorySynced":{"type":"boolean","description":"When an account is connected, Extrovert syncs its DMs. Can take several hours. Until this becomes `true`, the AI-DMs unibox is not functional."},"onboardingState":{"type":"string","enum":["IN_PROGRESS","POSTPONED","COMPLETED","SKIPPED"],"description":"AI assistant onboarding progress. `IN_PROGRESS` — user is going through onboarding; `POSTPONED` — user dismissed onboarding temporarily; `COMPLETED` — onboarding finished; `SKIPPED` — user opted out."},"onboardingDate":{"type":"string","description":"ISO timestamp when `onboardingState` was last updated.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"linkedinUrl":{"description":"User-provided LinkedIn profile URL stored at signup or profile update (distinct from scraped `linkedInProfile.linkedInUrl`).","type":"string"},"timezone":{"description":"IANA timezone of the user's work schedule; the Dashboard computes statistics in it. Returned by the profile and the team-member list.","examples":["Europe/Paris"],"type":"string"}},"required":["id","updatedAt","createdAt","firstName","lastName","name","isDmHistorySynced","onboardingState","onboardingDate"]},"description":"Team members explicitly granted access to this campaign. See the `user` config for the user-object shape. Independent of whole-team sharing via `shareWithAllWorkspaceUsers`."},"skipTeammatesLeads":{"type":"boolean","description":"If `true`, skip prospects that are already present in teammates' campaigns in the same team — avoids double outreach to the same person."},"owner":{"description":"Campaign owner — reduced projection of the user shape: `linkedInProfile` is omitted, and `selectedWorkspaceSettings.isLinkedInProfileConnected` here reflects the owner's own selected workspace (may differ from the campaign's workspace).","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"User ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"User update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"User creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"firstName":{"type":"string","description":"User first name"},"lastName":{"type":"string","description":"User last name"},"name":{"type":"string","description":"Full display name — concatenation of `firstName` and `lastName`, computed on the backend (read-only)."},"linkedInProfile":{"description":"Saved LinkedIn profile data collected when the account was connected (read-only). It may remain after logout, so its presence does not prove a live connection. Current LinkedIn connection status is reported separately.","type":"object","properties":{"id":{"type":"string","description":"LinkedIn profile entity id"},"updatedAt":{"type":"string","description":"LinkedIn profile update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"LinkedIn profile creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Name from the LinkedIn profile (scraped; not user-editable in Extrovert)."},"email":{"type":"string","description":"Email used to log in to LinkedIn (may differ from the Extrovert account email)."},"avatarUrl":{"description":"LinkedIn profile avatar URL.","type":"string"},"linkedInUrl":{"description":"Public LinkedIn profile URL.","type":"string"}},"required":["id","updatedAt","createdAt","name","email"]},"selectedWorkspaceSettings":{"description":"The current user's member record in the currently selected team (role, creator flag, registrationType, LinkedIn-connected flag). `id` here is the member-record id and `user.id` is the user id; the team id itself is not part of this object.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Team member record id.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Member record update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Member record creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"user":{"description":"Reference to the user this member record belongs to — carries only `id` and `name`. Fetch the full user record separately if needed. May be missing if the user was removed.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},"role":{"type":"string","enum":["MEMBER","MANAGER","ADMIN"],"description":"The member's role in the team."},"isCreator":{"type":"boolean","description":"Whether this member holds a creator seat: may own campaigns. Not only the team founder."},"isLinkedInProfileConnected":{"type":"boolean","description":"Whether this member has a valid LinkedIn account connected. Can only be `true` for a member with a creator seat (and only when the profile is actually linked and valid)."},"registrationType":{"type":"string","enum":["NEW_USER_SIGNUP","NEW_USER_WORKSPACE_INVITE_CONFIRM","SUB_USER"],"description":"How this member entered the system. `NEW_USER_SIGNUP` — signed up themselves; `NEW_USER_WORKSPACE_INVITE_CONFIRM` — accepted a team invite; `SUB_USER` — created as a managed account by another user."},"onboardingState":{"type":"string","enum":["IN_PROGRESS","POSTPONED","COMPLETED","SKIPPED"],"description":"AI assistant onboarding progress. `IN_PROGRESS` — user is going through onboarding; `POSTPONED` — user dismissed onboarding temporarily; `COMPLETED` — onboarding finished; `SKIPPED` — user opted out."},"onboardingDate":{"type":"string","description":"ISO timestamp when `onboardingState` was last updated.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]}},"required":["id","updatedAt","createdAt","role","isCreator","isLinkedInProfileConnected","registrationType","onboardingState","onboardingDate"]},"isDmHistorySynced":{"type":"boolean","description":"When an account is connected, Extrovert syncs its DMs. Can take several hours. Until this becomes `true`, the AI-DMs unibox is not functional."},"onboardingState":{"type":"string","enum":["IN_PROGRESS","POSTPONED","COMPLETED","SKIPPED"],"description":"AI assistant onboarding progress. `IN_PROGRESS` — user is going through onboarding; `POSTPONED` — user dismissed onboarding temporarily; `COMPLETED` — onboarding finished; `SKIPPED` — user opted out."},"onboardingDate":{"type":"string","description":"ISO timestamp when `onboardingState` was last updated.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"linkedinUrl":{"description":"User-provided LinkedIn profile URL stored at signup or profile update (distinct from scraped `linkedInProfile.linkedInUrl`).","type":"string"},"timezone":{"description":"IANA timezone of the user's work schedule; the Dashboard computes statistics in it. Returned by the profile and the team-member list.","examples":["Europe/Paris"],"type":"string"}},"required":["id","updatedAt","createdAt","firstName","lastName","name","isDmHistorySynced","onboardingState","onboardingDate"]},"isDeleted":{"type":"boolean","description":"Whether the campaign has been deleted. Deleted campaigns are not usable and should be treated as removed."},"commenting":{"description":"Whole comment policy of the campaign: strategy, frequency, indirect commenting, post filters, feed cleanup and publishing pace. See `commentingResponseSchema` for the individual fields.","type":"object","properties":{"strategy":{"type":"string","enum":["FRESHNESS_FIRST","FINISH_FIRST","EVENLY_DISTRIBUTE"],"description":"Order in which comment opportunities are offered."},"frequency":{"description":"How often the campaign may comment on the same prospect.","type":"object","properties":{"intervalDays":{"description":"Minimum days between two comments on the same prospect. Absent means the campaign comments on every eligible post.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"changeAfterPublishedComments":{"description":"Change of the frequency once enough comments have been published for a prospect.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether the comment frequency changes once a published-comment threshold is reached."},"directCommentCount":{"description":"Published direct comments after which the change applies. The stored value is preserved while its switch is off, so it can be restored later.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"indirectCommentCount":{"description":"Published indirect comments after which the change applies. The stored value is preserved while its switch is off, so it can be restored later.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"modeAfterThreshold":{"description":"What happens once a threshold is reached. The stored value is preserved while its switch is off, so it can be restored later.","type":"string","enum":["LOWER_FREQUENCY","STOP"]},"intervalDaysAfterThreshold":{"description":"Days between comments once the threshold is reached. The stored value is preserved while its switch is off, so it can be restored later.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["enabled"]}}},"indirectCommentingEnabled":{"type":"boolean","description":"Whether the campaign also pulls indirect posts — posts from the people a prospect engages with most, content the prospect is likely to see in their own feed."},"postFilters":{"description":"Which posts qualify for a comment at all.","type":"object","properties":{"maximumAgeDays":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How old an eligible post may be, in days. The filter is always on."},"excludedPostCategories":{"type":"array","items":{"type":"string","enum":["THOUGHT_LEADERSHIP","BUSINESS_ISSUES","COMPANY_NEWS_OR_ACHIEVEMENTS","OFFLINE_EVENTS","ONLINE_EVENTS","SOCIAL_ISSUES","OWN_PRODUCT_PROMOTION","JOB_RELATED","PERSONAL_LIFE_BLOG","POLITICS","COMMENT_X_TO_GET_Y","EXTRA_SENSITIVE","OTHER"]},"description":"AI-detected post categories the campaign does not comment on. Empty means every category is allowed."},"monitoredTopicIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Monitored Topic ids a post must match. Empty means the campaign comments regardless of topic."},"minimumReactionCount":{"description":"Total reactions a post needs to qualify. Absent means the threshold is off. Applies to `KEYWORD` (Topic) campaigns only — omit it for `TARGET_USER` (Prospects) campaigns; the backend rejects it there.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["maximumAgeDays","excludedPostCategories","monitoredTopicIds"]},"feedCleanup":{"description":"Automatic skip of a prospect's surplus active posts; revertable from the Skipped tab.","type":"object","properties":{"autoRejectOverflowPostsEnabled":{"type":"boolean","description":"Whether a prospect's surplus active posts are automatically skipped, owner-wide; each is revertable from the Skipped tab."},"maxActivePostsPerProspect":{"description":"How many posts of one prospect may stay active. The stored value is preserved while its switch is off, so it can be restored later.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["autoRejectOverflowPostsEnabled"]},"publishingPace":{"description":"Spacing between publications of approved comments for the same prospect.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether publication of approved comments for the same prospect is spaced out. It spaces direct comments only — the ones under the prospect's own posts; indirect comments are never spaced by it."},"minimumIntervalHours":{"description":"Minimum pause between two publications under the same prospect's own posts, in hours. Absent exactly when the pace is off.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["enabled"]}},"required":["strategy","indirectCommentingEnabled"]},"type":{"type":"string","enum":["TARGET_USER","KEYWORD"],"description":"Campaign type. `TARGET_USER` engages with a specific list of LinkedIn profiles; `KEYWORD` discovers posts by bound topics. Backend values `TARGET_USER` / `KEYWORD` correspond to user-facing 'Prospects campaign' / 'Topic campaign'."},"outreach":{"description":"Private-outreach settings of this campaign: the `warmUp` comment prerequisite, the independent `connectionRequests` switch, and the `directMessages` settings. See `outreachSettingsResponseSchema` in `campaign/outreach.ts`.","type":"object","properties":{"warmUp":{"description":"Comment prerequisite for automatic private outreach. See `warmUpSchema` for the individual switches.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether the comment prerequisite applies. Warm up is only the comment prerequisite for automatic private outreach: it decides WHEN a prospect becomes eligible, never WHETHER connection requests or direct messages are enabled. Turning it off waives the prerequisite and leaves `connectionRequests` and `directMessages` untouched."},"direct":{"description":"Comments published under the prospect's own posts.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether comments on this path count toward warm up."},"commentTarget":{"description":"Number of successfully published comments on this path that satisfies warm up. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["enabled"]},"indirect":{"description":"Comments published under indirect posts — posts from the people the prospect engages with.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether comments on this path count toward warm up."},"commentTarget":{"description":"Number of successfully published comments on this path that satisfies warm up. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["enabled"]},"skipWarmUpWhenNoRecentPosts":{"type":"boolean","description":"Whether the comment prerequisite is waived when none of the post sources enabled for warm up has a post from the last 30 days."},"stopWaiting":{"description":"Time-based waiver of the comment prerequisite.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether the comment prerequisite is waived after a fixed time in the campaign."},"afterDays":{"description":"Number of days in the campaign after which warm up is waived. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["enabled"]}},"required":["enabled","skipWarmUpWhenNoRecentPosts"]},"connectionRequests":{"description":"Automatic connection requests of this campaign and the withdrawal of the ones that stay unaccepted.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether the campaign sends automatic connection requests to prospects that satisfy warm up."},"withdraw":{"description":"Automatic withdrawal of connection requests that stay unaccepted.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether invitations still not accepted after `afterDays` are withdrawn. Only invitations Extrovert sent for this campaign are withdrawn, never ones that were already pending; it runs only while `connectionRequests.enabled` is on."},"afterDays":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Days an invitation waits for acceptance before it is withdrawn. The stored value is preserved while the switch is off, so it can be restored later."},"resendCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How many times a withdrawn prospect is invited again; 0 never sends again. The stored value is preserved while the switch is off, so it can be restored later."}},"required":["enabled","afterDays","resendCount"]}},"required":["enabled"]},"directMessages":{"description":"Direct-message automation settings for this campaign.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether direct-message automation is on for this campaign."},"firstOutreach":{"description":"First message to a prospect the campaign has not written to yet.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether the campaign recommends the very first message to a newly connected prospect."},"waitAfterAcceptance":{"description":"Delay between an accepted connection and the first recommended message.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether the first outreach waits a fixed time after the connection was accepted."},"days":{"description":"Number of days to wait after the connection was accepted. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["enabled"]},"autoEnabled":{"type":"boolean","description":"Whether Extrovert sends a due first message automatically."}},"required":["enabled","autoEnabled"]},"followUps":{"description":"Repeat messages to a prospect who has not replied yet.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether the campaign recommends follow-up messages to prospects who have not replied."},"limit":{"description":"Cap on the number of follow-ups in one unanswered series.","type":"object","properties":{"isUnlimited":{"type":"boolean","description":"Whether the number of automatic follow-ups in one unanswered series is uncapped."},"maxFollowUps":{"description":"Number of automatic follow-ups allowed in one unanswered series. Absent exactly when the count is unlimited.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["isUnlimited"]},"cadenceDays":{"type":"array","items":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"description":"Ladder of pauses in days, indexed by follow-up number. Always the full ladder, including the steps the current `limit` hides."},"tailCadenceDays":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Pause in days used from the follow-up right after the last `cadenceDays` step onwards."},"relevantPostAcceleration":{"description":"Bring a follow-up forward when the prospect publishes a post worth reacting to.","type":"object","properties":{"enabled":{"type":"boolean","description":"Whether a fresh, referenceable post by the prospect may bring the next follow-up forward."}},"required":["enabled"]},"autoEnabled":{"type":"boolean","description":"Whether Extrovert sends due follow-ups automatically."}},"required":["enabled","cadenceDays","tailCadenceDays","autoEnabled"]},"automaticSending":{"description":"Limits of the automatic DM steps of this campaign.","type":"object","properties":{"dailyCap":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Automatic DM send attempts per owner-local day."},"windowFromMin":{"description":"Start of the automatic sending window, minutes from midnight in the owner's timezone; absent while working hours apply.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"windowToMin":{"description":"End of the automatic sending window; absent while working hours apply.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["dailyCap"]}},"required":["enabled"]}}},"shareWithAllWorkspaceUsers":{"type":"boolean","description":"Whether the campaign is shared with all members of the team."},"manualPostsSyncAvailableAfter":{"description":"ISO 8601: earliest time the manual 'Check for new posts' action may be triggered again. Omitted when the action is available immediately.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"automaticCommentsSettings":{"description":"Automatic Comments settings for this campaign. See the update action for field semantics.","type":"object","properties":{"isEnabled":{"type":"boolean","description":"Whether Automatic Comments mode is on. When `true`, the campaign automatically publishes top eligible comments from its approval feed without manual review."},"dailyCap":{"type":"number","description":"Target maximum of automatic comments per day. The effective daily number may vary slightly around this value."},"windowFromMin":{"description":"Active window start, minutes from midnight in the campaign owner's timezone. Absent until the first enable copies the LinkedIn account's working hours into the campaign window.","type":"number"},"windowToMin":{"description":"Active window end, minutes from midnight in the campaign owner's timezone. Absent together with `windowFromMin`.","type":"number"},"mainFeedPriority":{"type":"string","enum":["LESS_OFTEN","BALANCED","MORE_OFTEN"],"description":"Relative priority of this campaign's posts in the owner's Main Feed compared with the owner's other campaigns. It is not the frequency or cadence of automatic comment publishing."}},"required":["isEnabled","dailyCap","mainFeedPriority"]},"stepsSummary":{"description":"Who performs each outreach step — connection requests, the first message and follow-ups — with the automatic DM limits. Present in lists and detail.","type":"object","properties":{"connectionRequestsEnabled":{"type":"boolean","description":"Whether the campaign sends connection requests automatically."},"firstDmMode":{"type":"string","enum":["off","manual","auto"],"description":"Who sends the first message: off, manual (a person) or auto (Extrovert)."},"followUpsMode":{"type":"string","enum":["off","manual","auto"],"description":"Who sends follow-ups: off, manual (a person) or auto (Extrovert)."},"followUpLimit":{"description":"Follow-up limit of one unanswered series; absent when unlimited.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"dmAutoDailyCap":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Automatic DM send attempts per owner-local day."},"dmAutoWindowFromMin":{"description":"Start of the automatic sending window; absent while working hours apply.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"dmAutoWindowToMin":{"description":"End of the automatic sending window; absent while working hours apply.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["connectionRequestsEnabled","firstDmMode","followUpsMode","dmAutoDailyCap"]}},"required":["id","updatedAt","createdAt","name","isActive","sharedUsers","skipTeammatesLeads","isDeleted","type","shareWithAllWorkspaceUsers"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"CreateRequestDto":{"type":"object","properties":{"ownerId":{"type":"string","format":"uuid","description":"User ID of the campaign owner. Creating for anyone other than the caller requires the workspace permission to create campaigns for another owner (ADMIN/MANAGER). When creating for a non-managed owner, the acting user is also added as an explicit grantee."},"name":{"type":"string","minLength":1,"description":"Display name for the campaign."},"type":{"type":"string","enum":["TARGET_USER","KEYWORD"],"description":"`TARGET_USER` = Prospects campaign; `KEYWORD` = Topic campaign. Creating a Topic campaign requires `CAN_USE_TOPIC_CAMPAIGNS`."},"voiceId":{"type":"string","format":"uuid","description":"Voice ID owned by `ownerId`. A foreign or missing Voice is rejected."},"skipTeammatesLeads":{"type":"boolean","description":"If `true`, skip prospects that are already in teammates' campaigns in the same team — avoids double outreach to the same person. Applies to `TARGET_USER` (Prospects) campaigns only (recommended `true` there); for `KEYWORD` (Topic) campaigns it does not apply — leave it `false`."},"commenting":{"type":"object","description":"Optional. Whole comment policy of the campaign. `commenting` is replaced as a whole, never deep-merged: omit it to leave the stored policy untouched, or state the complete policy you want. A scalar omitted inside a group that IS stated therefore means off/none, not “keep the stored value”. A `TARGET_USER` (Prospects) campaign states `strategy`, `postFilters`, `frequency` and `feedCleanup`, and may state `indirectCommentingEnabled` and `publishingPace`; a `KEYWORD` (Topic) campaign states `strategy` and `postFilters` only — every other member is People-only and must be omitted. Omit it to start from the campaign type's defaults.","properties":{"strategy":{"type":"string","enum":["FRESHNESS_FIRST","FINISH_FIRST","EVENLY_DISTRIBUTE"],"description":"Order in which comment opportunities are offered. `FRESHNESS_FIRST` puts the newest posts first; `FINISH_FIRST` puts the prospects closest to their Outreach warm-up target first and requires an enabled warm-up comment path; `EVENLY_DISTRIBUTE` spreads comments across prospects. Topic campaigns have no prospects and accept only `FRESHNESS_FIRST`."},"postFilters":{"type":"object","properties":{"maximumAgeDays":{"description":"Maximum eligible post age in days (1–30). Omitted within a supplied policy stores the default 28 days, not an unlimited window and not the maximum 30.","type":"integer","minimum":1,"maximum":30},"excludedPostCategories":{"maxItems":12,"type":"array","items":{"type":"string","enum":["THOUGHT_LEADERSHIP","BUSINESS_ISSUES","COMPANY_NEWS_OR_ACHIEVEMENTS","OFFLINE_EVENTS","ONLINE_EVENTS","SOCIAL_ISSUES","OWN_PRODUCT_PROMOTION","JOB_RELATED","PERSONAL_LIFE_BLOG","POLITICS","COMMENT_X_TO_GET_Y","EXTRA_SENSITIVE","OTHER"],"description":"AI post-category label, not emotional sentiment. `COMMENT_X_TO_GET_Y` requires a specified public comment for a promised return; `EXTRA_SENSITIVE` takes priority over other categories; `OTHER` means classified as none of the named categories, not unclassified."},"description":"AI-classified categories to exclude. `[]` allows all categories, including unclassified posts; a non-empty exclusion list also excludes unclassified posts. At least one known category must remain allowed, so at most 12 of the 13 values may be excluded — excluding all of them is rejected, not treated as a pause switch."},"monitoredTopicIds":{"description":"Prospects campaigns only: allow posts whose assigned Monitored Topic is in this owner-owned set. `[]` or omission removes this filter; unmatched/unclassified posts fail a non-empty filter. Foreign or stale topic IDs are dropped. Non-empty requires `CAN_FILTER_POSTS_BY_RELEVANT_TAGS`; without it the write returns 403.","maxItems":1000,"type":"array","items":{"type":"string","format":"uuid"}},"minimumReactionCount":{"description":"Topic campaigns only: minimum total reactions across all reaction types (1–50). Omitted disables the threshold; an unknown reaction count fails an enabled threshold. Applies to `KEYWORD` (Topic) campaigns only — omit it for `TARGET_USER` (Prospects) campaigns; the backend rejects it there.","type":"integer","minimum":1,"maximum":50}},"required":["excludedPostCategories"],"additionalProperties":false,"description":"Which posts qualify for a comment at all."},"frequency":{"description":"How often the campaign may comment on the same prospect. Applies to `TARGET_USER` (Prospects) campaigns only — omit it for `KEYWORD` (Topic) campaigns, which have no prospects.","type":"object","properties":{"intervalDays":{"description":"Minimum days (1–60) after the prospect's latest published or already approved/scheduled comment touch before another opportunity is eligible. Omitted = every eligible post.","type":"integer","minimum":1,"maximum":60},"changeAfterPublishedComments":{"type":"object","properties":{"enabled":{"description":"Whether the campaign changes its comment frequency for a prospect once a published-comment threshold is reached.","type":"boolean"},"directCommentCount":{"description":"Published direct comments after which the change applies. Positive integer, no upper bound. The direct and indirect thresholds are independent — either one reaching its count triggers the change, and they are never summed. The stored value is preserved while its switch is off, so it can be restored later.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"indirectCommentCount":{"description":"Published indirect comments after which the change applies. Positive integer, no upper bound. Not evaluated while `indirectCommentingEnabled` is off. The stored value is preserved while its switch is off, so it can be restored later.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"modeAfterThreshold":{"description":"What happens once a threshold is reached. `LOWER_FREQUENCY` keeps commenting at `intervalDaysAfterThreshold`; `STOP` removes the prospect from selection entirely. Required while `enabled` is `true`.","type":"string","enum":["LOWER_FREQUENCY","STOP"]},"intervalDaysAfterThreshold":{"description":"Eligibility pause in days after the threshold (1–60), measured from the latest published or already approved/scheduled comment touch; required for `LOWER_FREQUENCY` and must exceed `intervalDays` when that base interval is provided. The stored value is preserved while its switch is off, so it can be restored later.","type":"integer","minimum":1,"maximum":60}},"additionalProperties":false,"if":{"required":["enabled"],"properties":{"enabled":{"const":true}}},"then":{"required":["modeAfterThreshold"],"anyOf":[{"required":["directCommentCount"]},{"required":["indirectCommentCount"]}]},"description":"Change the frequency once enough comments have been published for a prospect. Required whenever `frequency` is stated; state it with `enabled: false` to keep the policy at one frequency."}},"required":["changeAfterPublishedComments"],"additionalProperties":false,"$comment":"intervalDaysAfterThreshold must be greater than intervalDays."},"feedCleanup":{"description":"Automatic skip of a prospect's surplus active posts; revertable from the Skipped tab. Applies to `TARGET_USER` (Prospects) campaigns only — omit it for `KEYWORD` (Topic) campaigns, which have no prospects.","type":"object","properties":{"autoRejectOverflowPostsEnabled":{"description":"Automatically skip a prospect's oldest active posts once more than `maxActivePostsPerProspect` of them are active. The skip applies to the publishing owner across every campaign of that owner, so the posts also leave the feed elsewhere; any of them can be moved back for approval from the Skipped tab, though the cap may skip an untouched one again. Posts whose comment is already published or publishing are never touched. New Prospects campaigns start with this on (`true`).","type":"boolean"},"maxActivePostsPerProspect":{"description":"How many posts of one prospect may stay active (1–10). Omitting it stores 3. The stored value is preserved while its switch is off, so it can be restored later.","type":"integer","minimum":1,"maximum":10}},"additionalProperties":false},"indirectCommentingEnabled":{"description":"Also pull indirect posts — posts from the people a prospect engages with most, content the prospect is likely to see in their own feed — so the campaign can comment on those too. Main use case: reaching prospects who rarely post themselves. Plan-gated — changing it requires `CAN_OBTAIN_REACTIONS`; without it the write returns 403, while an unchanged value is allowed. Applies to `TARGET_USER` (Prospects) campaigns only — omit it for `KEYWORD` (Topic) campaigns, which have no prospects.","type":"boolean"},"publishingPace":{"description":"Spacing between publications of approved comments for the same prospect. Applies to `TARGET_USER` (Prospects) campaigns only — omit it for `KEYWORD` (Topic) campaigns, which have no prospects.","type":"object","properties":{"enabled":{"description":"Whether publication of approved comments for the same prospect is spaced out. It spaces direct comments only — the ones under the prospect's own posts; indirect comments are never spaced by it. Plan-gated — changing it requires `CAN_MANAGE_DELAYED_POSTING`; without it the write returns 403, while an unchanged value is allowed.","type":"boolean"},"minimumIntervalHours":{"description":"Minimum pause between two publications under the same prospect's own posts, in hours (1–168). Required while `enabled` is `true`.","type":"integer","minimum":1,"maximum":168}},"additionalProperties":false,"if":{"required":["enabled"],"properties":{"enabled":{"const":true}}},"then":{"required":["minimumIntervalHours"]}}},"additionalProperties":false,"required":["strategy","postFilters"]},"outreach":{"type":"object","description":"Optional private-outreach settings: the `warmUp` comment prerequisite, the independent `connectionRequests` switch, and the `directMessages` settings. All three subtrees are required when this object is passed; omit the whole object to keep the campaign defaults. Applies to `TARGET_USER` (Prospects) campaigns only — omit it for `KEYWORD` (Topic) campaigns.","properties":{"warmUp":{"type":"object","properties":{"enabled":{"description":"Master switch. Comment prerequisite for connection requests and the first DM, not follow-ups in an existing conversation. Off waives the prerequisite without disabling either outreach channel. While on, at least one comment path must be enabled. The comment paths are `direct.enabled` and `indirect.enabled`; a combination with both off is rejected, never silently repaired. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"direct":{"description":"Comments published under the prospect's own posts. Satisfies warm up on its own once its `commentTarget` is reached.","type":"object","properties":{"enabled":{"description":"Whether comments on this path count toward warm up. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"commentTarget":{"description":"Number of successfully published comments on this path that satisfies warm up. Positive integer. Direct and indirect comments are counted separately and never summed. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false},"indirect":{"description":"Comments published under indirect posts — posts from the people the prospect engages with, content the prospect is likely to see in their own feed. Satisfies warm up on its own once its `commentTarget` is reached.","type":"object","properties":{"enabled":{"description":"Whether comments on this path count toward warm up. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"commentTarget":{"description":"Number of successfully published comments on this path that satisfies warm up. Positive integer. Direct and indirect comments are counted separately and never summed. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false},"skipWarmUpWhenNoRecentPosts":{"description":"Waive the comment prerequisite when none of the post sources enabled for warm up has a post from the last 30 days. The window is fixed and cannot be configured per campaign. A source whose posts could not be fetched successfully never qualifies.","type":"boolean"},"stopWaiting":{"description":"Time-based waiver of the comment prerequisite.","type":"object","properties":{"enabled":{"description":"Enables a warm-up waiver after `afterDays` measured from `prospect.createdAt`, not necessarily entry into the current campaign. Moving or restoring a prospect may preserve that timestamp. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"afterDays":{"description":"Days since `prospect.createdAt` before warm-up is waived, when `stopWaiting` is enabled. Moving or restoring does not reliably restart the clock. Positive integer. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"additionalProperties":false,"not":{"required":["enabled","direct","indirect"],"properties":{"enabled":{"const":true},"direct":{"required":["enabled"],"properties":{"enabled":{"const":false}}},"indirect":{"required":["enabled"],"properties":{"enabled":{"const":false}}}}},"description":"Comment prerequisite for connection requests and the first DM, not follow-ups in an existing conversation. Off waives the prerequisite without disabling either outreach channel. While on, at least one comment path must be enabled."},"connectionRequests":{"type":"object","properties":{"enabled":{"description":"Whether the campaign sends automatic connection requests to prospects that satisfy warm up. Independent of `warmUp`: switching warm up off makes prospects eligible immediately, it does not stop connection requests. The switch applies to the whole campaign, including all of its prospect lists; invitations are sent without a note. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"withdraw":{"description":"Automatic withdrawal of connection requests that stay unaccepted.","type":"object","properties":{"enabled":{"description":"Withdraws a connection request that is still not accepted after `afterDays`. Only invitations Extrovert sent for this campaign are withdrawn, never ones that were already pending; it runs only while `connectionRequests.enabled` is on. A campaign created without `withdraw` starts with it on. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"afterDays":{"description":"Days an invitation waits for acceptance before it is withdrawn, 7–180; 20 on a new campaign. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","minimum":7,"maximum":180},"resendCount":{"description":"How many times a withdrawn prospect is invited again, 0–5; 0 (the default) never sends again. A new invitation goes out no earlier than 22 days after the withdrawal, through the normal connection-request flow. The count restarts when the prospect moves to another campaign. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","minimum":0,"maximum":5}},"additionalProperties":false}},"additionalProperties":false,"description":"Automatic connection requests of this campaign and the withdrawal of the ones that stay unaccepted."},"directMessages":{"type":"object","properties":{"enabled":{"description":"Master switch for DM recommendations, not automatic sending. Enabling from off requires `CAN_USE_DIRECT_MESSAGES` and at least one enabled `firstOutreach`/`followUps` path; turning it off remains allowed. A combination with both paths off is rejected, never silently repaired. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"firstOutreach":{"description":"First message to a prospect the campaign has not written to yet.","type":"object","properties":{"enabled":{"description":"Whether the campaign recommends the very first message to a newly connected prospect. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"waitAfterAcceptance":{"description":"Delay between an accepted connection and the first recommended message.","type":"object","properties":{"enabled":{"description":"Whether the first outreach waits a fixed time after the connection was accepted. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"days":{"description":"Number of days to wait after the prospect accepted the connection before the first message is recommended. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","minimum":1,"maximum":9007199254740991}},"additionalProperties":false},"autoEnabled":{"description":"Whether Extrovert sends a due first message automatically instead of leaving it for a person. Applies only while the step itself is enabled; off by default. Once on, Extrovert writes fresh text for each due conversation of this step and replaces the draft Extrovert prepared there, even after a person edited it or an assistant rewrote it. Before turning it on, check the campaign for such drafts, tell the user they will be replaced, and offer to send them first. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"}},"additionalProperties":false},"followUps":{"description":"Repeat messages to a prospect who has not replied yet.","type":"object","properties":{"enabled":{"description":"Whether the campaign recommends follow-up messages to prospects who have not replied. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"limit":{"description":"Cap on the number of follow-ups in one unanswered series.","type":"object","properties":{"isUnlimited":{"description":"`true` stores an unlimited cap and ignores `maxFollowUps`; the former finite cap is not retained separately. To return to a finite cap, send `false` and `maxFollowUps` together. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"maxFollowUps":{"description":"Finite cap for one unanswered series (1–5), ignored while `isUnlimited=true`. Returning from unlimited needs `isUnlimited=false` plus this number; an earlier finite cap is not automatically restored. Once the cap is reached the campaign stops recommending follow-ups to that prospect; manual messages and comment recommendations continue, and a reply from the prospect resets the series.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"additionalProperties":false,"if":{"not":{"required":["isUnlimited"],"properties":{"isUnlimited":{"const":true}}}},"then":{"properties":{"maxFollowUps":{"minimum":1,"maximum":5}}}},"cadenceDays":{"description":"Ladder of pauses in days, indexed by follow-up number: the first entry is the wait before the first follow-up, the second the wait before the second, and so on. Whole-group value — send an empty array (or omit it) to keep the stored ladder, or exactly 5 steps to replace it. Each entry is an independent pause, so the steps may be given in any order. The full ladder is always stored, including the steps the current `limit` hides, so raising the limit restores them.","anyOf":[{"maxItems":0},{"minItems":5,"maxItems":5}],"type":"array","items":{"type":"integer","minimum":1,"maximum":9007199254740991}},"tailCadenceDays":{"description":"Pause in days used from the follow-up right after the last `cadenceDays` step onwards. It is an independent pause like every `cadenceDays` entry, so it may be shorter than that last step.","type":"integer","minimum":1,"maximum":9007199254740991},"relevantPostAcceleration":{"description":"Bring a follow-up forward when the prospect publishes a post worth reacting to.","type":"object","properties":{"enabled":{"description":"Whether a fresh, referenceable post by the prospect may bring the next follow-up forward, ahead of the ladder pause. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"}},"additionalProperties":false},"autoEnabled":{"description":"Whether Extrovert sends due follow-ups automatically instead of leaving them for a person. Applies only while the step itself is enabled; off by default. Once on, Extrovert writes fresh text for each due conversation of this step and replaces the draft Extrovert prepared there, even after a person edited it or an assistant rewrote it. Before turning it on, check the campaign for such drafts, tell the user they will be replaced, and offer to send them first. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"}},"additionalProperties":false},"automaticSending":{"description":"Limits of the automatic DM steps of this campaign.","type":"object","properties":{"dailyCap":{"description":"Automatic DM send attempts per owner-local day; manual and agent sends never count. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"integer","minimum":1,"maximum":9007199254740991},"windowFromMin":{"description":"Start of the automatic sending window, minutes from midnight in the owner's timezone. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"integer","minimum":0,"maximum":1440},"windowToMin":{"description":"End of the automatic sending window, minutes from midnight in the owner's timezone; after `windowFromMin`. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"integer","minimum":0,"maximum":1440}},"additionalProperties":false}},"additionalProperties":false,"not":{"required":["enabled","firstOutreach","followUps"],"properties":{"enabled":{"const":true},"firstOutreach":{"required":["enabled"],"properties":{"enabled":{"const":false}}},"followUps":{"required":["enabled"],"properties":{"enabled":{"const":false}}}}},"description":"Deep-partial DM settings: omitted nested values keep stored values (defaults on create), explicit `false` applies. Enables DM recommendations; the separate firstOutreach.autoEnabled and followUps.autoEnabled switches control unattended sending."}},"additionalProperties":false,"required":["warmUp","connectionRequests","directMessages"]}},"required":["ownerId","name","type","voiceId","skipTeammatesLeads"]},"CreateResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Created entity ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]}},"required":["id"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"UpdateRequestDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Campaign id to update."},"name":{"type":"string","minLength":1,"description":"Updated display name."},"voiceId":{"type":"string","format":"uuid","description":"Voice id the campaign should use after the update. Always required: detaching a Voice is intentionally not possible through this API (internally an omitted field would mean 'remove'), so pass the current `voice.id` to keep it or another valid id to switch."},"skipTeammatesLeads":{"type":"boolean","description":"Prospects campaigns: skip profiles already present in teammates' campaigns. Enabling is rejected if duplicate prospects already exist; resolve those duplicates first. Keep the stored value for Topic campaigns."},"commenting":{"type":"object","description":"Whole comment policy of the campaign. `commenting` is replaced as a whole, never deep-merged: omit it to leave the stored policy untouched, or state the complete policy you want. A scalar omitted inside a group that IS stated therefore means off/none, not “keep the stored value”. A `TARGET_USER` (Prospects) campaign states `strategy`, `postFilters`, `frequency` and `feedCleanup`, and may state `indirectCommentingEnabled` and `publishingPace`; a `KEYWORD` (Topic) campaign states `strategy` and `postFilters` only — every other member is People-only and must be omitted. Whole-policy replacement, not a deep merge. Omit to retain it, except that disabling the last warm-up comment path may change stored `FINISH_FIRST` to `FRESHNESS_FIRST`; re-read after that outreach change.","properties":{"strategy":{"type":"string","enum":["FRESHNESS_FIRST","FINISH_FIRST","EVENLY_DISTRIBUTE"],"description":"Order in which comment opportunities are offered. `FRESHNESS_FIRST` puts the newest posts first; `FINISH_FIRST` puts the prospects closest to their Outreach warm-up target first and requires an enabled warm-up comment path; `EVENLY_DISTRIBUTE` spreads comments across prospects. Topic campaigns have no prospects and accept only `FRESHNESS_FIRST`."},"postFilters":{"type":"object","properties":{"maximumAgeDays":{"description":"Maximum eligible post age in days (1–30). Omitted within a supplied policy stores the default 28 days, not an unlimited window and not the maximum 30.","type":"integer","minimum":1,"maximum":30},"excludedPostCategories":{"maxItems":12,"type":"array","items":{"type":"string","enum":["THOUGHT_LEADERSHIP","BUSINESS_ISSUES","COMPANY_NEWS_OR_ACHIEVEMENTS","OFFLINE_EVENTS","ONLINE_EVENTS","SOCIAL_ISSUES","OWN_PRODUCT_PROMOTION","JOB_RELATED","PERSONAL_LIFE_BLOG","POLITICS","COMMENT_X_TO_GET_Y","EXTRA_SENSITIVE","OTHER"],"description":"AI post-category label, not emotional sentiment. `COMMENT_X_TO_GET_Y` requires a specified public comment for a promised return; `EXTRA_SENSITIVE` takes priority over other categories; `OTHER` means classified as none of the named categories, not unclassified."},"description":"AI-classified categories to exclude. `[]` allows all categories, including unclassified posts; a non-empty exclusion list also excludes unclassified posts. At least one known category must remain allowed, so at most 12 of the 13 values may be excluded — excluding all of them is rejected, not treated as a pause switch."},"monitoredTopicIds":{"description":"Prospects campaigns only: allow posts whose assigned Monitored Topic is in this owner-owned set. `[]` or omission removes this filter; unmatched/unclassified posts fail a non-empty filter. Foreign or stale topic IDs are dropped. Non-empty requires `CAN_FILTER_POSTS_BY_RELEVANT_TAGS`; without it the write returns 403.","maxItems":1000,"type":"array","items":{"type":"string","format":"uuid"}},"minimumReactionCount":{"description":"Topic campaigns only: minimum total reactions across all reaction types (1–50). Omitted disables the threshold; an unknown reaction count fails an enabled threshold. Applies to `KEYWORD` (Topic) campaigns only — omit it for `TARGET_USER` (Prospects) campaigns; the backend rejects it there.","type":"integer","minimum":1,"maximum":50}},"required":["excludedPostCategories"],"additionalProperties":false,"description":"Which posts qualify for a comment at all."},"frequency":{"description":"How often the campaign may comment on the same prospect. Applies to `TARGET_USER` (Prospects) campaigns only — omit it for `KEYWORD` (Topic) campaigns, which have no prospects.","type":"object","properties":{"intervalDays":{"description":"Minimum days (1–60) after the prospect's latest published or already approved/scheduled comment touch before another opportunity is eligible. Omitted = every eligible post.","type":"integer","minimum":1,"maximum":60},"changeAfterPublishedComments":{"type":"object","properties":{"enabled":{"description":"Whether the campaign changes its comment frequency for a prospect once a published-comment threshold is reached.","type":"boolean"},"directCommentCount":{"description":"Published direct comments after which the change applies. Positive integer, no upper bound. The direct and indirect thresholds are independent — either one reaching its count triggers the change, and they are never summed. The stored value is preserved while its switch is off, so it can be restored later.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"indirectCommentCount":{"description":"Published indirect comments after which the change applies. Positive integer, no upper bound. Not evaluated while `indirectCommentingEnabled` is off. The stored value is preserved while its switch is off, so it can be restored later.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"modeAfterThreshold":{"description":"What happens once a threshold is reached. `LOWER_FREQUENCY` keeps commenting at `intervalDaysAfterThreshold`; `STOP` removes the prospect from selection entirely. Required while `enabled` is `true`.","type":"string","enum":["LOWER_FREQUENCY","STOP"]},"intervalDaysAfterThreshold":{"description":"Eligibility pause in days after the threshold (1–60), measured from the latest published or already approved/scheduled comment touch; required for `LOWER_FREQUENCY` and must exceed `intervalDays` when that base interval is provided. The stored value is preserved while its switch is off, so it can be restored later.","type":"integer","minimum":1,"maximum":60}},"additionalProperties":false,"if":{"required":["enabled"],"properties":{"enabled":{"const":true}}},"then":{"required":["modeAfterThreshold"],"anyOf":[{"required":["directCommentCount"]},{"required":["indirectCommentCount"]}]},"description":"Change the frequency once enough comments have been published for a prospect. Required whenever `frequency` is stated; state it with `enabled: false` to keep the policy at one frequency."}},"required":["changeAfterPublishedComments"],"additionalProperties":false,"$comment":"intervalDaysAfterThreshold must be greater than intervalDays."},"feedCleanup":{"description":"Automatic skip of a prospect's surplus active posts; revertable from the Skipped tab. Applies to `TARGET_USER` (Prospects) campaigns only — omit it for `KEYWORD` (Topic) campaigns, which have no prospects.","type":"object","properties":{"autoRejectOverflowPostsEnabled":{"description":"Automatically skip a prospect's oldest active posts once more than `maxActivePostsPerProspect` of them are active. The skip applies to the publishing owner across every campaign of that owner, so the posts also leave the feed elsewhere; any of them can be moved back for approval from the Skipped tab, though the cap may skip an untouched one again. Posts whose comment is already published or publishing are never touched. New Prospects campaigns start with this on (`true`).","type":"boolean"},"maxActivePostsPerProspect":{"description":"How many posts of one prospect may stay active (1–10). Omitting it stores 3. The stored value is preserved while its switch is off, so it can be restored later.","type":"integer","minimum":1,"maximum":10}},"additionalProperties":false},"indirectCommentingEnabled":{"description":"Also pull indirect posts — posts from the people a prospect engages with most, content the prospect is likely to see in their own feed — so the campaign can comment on those too. Main use case: reaching prospects who rarely post themselves. Plan-gated — changing it requires `CAN_OBTAIN_REACTIONS`; without it the write returns 403, while an unchanged value is allowed. Applies to `TARGET_USER` (Prospects) campaigns only — omit it for `KEYWORD` (Topic) campaigns, which have no prospects.","type":"boolean"},"publishingPace":{"description":"Spacing between publications of approved comments for the same prospect. Applies to `TARGET_USER` (Prospects) campaigns only — omit it for `KEYWORD` (Topic) campaigns, which have no prospects.","type":"object","properties":{"enabled":{"description":"Whether publication of approved comments for the same prospect is spaced out. It spaces direct comments only — the ones under the prospect's own posts; indirect comments are never spaced by it. Plan-gated — changing it requires `CAN_MANAGE_DELAYED_POSTING`; without it the write returns 403, while an unchanged value is allowed.","type":"boolean"},"minimumIntervalHours":{"description":"Minimum pause between two publications under the same prospect's own posts, in hours (1–168). Required while `enabled` is `true`.","type":"integer","minimum":1,"maximum":168}},"additionalProperties":false,"if":{"required":["enabled"],"properties":{"enabled":{"const":true}}},"then":{"required":["minimumIntervalHours"]}}},"additionalProperties":false,"required":["strategy","postFilters"]},"outreach":{"type":"object","description":"Optional deep-partial update of the private-outreach settings. Send only the nested fields that should change: omitted fields keep their stored value, an explicit `false` is applied, and the backend validates the merged result before saving it.","properties":{"warmUp":{"description":"Comment prerequisite for connection requests and the first DM, not follow-ups in an existing conversation. Off waives the prerequisite without disabling either outreach channel. While on, at least one comment path must be enabled.","type":"object","properties":{"enabled":{"description":"Master switch. Comment prerequisite for connection requests and the first DM, not follow-ups in an existing conversation. Off waives the prerequisite without disabling either outreach channel. While on, at least one comment path must be enabled. The comment paths are `direct.enabled` and `indirect.enabled`; a combination with both off is rejected, never silently repaired. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"direct":{"description":"Comments published under the prospect's own posts. Satisfies warm up on its own once its `commentTarget` is reached.","type":"object","properties":{"enabled":{"description":"Whether comments on this path count toward warm up. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"commentTarget":{"description":"Number of successfully published comments on this path that satisfies warm up. Positive integer. Direct and indirect comments are counted separately and never summed. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false},"indirect":{"description":"Comments published under indirect posts — posts from the people the prospect engages with, content the prospect is likely to see in their own feed. Satisfies warm up on its own once its `commentTarget` is reached.","type":"object","properties":{"enabled":{"description":"Whether comments on this path count toward warm up. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"commentTarget":{"description":"Number of successfully published comments on this path that satisfies warm up. Positive integer. Direct and indirect comments are counted separately and never summed. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false},"skipWarmUpWhenNoRecentPosts":{"description":"Waive the comment prerequisite when none of the post sources enabled for warm up has a post from the last 30 days. The window is fixed and cannot be configured per campaign. A source whose posts could not be fetched successfully never qualifies.","type":"boolean"},"stopWaiting":{"description":"Time-based waiver of the comment prerequisite.","type":"object","properties":{"enabled":{"description":"Enables a warm-up waiver after `afterDays` measured from `prospect.createdAt`, not necessarily entry into the current campaign. Moving or restoring a prospect may preserve that timestamp. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"afterDays":{"description":"Days since `prospect.createdAt` before warm-up is waived, when `stopWaiting` is enabled. Moving or restoring does not reliably restart the clock. Positive integer. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"additionalProperties":false,"not":{"required":["enabled","direct","indirect"],"properties":{"enabled":{"const":true},"direct":{"required":["enabled"],"properties":{"enabled":{"const":false}}},"indirect":{"required":["enabled"],"properties":{"enabled":{"const":false}}}}}},"connectionRequests":{"description":"Automatic connection requests of this campaign and the withdrawal of the ones that stay unaccepted.","type":"object","properties":{"enabled":{"description":"Whether the campaign sends automatic connection requests to prospects that satisfy warm up. Independent of `warmUp`: switching warm up off makes prospects eligible immediately, it does not stop connection requests. The switch applies to the whole campaign, including all of its prospect lists; invitations are sent without a note. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"withdraw":{"description":"Automatic withdrawal of connection requests that stay unaccepted.","type":"object","properties":{"enabled":{"description":"Withdraws a connection request that is still not accepted after `afterDays`. Only invitations Extrovert sent for this campaign are withdrawn, never ones that were already pending; it runs only while `connectionRequests.enabled` is on. A campaign created without `withdraw` starts with it on. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"afterDays":{"description":"Days an invitation waits for acceptance before it is withdrawn, 7–180; 20 on a new campaign. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","minimum":7,"maximum":180},"resendCount":{"description":"How many times a withdrawn prospect is invited again, 0–5; 0 (the default) never sends again. A new invitation goes out no earlier than 22 days after the withdrawal, through the normal connection-request flow. The count restarts when the prospect moves to another campaign. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","minimum":0,"maximum":5}},"additionalProperties":false}},"additionalProperties":false},"directMessages":{"description":"Deep-partial DM settings: omitted nested values keep stored values (defaults on create), explicit `false` applies. Enables DM recommendations; the separate firstOutreach.autoEnabled and followUps.autoEnabled switches control unattended sending.","type":"object","properties":{"enabled":{"description":"Master switch for DM recommendations, not automatic sending. Enabling from off requires `CAN_USE_DIRECT_MESSAGES` and at least one enabled `firstOutreach`/`followUps` path; turning it off remains allowed. A combination with both paths off is rejected, never silently repaired. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"firstOutreach":{"description":"First message to a prospect the campaign has not written to yet.","type":"object","properties":{"enabled":{"description":"Whether the campaign recommends the very first message to a newly connected prospect. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"waitAfterAcceptance":{"description":"Delay between an accepted connection and the first recommended message.","type":"object","properties":{"enabled":{"description":"Whether the first outreach waits a fixed time after the connection was accepted. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"days":{"description":"Number of days to wait after the prospect accepted the connection before the first message is recommended. The stored value is preserved while the switch is off, so it can be restored later.","type":"integer","minimum":1,"maximum":9007199254740991}},"additionalProperties":false},"autoEnabled":{"description":"Whether Extrovert sends a due first message automatically instead of leaving it for a person. Applies only while the step itself is enabled; off by default. Once on, Extrovert writes fresh text for each due conversation of this step and replaces the draft Extrovert prepared there, even after a person edited it or an assistant rewrote it. Before turning it on, check the campaign for such drafts, tell the user they will be replaced, and offer to send them first. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"}},"additionalProperties":false},"followUps":{"description":"Repeat messages to a prospect who has not replied yet.","type":"object","properties":{"enabled":{"description":"Whether the campaign recommends follow-up messages to prospects who have not replied. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"limit":{"description":"Cap on the number of follow-ups in one unanswered series.","type":"object","properties":{"isUnlimited":{"description":"`true` stores an unlimited cap and ignores `maxFollowUps`; the former finite cap is not retained separately. To return to a finite cap, send `false` and `maxFollowUps` together. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"},"maxFollowUps":{"description":"Finite cap for one unanswered series (1–5), ignored while `isUnlimited=true`. Returning from unlimited needs `isUnlimited=false` plus this number; an earlier finite cap is not automatically restored. Once the cap is reached the campaign stops recommending follow-ups to that prospect; manual messages and comment recommendations continue, and a reply from the prospect resets the series.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"additionalProperties":false,"if":{"not":{"required":["isUnlimited"],"properties":{"isUnlimited":{"const":true}}}},"then":{"properties":{"maxFollowUps":{"minimum":1,"maximum":5}}}},"cadenceDays":{"description":"Ladder of pauses in days, indexed by follow-up number: the first entry is the wait before the first follow-up, the second the wait before the second, and so on. Whole-group value — send an empty array (or omit it) to keep the stored ladder, or exactly 5 steps to replace it. Each entry is an independent pause, so the steps may be given in any order. The full ladder is always stored, including the steps the current `limit` hides, so raising the limit restores them.","anyOf":[{"maxItems":0},{"minItems":5,"maxItems":5}],"type":"array","items":{"type":"integer","minimum":1,"maximum":9007199254740991}},"tailCadenceDays":{"description":"Pause in days used from the follow-up right after the last `cadenceDays` step onwards. It is an independent pause like every `cadenceDays` entry, so it may be shorter than that last step.","type":"integer","minimum":1,"maximum":9007199254740991},"relevantPostAcceleration":{"description":"Bring a follow-up forward when the prospect publishes a post worth reacting to.","type":"object","properties":{"enabled":{"description":"Whether a fresh, referenceable post by the prospect may bring the next follow-up forward, ahead of the ladder pause. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"}},"additionalProperties":false},"autoEnabled":{"description":"Whether Extrovert sends due follow-ups automatically instead of leaving them for a person. Applies only while the step itself is enabled; off by default. Once on, Extrovert writes fresh text for each due conversation of this step and replaces the draft Extrovert prepared there, even after a person edited it or an assistant rewrote it. Before turning it on, check the campaign for such drafts, tell the user they will be replaced, and offer to send them first. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"boolean"}},"additionalProperties":false},"automaticSending":{"description":"Limits of the automatic DM steps of this campaign.","type":"object","properties":{"dailyCap":{"description":"Automatic DM send attempts per owner-local day; manual and agent sends never count. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"integer","minimum":1,"maximum":9007199254740991},"windowFromMin":{"description":"Start of the automatic sending window, minutes from midnight in the owner's timezone. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"integer","minimum":0,"maximum":1440},"windowToMin":{"description":"End of the automatic sending window, minutes from midnight in the owner's timezone; after `windowFromMin`. On update, an omitted field keeps its stored value and an explicit `false` is applied; the merged result is validated against the campaign's current settings before it is saved.","type":"integer","minimum":0,"maximum":1440}},"additionalProperties":false}},"additionalProperties":false,"not":{"required":["enabled","firstOutreach","followUps"],"properties":{"enabled":{"const":true},"firstOutreach":{"required":["enabled"],"properties":{"enabled":{"const":false}}},"followUps":{"required":["enabled"],"properties":{"enabled":{"const":false}}}}}}},"additionalProperties":false}},"required":["id","name","voiceId","skipTeammatesLeads"]},"UpdateResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"UpdateAutomaticCommentsSettingsRequestDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Campaign id whose automatic-comments settings should be updated."},"isEnabled":{"type":"boolean","description":"Publishes comments without manual review when true. First enable copies available account work hours; with no enabled account hours the window can remain absent. Disabling stops new scheduling, not already scheduled publications."},"dailyCap":{"type":"integer","description":"Target automatic comments per day, default 10 and at least 1; manual comments do not consume it. A supplied cap cannot exceed the owner account's daily comment limit. Caps are checked separately, not summed; omit to retain the stored cap.","minimum":1,"maximum":9007199254740991},"windowFromMin":{"type":"integer","description":"Active window start. Owner-timezone minutes after midnight (0–1440). After merging, both bounds must exist together with start < end; equal bounds are invalid. Effective hours intersect the account work schedule.","minimum":0,"maximum":1440},"windowToMin":{"type":"integer","description":"Active window end. Owner-timezone minutes after midnight (0–1440). After merging, both bounds must exist together with start < end; equal bounds are invalid. Effective hours intersect the account work schedule.","minimum":0,"maximum":1440},"mainFeedPriority":{"type":"string","description":"Main Feed queue priority: `LESS_OFTEN` = Low (weight 1), `BALANCED` = Normal (weight 2), `MORE_OFTEN` = High (weight 4). Does not control Auto-comment publication frequency. Absent keeps the stored value.","enum":["LESS_OFTEN","BALANCED","MORE_OFTEN"]}},"required":["id","isEnabled"]},"UpdateAutomaticCommentsSettingsResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"DeleteRequestDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Campaign id to delete."}},"required":["id"]},"DeleteResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"StartResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"StopResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"DuplicateResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Created entity ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]}},"required":["id"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"ShareRequestDto":{"type":"object","properties":{"campaignId":{"type":"string","format":"uuid","description":"Campaign id whose sharing settings should be updated."},"usersIds":{"type":"array","maxItems":1000,"items":{"type":"string","format":"uuid"},"description":"Replace the complete list of explicit teammate user-ID grants. `[]` removes explicit grants; also send `shareWithAllWorkspaceUsers=false` to remove whole-team sharing. This does not revoke managed-account administration or workspace API access. Non-owner callers cannot share a managed-account campaign."},"shareWithAllWorkspaceUsers":{"type":"boolean","description":"Whole-team access flag, independent of explicit `usersIds` grants. Omit to retain the stored flag; `false` is required to revoke whole-team access."}},"required":["campaignId","usersIds"]},"ShareResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"TransferRequestDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stopped Prospects campaign to transfer; wait until its current transition finishes. Topic campaigns cannot transfer. Transfer returns a new campaign ID and can reset topic filters and sharing."},"ownerId":{"type":"string","format":"uuid","description":"Different user who will own the resulting campaign. Recipient campaign-count and prospect-capacity rules apply, including per-owner trial pools."},"voiceId":{"type":"string","format":"uuid","description":"Voice owned by the new `ownerId`, not the old campaign owner; select from that owner's Voices."}},"required":["id","ownerId","voiceId"]},"TransferResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Created entity ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]}},"required":["id"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetContextResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"totalBalance":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Credits available in the workspace wallet."},"planBalance":{"description":"Part of `totalBalance` granted by the plan. Present only for a workspace admin.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"purchasedBalance":{"description":"Part of `totalBalance` that was bought. Present only for a workspace admin.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"actionRates":{"type":"array","items":{"type":"object","properties":{"actionType":{"type":"string","enum":["LEAD_FINDER_PROSPECT_EXPORT","SOCIAL_REACTIONS","INFLUENCER_ENGAGEMENT","COMPANY_PAGE_ENGAGEMENT","SOCIAL_MENTIONS","COMPETITOR_SOCIAL_REACTIONS","JOB_CHANGES","EMPLOYEE_DEPARTURE","JOB_OFFERS","FUNDRAISING","MERGERS_AND_ACQUISITIONS","COMPANY_GROWTH","DEPARTMENT_GROWTH","REPUBLISHED_JOB_OFFERS","RECRUITMENT_CAMPAIGN","COMPANY_REGISTRATION","COMPETITOR_RELATIONSHIPS","COMPETITOR_CUSTOMER_CARE","LINKEDIN_LOOKUP"],"description":"Billable product action."},"rate":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Credits charged per delivered result of this action."}},"required":["actionType","rate"]},"description":"What every billable action costs, in catalog order."},"nextPlanAllocationAt":{"description":"When the next plan credit allocation lands. Absent together with `nextPlanAllocationAmount` when none is scheduled.","type":"string","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"nextPlanAllocationAmount":{"description":"How many credits the next plan allocation adds.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["totalBalance","actionRates"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetUsageResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"list":{"type":"array","items":{"type":"object","properties":{"createdAt":{"type":"string","description":"When the credits were consumed.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"actionType":{"description":"Billable action the credits paid for; absent when none was recorded.","type":"string","enum":["LEAD_FINDER_PROSPECT_EXPORT","SOCIAL_REACTIONS","INFLUENCER_ENGAGEMENT","COMPANY_PAGE_ENGAGEMENT","SOCIAL_MENTIONS","COMPETITOR_SOCIAL_REACTIONS","JOB_CHANGES","EMPLOYEE_DEPARTURE","JOB_OFFERS","FUNDRAISING","MERGERS_AND_ACQUISITIONS","COMPANY_GROWTH","DEPARTMENT_GROWTH","REPUBLISHED_JOB_OFFERS","RECRUITMENT_CAMPAIGN","COMPANY_REGISTRATION","COMPETITOR_RELATIONSHIPS","COMPETITOR_CUSTOMER_CARE","LINKEDIN_LOOKUP"]},"consumedForUserId":{"description":"Account the consumed results belong to; absent when none.","type":"string","format":"uuid"},"consumedForUserDisplayName":{"type":"string","description":"Name of that account, or `Deleted user` when it no longer exists."},"resultCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Delivered results the consumption paid for."},"amountConsumed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Credits consumed."}},"required":["createdAt","consumedForUserDisplayName","resultCount","amountConsumed"]},"description":"Consumptions on this page."},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of records requested for this page."},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Offset from the start of the filtered result set."},"total":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Total records available for the same filters."}},"required":["limit","offset","total"],"description":"Pagination information, if returned by the backend"}},"required":["list"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetBalanceActivityResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"list":{"type":"array","items":{"type":"object","properties":{"createdAt":{"type":"string","description":"When the operation was applied.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"operationType":{"type":"string","enum":["PLAN_ALLOCATION","SEAT_INCREASE","PURCHASE","CONSUMPTION","FORFEITURE","CORRECTION"],"description":"Kind of the operation."},"actionType":{"description":"Billable action; present only on a `CONSUMPTION`.","type":"string","enum":["LEAD_FINDER_PROSPECT_EXPORT","SOCIAL_REACTIONS","INFLUENCER_ENGAGEMENT","COMPANY_PAGE_ENGAGEMENT","SOCIAL_MENTIONS","COMPETITOR_SOCIAL_REACTIONS","JOB_CHANGES","EMPLOYEE_DEPARTURE","JOB_OFFERS","FUNDRAISING","MERGERS_AND_ACQUISITIONS","COMPANY_GROWTH","DEPARTMENT_GROWTH","REPUBLISHED_JOB_OFFERS","RECRUITMENT_CAMPAIGN","COMPANY_REGISTRATION","COMPETITOR_RELATIONSHIPS","COMPETITOR_CUSTOMER_CARE","LINKEDIN_LOOKUP"]},"resultCount":{"description":"Delivered results paid for; present only on a `CONSUMPTION`.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"applicableUserId":{"description":"Account a consumption was made for, or the user who started a purchase or correction; absent when none.","type":"string","format":"uuid"},"applicableUserDisplayName":{"description":"Name of that account, or `Deleted user` when it no longer exists.","type":"string"},"amountDelta":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Signed change of the wallet total."},"planBalanceDelta":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Signed change of the plan credits."},"purchasedBalanceDelta":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Signed change of the bought credits."},"balanceAfter":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Wallet total right after this operation."}},"required":["createdAt","operationType","amountDelta","planBalanceDelta","purchasedBalanceDelta","balanceAfter"]},"description":"Operations on this page."},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of records requested for this page."},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Offset from the start of the filtered result set."},"total":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Total records available for the same filters."}},"required":["limit","offset","total"],"description":"Pagination information, if returned by the backend"}},"required":["list"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetSearchSchemaResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"version":{"type":"string","description":"Grammar identifier, currently `people.v1`; sent back as `schemaVersion`."},"fields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","description":"The field id a query condition names as its `field`, e.g. `contact.seniority`.","examples":["contact.seniority","account.industries"]},"control":{"type":"string","description":"Which payload keys a condition on this field takes; the search-schema guide lists the payload keys of each control (`instructions` over MCP, the endpoint description in the Public API)."},"valuePolicy":{"type":"string","description":"`closed`: only a value from `values`, matched exactly. `custom`: any value; some custom fields have a catalog."},"valueSyntax":{"description":"`numeric_code`: a 6-digit NAICS code such as `541511`. Omitted for free text.","type":"string"},"numericDomain":{"description":"What the bounds count: `count` (whole, non-negative), `amount_usd` (non-negative, decimals allowed), `year`, `percent` (may be negative).","type":"string"},"scope":{"description":"`latest`: the primary active role; `current`: every active role; `previous`: past roles. Omitted when not applicable.","type":"string"},"matchModes":{"type":"array","items":{"type":"string"},"description":"Accepted `mode` values. SMART also matches similar or related values. WORD matches the exact phrase, with extra words allowed before or after it. STRICT matches the complete field value, with no extra words. Empty when the control has no mode."},"values":{"type":"array","items":{"type":"string"},"description":"The whole vocabulary of a `closed` field; empty for `custom`."},"sources":{"type":"array","items":{"type":"string"},"description":"Sections the `sources` of a keyword condition may name; empty on other fields."},"timeFrames":{"type":"array","items":{"type":"string"},"description":"Growth windows in months: `THREE`, `SIX`, `TWELVE`, `TWENTY_FOUR`; empty on other fields."},"maxSources":{"description":"Most sources one keyword condition takes.","type":"number"},"ops":{"type":"array","items":{"type":"string"},"description":"The `op` values a condition on this field accepts; never empty.","examples":[["any.include","any.exclude"],["range"]]}},"required":["field","control","valuePolicy","matchModes","values","sources","timeFrames","ops"]},"description":"Every field a query condition may filter on, and what each accepts."},"limits":{"description":"Bounds a whole query is held to.","type":"object","properties":{"maxValuesPerArray":{"type":"number","description":"Most values one `values` list of a condition takes; location values count after economic zones are expanded to countries."},"maxQueryBytes":{"type":"number","description":"Largest query accepted, in bytes, counted after the backend normalizes it."},"maxQueryDepth":{"type":"number","description":"Deepest nesting the query may have."},"maxPageSize":{"type":"number","description":"People the preview returns per query."},"resultCeiling":{"type":"number","description":"Deepest match a search reaches; a `FILTERS` import cannot ask for more prospects than this."}},"required":["maxValuesPerArray","maxQueryBytes","maxQueryDepth","maxPageSize","resultCeiling"]},"rules":{"description":"Whole-query refusals no single condition expresses.","type":"object","properties":{"excludeOnlyQueryRejected":{"type":"boolean","description":"A query made only of `any.exclude` conditions is refused."},"emptyQueryRejected":{"type":"boolean","description":"A query with no condition is refused."}},"required":["excludeOnlyQueryRejected","emptyQueryRejected"]}},"description":"The published people-search filter grammar.","required":["version","fields"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetIndustriesResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"string"},"description":"Every industry name."},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"SearchTechnologiesResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"string"},"description":"Matching technology names, most widely used first."},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"SearchLocationsResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"string"},"description":"Matching location names, broadest tier first."},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"PreviewPeopleRequestDto":{"type":"object","properties":{"schemaVersion":{"type":"string","minLength":1,"description":"The `version` the search schema currently reports, e.g. `people.v1`. Any other value is refused.","examples":["people.v1"]},"query":{"type":"object","properties":{"filters":{"type":"array","items":{"allOf":[{"type":"object","properties":{"field":{"type":"string","description":"The field the condition filters on: a `field` the search schema lists, e.g. `contact.seniority`.","examples":["contact.seniority","account.employeeSize"]},"op":{"type":"string","description":"The operation: one of the `ops` the search schema lists for that field, e.g. `any.include` or `range`. `all.include`: requires every supplied value to match using the selected match mode; a value containing spaces remains one value.","examples":["any.include","range"]}},"required":["field","op"],"additionalProperties":{},"description":"One condition: `field`, `op` and the payload keys of the field's `control` (for example `mode` and `values`, `values`, `ranges`, `start`/`end`, `min`/`max`, `rows`). A key the control does not take is refused, naming it. `mode`: SMART also matches similar or related values. WORD matches the exact phrase, with extra words allowed before or after it. STRICT matches the complete field value, with no extra words. A `keyword_sources` condition puts `mode` on each `sources[]` entry instead."},{}]},"description":"The conditions, combined with AND. Each `field` and `op` pair appears at most once, and its one condition holds all of its values."}},"additionalProperties":false,"description":"The people-search query: the flat list of conditions `{\"filters\":[…]}` in the grammar Get Lead Finder Search Schema publishes. A key the grammar does not accept is refused, naming it; no key is dropped silently.","examples":[{"filters":[{"field":"contact.titleLatest","op":"any.include","mode":"SMART","values":["head of sales","sales director"]},{"field":"contact.seniority","op":"any.include","values":["director","head","vp"]},{"field":"contact.location","op":"any.include","values":["Germany"]},{"field":"account.industries","op":"any.include","mode":"SMART","values":["software development"]},{"field":"account.employeeSize","op":"range","ranges":[{"start":51,"end":500}]}]}],"required":["filters"]}},"required":["schemaVersion","query"]},"PreviewPeopleResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"people":{"type":"array","items":{"type":"object","properties":{"providerId":{"type":"string","description":"Row id of the person in this preview, the only identifier a row carries; a `SELECTED` import names rows by it."},"maskedName":{"description":"First name and masked last name, e.g. `Ada Fr***n`. Never a full name.","type":"string"},"title":{"description":"Job title.","type":"string"},"headline":{"description":"Profile headline.","type":"string"},"seniority":{"description":"One of the `contact.seniority` values the search schema publishes.","type":"string"},"departments":{"type":"array","items":{"type":"string"},"description":"Departments."},"subDepartments":{"type":"array","items":{"type":"string"},"description":"Sub-departments."},"functions":{"type":"array","items":{"type":"string"},"description":"Functions."},"location":{"description":"Where the person is now, as one line (`city, country, continent`); the location to show for the person.","type":"string"},"positions":{"type":"array","items":{"type":"object","properties":{"companyName":{"description":"Employer name.","type":"string"},"dateStart":{"description":"Start date.","type":"string"},"dateEnd":{"description":"End date; absent for a current role.","type":"string"},"employeesStart":{"description":"Lower bound of the headcount range of that position's employer, per provider data; not the headcount when the person joined or left. The date of this data is unknown, so it may not be current.","type":"number"},"employeesEnd":{"description":"Upper bound of the headcount range of that position's employer, per provider data; not the headcount when the person joined or left. The date of this data is unknown, so it may not be current.","type":"number"},"location":{"description":"Location of that position, when known; not where the person is now.","type":"string"}}},"description":"Position history, newest first."},"company":{"description":"The current company card.","type":"object","properties":{"name":{"description":"Company name.","type":"string"},"industry":{"description":"Industry name.","type":"string"},"description":{"description":"Company description.","type":"string"},"staffTotal":{"description":"The company's current headcount.","type":"number"},"staffRangeStart":{"description":"Lower end of the company's current headcount band; the company size to show.","type":"number"},"staffRangeEnd":{"description":"Upper end of the company's current headcount band.","type":"number"},"foundedYear":{"description":"Founding year.","type":"number"},"headquarters":{"description":"Headquarters as one address line (`city, state, country`).","type":"string"},"offices":{"type":"array","items":{"type":"string"},"description":"Other office locations, one address line each; not the headquarters."},"revenueStart":{"description":"Lower end of the annual revenue band, in USD.","type":"number"},"revenueEnd":{"description":"Upper end of the annual revenue band, in USD.","type":"number"}},"required":["offices"]},"lastUpdated":{"description":"Date the profile data was last refreshed (`YYYY-MM-DD`).","type":"string"}},"required":["providerId","departments","subDepartments","functions","positions"]},"description":"The first page of the people matched, masked; there is no further page. Values are verbatim, never formatted; an absent field means nothing is known."},"grossTotal":{"description":"How many people matched the query when the preview ran: the number matched, not a count of new prospects and not a limit an import checks. Absent when the total is not available.","type":"number"}},"description":"The first page of the people matched, masked, and how many people match in total.","required":["people"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"ImportProspectsRequestDto":{"type":"object","properties":{"mode":{"type":"string","enum":["FILTERS","SELECTED"],"description":"`FILTERS` requests `count` matches of `query` starting at `startOffset`, not a page of guaranteed unimported people; `SELECTED` uses distinct preview `providerIds`. Selected IDs not returned by the provider are skipped, so delivery is not guaranteed."},"schemaVersion":{"type":"string","minLength":1,"description":"The `version` the search schema currently reports, e.g. `people.v1`. Any other value is refused.","examples":["people.v1"]},"query":{"type":"object","description":"`FILTERS` only: the people-search query, the flat list of conditions `{\"filters\":[…]}` in the grammar Get Lead Finder Search Schema publishes — the same query the preview took. Omit for `SELECTED`: it does not select or exclude people, although a supplied query still must pass the gateway’s input validation. A key the grammar does not accept is refused, naming it; no key is dropped silently.","examples":[{"filters":[{"field":"contact.titleLatest","op":"any.include","mode":"SMART","values":["head of sales","sales director"]},{"field":"contact.seniority","op":"any.include","values":["director","head","vp"]},{"field":"contact.location","op":"any.include","values":["Germany"]},{"field":"account.industries","op":"any.include","mode":"SMART","values":["software development"]},{"field":"account.employeeSize","op":"range","ranges":[{"start":51,"end":500}]}]}],"properties":{"filters":{"type":"array","items":{"allOf":[{"type":"object","properties":{"field":{"type":"string","description":"The field the condition filters on: a `field` the search schema lists, e.g. `contact.seniority`.","examples":["contact.seniority","account.employeeSize"]},"op":{"type":"string","description":"The operation: one of the `ops` the search schema lists for that field, e.g. `any.include` or `range`. `all.include`: requires every supplied value to match using the selected match mode; a value containing spaces remains one value.","examples":["any.include","range"]}},"required":["field","op"],"additionalProperties":{},"description":"One condition: `field`, `op` and the payload keys of the field's `control` (for example `mode` and `values`, `values`, `ranges`, `start`/`end`, `min`/`max`, `rows`). A key the control does not take is refused, naming it. `mode`: SMART also matches similar or related values. WORD matches the exact phrase, with extra words allowed before or after it. STRICT matches the complete field value, with no extra words. A `keyword_sources` condition puts `mode` on each `sources[]` entry instead."},{}]},"description":"The conditions, combined with AND. Each `field` and `op` pair appears at most once, and its one condition holds all of its values."}},"additionalProperties":false,"required":["filters"]},"count":{"type":"integer","description":"`FILTERS`: required number of matches to request from `startOffset` in the live query results. Omit for `SELECTED`: selection uses distinct `providerIds`, not `count`. If supplied, `count` still must pass the input type and bounds. A count above the Prospect Capacity left or above what the balance covers, or a window with `startOffset + count` above the search schema's `limits.resultCeiling`, is refused before anything starts; an import is never trimmed to fit. The import stops when matches run out and charges only what it retrieved. Previously imported people may appear in the window and are retrieved and charged again; live ordering can shift, so a later offset does not guarantee new people.","examples":[50],"minimum":1,"maximum":2147483647},"startOffset":{"type":"integer","description":"Zero-based start of the `FILTERS` purchase window in the live query results. Omitted means zero at the backend. `startOffset + count` must not exceed the search schema's `limits.resultCeiling` (10000). `SELECTED` permits only omitted or zero. Live ordering can change between purchases; skipped rows are not bought and the offset does not guarantee new people.","examples":[0,100],"minimum":0,"maximum":2147483647},"providerIds":{"type":"array","description":"`SELECTED`: `providerId` values from preview, 1 to 100; a repeated id counts once. Omit for `FILTERS`: they do not limit, exclude, or add query matches. If supplied, the array still must pass input validation.","minItems":1,"maxItems":100,"items":{"type":"string","minLength":1}},"destination":{"properties":{"campaignId":{"type":"string","format":"uuid","description":"Campaign whose prospect list receives the import. It must be a Prospects campaign (`TARGET_USER`); a campaign of any other type is refused. Campaigns are never created here."},"listId":{"description":"An existing prospect list of the campaign; omit it or send `null` when `listName` names a new one.","anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"listName":{"description":"Name of a new prospect list to create under the campaign; omit it or send `null` when `listId` names an existing one.","anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"moveOwnDuplicated":{"type":"boolean","description":"Move prospects the campaign owner already holds in another list into this one instead of leaving them where they are."},"onlyRecentlyActive":{"type":"boolean","description":"Remove prospects with no LinkedIn post in the last 30 days once their posts are first collected, after the import. They are imported and charged like the others."}},"description":"Where the prospects land. Exactly one of `listId` and `listName` is set; the other is omitted or `null`.","oneOf":[{"title":"Existing list","description":"Import into an existing prospect list of the campaign: `listId` set, `listName` omitted or null.","required":["listId"],"properties":{"listId":{"type":"string"},"listName":{"type":"null"}}},{"title":"New list","description":"Create a new prospect list under the campaign: `listName` set, `listId` omitted or null.","required":["listName"],"properties":{"listId":{"type":"null"},"listName":{"type":"string"}}}],"required":["campaignId","moveOwnDuplicated","onlyRecentlyActive"]},"idempotencyKey":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$","description":"A UUID v4 the caller generates for this purchase; reuse it only to retry the same purchase."},"maxCreditsSpend":{"type":"integer","minimum":0,"maximum":2147483647,"description":"The most credits this import may charge: `count` × 1 for `FILTERS`, the number of distinct `providerIds` × 1 for `SELECTED`; 1 credit per retrieved prospect. The start is refused when the cost could exceed it.","examples":[50]}},"required":["mode","schemaVersion","destination","idempotencyKey","maxCreditsSpend"],"allOf":[{"if":{"properties":{"mode":{"const":"FILTERS"}}},"then":{"required":["query","count"]}},{"if":{"properties":{"mode":{"const":"SELECTED"}}},"then":{"required":["providerIds"]}},{"if":{"properties":{"mode":{"const":"SELECTED"}}},"then":{"properties":{"startOffset":{"const":0}}}}]},"ImportProspectsResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"importId":{"type":"string","format":"uuid","description":"Id of the import this `idempotencyKey` names — the one just started, or, when `replayed` is `true`, the earlier one."},"campaignId":{"type":"string","format":"uuid","description":"The destination campaign."},"listId":{"type":"string","format":"uuid","description":"The destination prospect list — the existing one, or the one just created from `listName`."},"idempotencyKey":{"type":"string","format":"uuid","description":"The `idempotencyKey` of the request, echoed."},"replayed":{"type":"boolean","description":"`true` when this key already named an import: the ids are that earlier import's and this call started, created or charged nothing. `false` when a fresh import was started."}},"required":["importId","campaignId","listId","idempotencyKey","replayed"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetImportOutcomeResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"importId":{"type":"string","format":"uuid","description":"Id of the import."},"status":{"type":"string","enum":["COMPLETED","FAILED","IN_PROGRESS"],"description":"`COMPLETED`, `FAILED` or `IN_PROGRESS`."},"campaignId":{"type":"string","format":"uuid","description":"The destination campaign."},"listId":{"type":"string","format":"uuid","description":"The destination prospect list."},"mode":{"type":"string","enum":["FILTERS","SELECTED"],"description":"How the prospects were chosen."},"requestedCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"How many prospects were asked for: `count` for `FILTERS`, the number of distinct `providerIds` for `SELECTED`."},"startOffset":{"description":"Accepted zero-based `FILTERS` purchase window start, including zero for historical imports. Absent for `SELECTED`.","type":"integer","minimum":0,"maximum":2147483647},"breakdown":{"description":"What the import did, present once it is terminal. The numbers are independent: no sum invariant holds between them.","type":"object","properties":{"processed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Prospects retrieved — what the charge is counted from."},"added":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Retrieved prospects that are new in the list."},"alreadyInProspects":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Retrieved prospects the campaign owner already held."},"invalidProfiles":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Retrieved prospects without a usable LinkedIn profile."},"overProspectCapacity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Retrieved prospects left out because Prospect Capacity ran out."},"creditsCharged":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Credits the workspace paid for this import."}},"required":["processed","added","alreadyInProspects","invalidProfiles","overProspectCapacity","creditsCharged"]}},"required":["importId","status","campaignId","listId","mode","requestedCount"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetOwnerListResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Voice ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Voice update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Voice creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Short human-readable label for the Voice."},"user":{"description":"Reference to the user this Voice belongs to — carries only `id` and `name`. Fetch the full user record separately if needed. May be missing if the user is no longer available.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},"isLearningModeEnabled":{"type":"boolean","description":"Whether the Voice is in learning mode. When `true`, the backend auto-saves as Comment Examples only those comments the user both approved AND edited before approval (unchanged auto-approved comments are NOT saved). Only comments are learned — direct messages are never auto-saved. The Voice's Comment Examples are capped at 20 entries; auto-saved and manual entries share the same 20-slot cap. When `false`, no auto-learning happens and existing Comment Examples keep being used as-is."},"backgroundAboutUser":{"description":"Free-form plain text about the user themselves — role, background, perspective. Used as background when generating comments and direct messages, and when analyzing incoming posts. Missing while the user has not filled it in.","type":"string"},"backgroundAboutCompany":{"description":"Free-form plain text about the user's company, product, market, and target audience. Used as background when generating comments and direct messages, and when analyzing incoming posts. Missing while the user has not filled it in.","type":"string"},"instructionsForComments":{"description":"Free-form plain text with tone instructions for comment generation (tone, structure, do/don't). Used only when generating comments, not direct messages. Missing while the user has not filled it in.","type":"string"},"instructionsForDm":{"description":"Free-form plain text with tone instructions for direct-message generation (tone, structure, do/don't). Used only when generating direct messages, not comments. Missing while the user has not filled it in.","type":"string"},"commentExamplesCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of approved Comment Examples attached to this Voice."},"talkingPointsCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of comment Talking Points attached to this Voice."},"sellingPointsCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of DM Selling Points attached to this Voice."},"dmTemplatesCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of structured DM Templates attached to this Voice."},"campaigns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},"description":"Active campaigns of the current workspace that use this Voice and that the caller can access — only `id` and `name`. Empty when no such campaign uses it."}},"required":["id","updatedAt","createdAt","name","isLearningModeEnabled","commentExamplesCount","talkingPointsCount","sellingPointsCount","dmTemplatesCount","campaigns"]},"description":"Voices owned by the requested user"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetByIdResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","description":"Loaded Voice","properties":{"id":{"type":"string","format":"uuid","description":"Voice ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"updatedAt":{"type":"string","description":"Voice update timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"createdAt":{"type":"string","description":"Voice creation timestamp","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"name":{"type":"string","description":"Short human-readable label for the Voice."},"user":{"description":"Reference to the user this Voice belongs to — carries only `id` and `name`. Fetch the full user record separately if needed. May be missing if the user is no longer available.","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},"isLearningModeEnabled":{"type":"boolean","description":"Whether the Voice is in learning mode. When `true`, the backend auto-saves as Comment Examples only those comments the user both approved AND edited before approval (unchanged auto-approved comments are NOT saved). Only comments are learned — direct messages are never auto-saved. The Voice's Comment Examples are capped at 20 entries; auto-saved and manual entries share the same 20-slot cap. When `false`, no auto-learning happens and existing Comment Examples keep being used as-is."},"backgroundAboutUser":{"description":"Free-form plain text about the user themselves — role, background, perspective. Used as background when generating comments and direct messages, and when analyzing incoming posts. Missing while the user has not filled it in.","type":"string"},"backgroundAboutCompany":{"description":"Free-form plain text about the user's company, product, market, and target audience. Used as background when generating comments and direct messages, and when analyzing incoming posts. Missing while the user has not filled it in.","type":"string"},"instructionsForComments":{"description":"Free-form plain text with tone instructions for comment generation (tone, structure, do/don't). Used only when generating comments, not direct messages. Missing while the user has not filled it in.","type":"string"},"instructionsForDm":{"description":"Free-form plain text with tone instructions for direct-message generation (tone, structure, do/don't). Used only when generating direct messages, not comments. Missing while the user has not filled it in.","type":"string"},"commentExamplesCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of approved Comment Examples attached to this Voice."},"talkingPointsCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of comment Talking Points attached to this Voice."},"sellingPointsCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of DM Selling Points attached to this Voice."},"dmTemplatesCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of structured DM Templates attached to this Voice."},"campaigns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},"description":"Active campaigns of the current workspace that use this Voice and that the caller can access — only `id` and `name`. Empty when no such campaign uses it."}},"required":["id","updatedAt","createdAt","name","isLearningModeEnabled","commentExamplesCount","talkingPointsCount","sellingPointsCount","dmTemplatesCount","campaigns"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"CreateRequestDto3":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Short human-readable Voice name (e.g., 'Founder voice', 'Casual replies'). Required."},"userId":{"type":"string","format":"uuid","description":"ID of the user that will own the new Voice. Usually the current user. Required."},"backgroundAboutUser":{"type":"string","description":"Free-form plain text about the user themselves — role, background, perspective. Used as background when generating comments and direct messages, and when analyzing incoming posts. Optional — may be added later."},"backgroundAboutCompany":{"type":"string","description":"Free-form plain text about the user's company, product, market, and target audience. Used as background when generating comments and direct messages, and when analyzing incoming posts. Optional — may be added later."},"instructionsForComments":{"type":"string","description":"Free-form plain text with tone instructions for comment generation (tone, structure, do/don't). Used only when generating comments, not direct messages. Optional — may be added later.","maxLength":3000},"instructionsForDm":{"type":"string","description":"Free-form plain text with tone instructions for direct-message generation (tone, structure, do/don't). Used only when generating direct messages, not comments. Optional — may be added later.","maxLength":3000},"isLearningModeEnabled":{"type":"boolean","description":"Whether the Voice is in learning mode. When `true`, the backend auto-saves as Comment Examples only those comments the user both approved AND edited before approval (unchanged auto-approved comments are NOT saved). Only comments are learned — direct messages are never auto-saved. The Voice's Comment Examples are capped at 20 entries; auto-saved and manual entries share the same 20-slot cap. When `false`, no auto-learning happens and existing Comment Examples keep being used as-is. Optional — omit to leave auto-learning off."}},"required":["name","userId"]},"CreateResponseDto3":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Created entity ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]}},"required":["id"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"DuplicateRequestDto2":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"ID of the existing Voice to duplicate."},"name":{"type":"string","minLength":1,"description":"Name of the new Voice; the copy gets this name, not necessarily the source Voice's name."},"userId":{"type":"string","format":"uuid","description":"ID of the user that will receive the duplicated Voice. Can differ from the source Voice's user — in that case the copy is created in that user's account."}},"required":["id","name","userId"]},"DuplicateResponseDto2":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Created entity ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]}},"required":["id"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"UpdateRequestDto3":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Shared Voice to edit for its owner. Future generations across all campaigns using it can change; duplicate first for a campaign-specific variant."},"name":{"type":"string","description":"New Voice name. Omit to keep the current one.","minLength":1},"backgroundAboutUser":{"type":"string","description":"Free-form plain text about the user themselves — role, background, perspective. Used as background when generating comments and direct messages, and when analyzing incoming posts. Omit to keep the current value; pass an empty string to clear it."},"backgroundAboutCompany":{"type":"string","description":"Free-form plain text about the user's company, product, market, and target audience. Used as background when generating comments and direct messages, and when analyzing incoming posts. Omit to keep the current value; pass an empty string to clear it."},"instructionsForComments":{"type":"string","description":"Free-form plain text with tone instructions for comment generation (tone, structure, do/don't). Used only when generating comments, not direct messages. Omit to keep the current value; pass an empty string to clear it.","maxLength":3000},"instructionsForDm":{"type":"string","description":"Free-form plain text with tone instructions for direct-message generation (tone, structure, do/don't). Used only when generating direct messages, not comments. Omit to keep the current value; pass an empty string to clear it.","maxLength":3000},"isLearningModeEnabled":{"type":"boolean","description":"Whether the Voice is in learning mode. When `true`, the backend auto-saves as Comment Examples only those comments the user both approved AND edited before approval (unchanged auto-approved comments are NOT saved). Only comments are learned — direct messages are never auto-saved. The Voice's Comment Examples are capped at 20 entries; auto-saved and manual entries share the same 20-slot cap. When `false`, no auto-learning happens and existing Comment Examples keep being used as-is. Omit to keep the current value."}},"required":["id"]},"UpdateResponseDto3":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"DeleteResponseDto4":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetListResponseDto7":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"conversations":{"type":"array","items":{"type":"object","properties":{"connectionId":{"type":"string","format":"uuid","description":"Stable conversation (connection) ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"ownerId":{"type":"string","format":"uuid","description":"LinkedIn account owner whose inbox contains this conversation.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"prospect":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"],"description":"LinkedIn conversation counterpart."},"context":{"type":"object","properties":{"campaign":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Selected accessible campaign context, or null when no workspace lead binding exists."},"prospectList":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Selected Prospect List, or null when none applies."}},"required":["campaign","prospectList"]},"connectedAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Known LinkedIn connection date, or null when unavailable."},"lastMessage":{"anyOf":[{"type":"object","properties":{"text":{"type":"string","description":"Latest message text."},"author":{"type":"string","enum":["Owner","Prospect"],"description":"Which side of the LinkedIn conversation sent the message."},"sentAt":{"type":"string","description":"Send time of the latest message; not a delivery or read confirmation.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"autoStep":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["first-dm","follow-up"],"description":"Which automatic step sent the message."},"followUpNumber":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Follow-up number in the series at send time; null for a first DM."},"followUpLimit":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Follow-up limit of the campaign at send time; null when unlimited or not recorded."}},"required":["type","followUpNumber","followUpLimit"]},{"type":"null"}],"description":"Set when Extrovert's automatic step sent this message and the send was confirmed. Null means not recorded as automatic (manual, agent or older history), not necessarily manual."}},"required":["text","author","sentAt","autoStep"]},{"type":"null"}],"description":"Latest message preview, or null for an empty history."},"lastMessageAuthor":{"anyOf":[{"type":"string","enum":["Owner","Prospect"]},{"type":"null"}],"description":"Which side sent the latest message, independently of preview availability; null for an empty history."},"lastMessageAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Date of the latest message, or null for an empty history. Lists are ordered by it, newest first."},"unreadCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unread messages in this conversation."},"sentFollowUpCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Sent follow-ups in the current unanswered series. Zero also applies to initial outreach and a prospect's latest reply."},"state":{"type":"string","enum":["No draft","Suggested","Draft ready","Generating","Sending","Sent","History changed","Error","Paused","Skipped"]},"allowedActions":{"type":"array","items":{"type":"string","enum":["prepare-reply","generate-or-improve-reply","edit-reply","send-reply","recover-draft"]},"description":"Actions valid for the current state."},"inbox":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["needs-reply","for-review","auto","snoozed","ended","none"],"description":"Inbox section of the conversation: needs-reply (the prospect wrote last), for-review (For Review: a due Manual step, a DM held for review, or a send error/unknown outcome), auto (Extrovert sends the next step), snoozed, ended (no more steps) or none."},"attentionReason":{"anyOf":[{"type":"string","enum":["final-message","open-promise","call-outcome","missing-info","inappropriate-context","other","send-error","send-outcome-unknown"]},{"type":"null"}],"description":"Why Extrovert left this conversation to a person, or null. send-outcome-unknown means the message may already have been sent."},"attentionExplanation":{"description":"Extrovert's explanation of the attention reason, or null.","type":["string","null"]},"attentionAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"When the attention reason appeared, or null."},"forReviewSince":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"When the conversation entered For Review (for-review); null in any other section. Reading or editing does not move it."},"governingCampaignId":{"anyOf":[{"type":"string","format":"uuid","description":"Entity ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},{"type":"null"}],"description":"Campaign whose settings decide the next step, or null when no campaign wants it."},"nextStep":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["first-dm","follow-up"],"description":"The next outgoing step."},"mode":{"type":"string","enum":["manual","auto"],"description":"Manual: a person sends it. Auto: Extrovert sends it automatically."},"followUpNumber":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Number of the next follow-up, counting from 1; null for a first DM."},"followUpLimit":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Follow-up limit of the governing campaign; null when unlimited."},"dueAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"When the pause before this step ends, an arrived snooze date included. Timing only: readiness such as warm-up may still hold it."},"relevantPostDueAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"The earlier time a fresh relevant post would bring this follow-up forward to; null without relevant-post acceleration."}},"required":["type","mode","followUpNumber","followUpLimit","dueAt","relevantPostDueAt"]},{"type":"null"}],"description":"The next outgoing step and when it falls due, or null when none is planned."},"snoozedUntil":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"When a snoozed conversation returns; null unless snoozed."}},"required":["state","attentionReason","attentionExplanation","attentionAt","forReviewSince","governingCampaignId","nextStep","snoozedUntil"]},{"type":"null"}],"description":"Inbox classification, or null when the backend did not report one."},"situation":{"type":"string","description":"Plain summary of this conversation at the time of this read. \"This LinkedIn account\" is ownerId. Relative times are counted from this read. A quoted \"Extrovert's note\" is Extrovert's stored explanation."}},"required":["connectionId","ownerId","prospect","context","connectedAt","lastMessage","lastMessageAuthor","lastMessageAt","unreadCount","sentFollowUpCount","state","allowedActions","inbox","situation"]}},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of records requested for this page."},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Offset from the start of the filtered result set."},"total":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Total records available for the same filters."}},"required":["limit","offset","total"],"description":"Pagination information, if returned by the backend"}},"required":["conversations","pagination"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetRecommendedListResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"conversations":{"type":"array","items":{"type":"object","properties":{"connectionId":{"type":"string","format":"uuid","description":"Stable conversation (connection) ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"ownerId":{"type":"string","format":"uuid","description":"LinkedIn account owner whose inbox contains this conversation.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"campaign":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Accessible campaign the prospect belongs to, or null when no workspace lead binding exists."},"prospect":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"],"description":"LinkedIn conversation counterpart."},"reason":{"anyOf":[{"type":"string","enum":["Relevant post","Follow-up","First outreach","Manual"]},{"type":"null"}],"description":"Why Extrovert recommends writing to this conversation, or null when unknown."},"followUpNumber":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Which follow-up of the unanswered series is due, counting from 1. Null outside a follow-up series.","examples":[1,3]},"state":{"type":"string","enum":["No draft","Suggested","Draft ready","Generating","Sending","Sent","History changed","Error","Paused","Skipped"]},"dmId":{"anyOf":[{"type":"string","format":"uuid","description":"Entity ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},{"type":"null"}],"description":"Exact ID of the conversation's active reply, or null when it has none. Never the conversation ID."},"isReplyReady":{"type":"boolean","description":"True only when the active reply is written and ready for review; a recommendation without text yet is false."},"recommendedAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"When this recommendation appeared or returned (a snoozed one: when its snooze ends). Null for recommendations older than this field, which count as already known."},"lastMessage":{"anyOf":[{"type":"object","properties":{"text":{"type":"string","description":"Latest message text."},"author":{"type":"string","enum":["Owner","Prospect"],"description":"Which side of the LinkedIn conversation sent the message."},"sentAt":{"type":"string","description":"Send time of the latest message; not a delivery or read confirmation.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"autoStep":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["first-dm","follow-up"],"description":"Which automatic step sent the message."},"followUpNumber":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Follow-up number in the series at send time; null for a first DM."},"followUpLimit":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Follow-up limit of the campaign at send time; null when unlimited or not recorded."}},"required":["type","followUpNumber","followUpLimit"]},{"type":"null"}],"description":"Set when Extrovert's automatic step sent this message and the send was confirmed. Null means not recorded as automatic (manual, agent or older history), not necessarily manual."}},"required":["text","author","sentAt","autoStep"]},{"type":"null"}],"description":"Latest message preview, or null for an empty history."},"lastMessageAuthor":{"anyOf":[{"type":"string","enum":["Owner","Prospect"]},{"type":"null"}],"description":"Which side sent the latest message, independently of preview availability; null for an empty history."},"sentFollowUpCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Sent follow-ups in the current unanswered series. Zero also applies to initial outreach and a prospect's latest reply."},"lastMessageAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Date of the latest message, or null for an empty history."},"situation":{"type":"string","description":"Plain summary of this conversation at the time of this read. \"This LinkedIn account\" is ownerId. Relative times are counted from this read. A quoted \"Extrovert's note\" is Extrovert's stored explanation."}},"required":["connectionId","ownerId","campaign","prospect","reason","followUpNumber","state","dmId","isReplyReady","recommendedAt","lastMessage","lastMessageAuthor","sentFollowUpCount","lastMessageAt","situation"]}},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of records requested for this page."},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Offset from the start of the filtered result set."},"total":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Total records available for the same filters."}},"required":["limit","offset","total"],"description":"Pagination information, if returned by the backend"}},"required":["conversations","pagination"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GetResponseDto4":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"connectionId":{"type":"string","format":"uuid","description":"Stable conversation (connection) ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"ownerId":{"type":"string","format":"uuid","description":"LinkedIn account owner whose inbox contains this conversation.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"prospect":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Extrovert prospect/profile ID when one exists in the current workspace; null when only LinkedIn profile data is available."},"name":{"type":"string","description":"Person's current LinkedIn display name."},"linkedInUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"LinkedIn profile URL, or null when it is unavailable."},"headline":{"description":"LinkedIn headline, or null when it is unavailable.","type":["string","null"]},"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}],"description":"Profile image URL, or null when it is unavailable."}},"required":["id","name","linkedInUrl","headline","avatarUrl"],"description":"LinkedIn conversation counterpart."},"context":{"type":"object","properties":{"campaign":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Selected accessible campaign context, or null when no workspace lead binding exists."},"prospectList":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Stable Extrovert entity ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"name":{"type":"string","description":"Customer-facing entity name."}},"required":["id","name"]},{"type":"null"}],"description":"Selected Prospect List, or null when none applies."}},"required":["campaign","prospectList"]},"connectedAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Known LinkedIn connection date, or null when unavailable."},"lastMessage":{"anyOf":[{"type":"object","properties":{"text":{"type":"string","description":"Latest message text."},"author":{"type":"string","enum":["Owner","Prospect"],"description":"Which side of the LinkedIn conversation sent the message."},"sentAt":{"type":"string","description":"Send time of the latest message; not a delivery or read confirmation.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"autoStep":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["first-dm","follow-up"],"description":"Which automatic step sent the message."},"followUpNumber":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Follow-up number in the series at send time; null for a first DM."},"followUpLimit":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Follow-up limit of the campaign at send time; null when unlimited or not recorded."}},"required":["type","followUpNumber","followUpLimit"]},{"type":"null"}],"description":"Set when Extrovert's automatic step sent this message and the send was confirmed. Null means not recorded as automatic (manual, agent or older history), not necessarily manual."}},"required":["text","author","sentAt","autoStep"]},{"type":"null"}],"description":"Latest message preview, or null for an empty history."},"lastMessageAuthor":{"anyOf":[{"type":"string","enum":["Owner","Prospect"]},{"type":"null"}],"description":"Which side sent the latest message, independently of preview availability; null for an empty history."},"lastMessageAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Date of the latest message, or null for an empty history. Lists are ordered by it, newest first."},"unreadCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unread messages in this conversation."},"sentFollowUpCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Sent follow-ups in the current unanswered series. Zero also applies to initial outreach and a prospect's latest reply."},"state":{"type":"string","enum":["No draft","Suggested","Draft ready","Generating","Sending","Sent","History changed","Error","Paused","Skipped"]},"allowedActions":{"type":"array","items":{"type":"string","enum":["prepare-reply","generate-or-improve-reply","edit-reply","send-reply","recover-draft"]},"description":"Actions valid for the current state."},"inbox":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["needs-reply","for-review","auto","snoozed","ended","none"],"description":"Inbox section of the conversation: needs-reply (the prospect wrote last), for-review (For Review: a due Manual step, a DM held for review, or a send error/unknown outcome), auto (Extrovert sends the next step), snoozed, ended (no more steps) or none."},"attentionReason":{"anyOf":[{"type":"string","enum":["final-message","open-promise","call-outcome","missing-info","inappropriate-context","other","send-error","send-outcome-unknown"]},{"type":"null"}],"description":"Why Extrovert left this conversation to a person, or null. send-outcome-unknown means the message may already have been sent."},"attentionExplanation":{"description":"Extrovert's explanation of the attention reason, or null.","type":["string","null"]},"attentionAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"When the attention reason appeared, or null."},"forReviewSince":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"When the conversation entered For Review (for-review); null in any other section. Reading or editing does not move it."},"governingCampaignId":{"anyOf":[{"type":"string","format":"uuid","description":"Entity ID","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},{"type":"null"}],"description":"Campaign whose settings decide the next step, or null when no campaign wants it."},"nextStep":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["first-dm","follow-up"],"description":"The next outgoing step."},"mode":{"type":"string","enum":["manual","auto"],"description":"Manual: a person sends it. Auto: Extrovert sends it automatically."},"followUpNumber":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Number of the next follow-up, counting from 1; null for a first DM."},"followUpLimit":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Follow-up limit of the governing campaign; null when unlimited."},"dueAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"When the pause before this step ends, an arrived snooze date included. Timing only: readiness such as warm-up may still hold it."},"relevantPostDueAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"The earlier time a fresh relevant post would bring this follow-up forward to; null without relevant-post acceleration."}},"required":["type","mode","followUpNumber","followUpLimit","dueAt","relevantPostDueAt"]},{"type":"null"}],"description":"The next outgoing step and when it falls due, or null when none is planned."},"snoozedUntil":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"When a snoozed conversation returns; null unless snoozed."}},"required":["state","attentionReason","attentionExplanation","attentionAt","forReviewSince","governingCampaignId","nextStep","snoozedUntil"]},{"type":"null"}],"description":"Inbox classification, or null when the backend did not report one."},"situation":{"type":"string","description":"Plain summary of this conversation at the time of this read. \"This LinkedIn account\" is ownerId. Relative times are counted from this read. A quoted \"Extrovert's note\" is Extrovert's stored explanation."},"activeReply":{"anyOf":[{"type":"object","properties":{"dmId":{"type":"string","format":"uuid","description":"Exact reply ID required by Edit, Send, and Recover.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"connectionId":{"type":"string","format":"uuid","description":"Conversation this reply belongs to.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"text":{"type":"string","minLength":1,"description":"Effective reply text."},"source":{"type":"string","enum":["Extrovert-generated","Agent-authored","Edited"],"description":"Extrovert-generated when no authored override exists; Agent-authored when created without generation; Edited when custom text overrides a generated reply."},"state":{"type":"string","enum":["No draft","Suggested","Draft ready","Generating","Sending","Sent","History changed","Error","Paused","Skipped"]},"allowedActions":{"type":"array","items":{"type":"string","enum":["prepare-reply","generate-or-improve-reply","edit-reply","send-reply","recover-draft"]},"description":"Actions valid for the current state."},"reason":{"anyOf":[{"type":"string","enum":["Relevant post","Follow-up","First outreach","Manual"]},{"type":"null"}],"description":"Why Extrovert recommended this conversation, or null when no automatic reason applies."},"followUpNumber":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Which follow-up of the unanswered series is due, counting from 1. Null outside a follow-up series.","examples":[1,3]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","description":"Stable public error code suitable for branching. It is not a raw provider or backend status."},"message":{"type":"string","description":"Safe explanation of what failed and what the caller should do next."},"retryable":{"type":"boolean","description":"Whether retrying may succeed after the stated condition is resolved."},"occurredAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"When this failure was recorded, or null when no reliable timestamp exists."}},"required":["code","message","retryable","occurredAt"]},{"type":"null"}],"description":"Current send/workflow failure, or null when no failure is active."},"autoAttempt":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["first-dm","follow-up"],"description":"Which automatic step sent the message."},"followUpNumber":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Follow-up number in the series at send time; null for a first DM."},"followUpLimit":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Follow-up limit of the campaign at send time; null when unlimited or not recorded."}},"required":["type","followUpNumber","followUpLimit"]},{"type":"null"}],"description":"Set while this reply is an automatic send attempt that failed or whose outcome is unknown: the step Extrovert's automatic sending tried. Null for a person's reply and after it is recovered, edited or resent."},"createdAt":{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"updatedAt":{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"sentAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Time the reply was sent to LinkedIn, or null while it is not sent. Not a delivery or read confirmation."}},"required":["dmId","connectionId","text","source","state","allowedActions","reason","followUpNumber","error","autoAttempt","createdAt","updatedAt","sentAt"]},{"type":"null"}],"description":"Unique active Extrovert reply, or null when the conversation has no active draft/send failure."},"messages":{"type":"array","items":{"type":"object","properties":{"dmId":{"type":"string","format":"uuid","description":"Exact message ID.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"connectionId":{"type":"string","format":"uuid","description":"Conversation this message belongs to.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"text":{"type":"string","description":"Message text."},"author":{"type":"string","enum":["Owner","Prospect"],"description":"Which side of the LinkedIn conversation sent the message."},"sentAt":{"type":"string","description":"Time the message was sent on LinkedIn, or the best persisted send time for imported history. Not a delivery or read confirmation.","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"autoStep":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["first-dm","follow-up"],"description":"Which automatic step sent the message."},"followUpNumber":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Follow-up number in the series at send time; null for a first DM."},"followUpLimit":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Follow-up limit of the campaign at send time; null when unlimited or not recorded."}},"required":["type","followUpNumber","followUpLimit"]},{"type":"null"}],"description":"Set when Extrovert's automatic step sent this message and the send was confirmed. Null means not recorded as automatic (manual, agent or older history), not necessarily manual."}},"required":["dmId","connectionId","text","author","sentAt","autoStep"]},"description":"Message history page in chronological order; activeReply is never duplicated here."},"messagePagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of records requested for this page."},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Offset from the start of the filtered result set."},"total":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Total records available for the same filters."}},"required":["limit","offset","total"],"description":"Pagination anchored from the newest message."}},"required":["connectionId","ownerId","prospect","context","connectedAt","lastMessage","lastMessageAuthor","lastMessageAt","unreadCount","sentFollowUpCount","state","allowedActions","inbox","situation","activeReply","messages","messagePagination"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"PrepareReplyRequestDto":{"type":"object","properties":{"connectionId":{"type":"string","format":"uuid","description":"Conversation (connection) ID the action addresses."},"text":{"type":"string","minLength":1,"maxLength":1250,"description":"Reply text to prepare, trimmed to 1–1250 characters. A queued suggestion may be promoted; an existing reviewable reply must be edited instead."}},"required":["connectionId","text"]},"PrepareReplyResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"dmId":{"type":"string","format":"uuid","description":"Exact reply ID required by Edit, Send, and Recover.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"connectionId":{"type":"string","format":"uuid","description":"Conversation this reply belongs to.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"text":{"type":"string","minLength":1,"description":"Effective reply text."},"source":{"type":"string","enum":["Extrovert-generated","Agent-authored","Edited"],"description":"Extrovert-generated when no authored override exists; Agent-authored when created without generation; Edited when custom text overrides a generated reply."},"state":{"type":"string","enum":["No draft","Suggested","Draft ready","Generating","Sending","Sent","History changed","Error","Paused","Skipped"]},"allowedActions":{"type":"array","items":{"type":"string","enum":["prepare-reply","generate-or-improve-reply","edit-reply","send-reply","recover-draft"]},"description":"Actions valid for the current state."},"reason":{"anyOf":[{"type":"string","enum":["Relevant post","Follow-up","First outreach","Manual"]},{"type":"null"}],"description":"Why Extrovert recommended this conversation, or null when no automatic reason applies."},"followUpNumber":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Which follow-up of the unanswered series is due, counting from 1. Null outside a follow-up series.","examples":[1,3]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","description":"Stable public error code suitable for branching. It is not a raw provider or backend status."},"message":{"type":"string","description":"Safe explanation of what failed and what the caller should do next."},"retryable":{"type":"boolean","description":"Whether retrying may succeed after the stated condition is resolved."},"occurredAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"When this failure was recorded, or null when no reliable timestamp exists."}},"required":["code","message","retryable","occurredAt"]},{"type":"null"}],"description":"Current send/workflow failure, or null when no failure is active."},"autoAttempt":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["first-dm","follow-up"],"description":"Which automatic step sent the message."},"followUpNumber":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Follow-up number in the series at send time; null for a first DM."},"followUpLimit":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Follow-up limit of the campaign at send time; null when unlimited or not recorded."}},"required":["type","followUpNumber","followUpLimit"]},{"type":"null"}],"description":"Set while this reply is an automatic send attempt that failed or whose outcome is unknown: the step Extrovert's automatic sending tried. Null for a person's reply and after it is recovered, edited or resent."},"createdAt":{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"updatedAt":{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"sentAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Time the reply was sent to LinkedIn, or null while it is not sent. Not a delivery or read confirmation."}},"required":["dmId","connectionId","text","source","state","allowedActions","reason","followUpNumber","error","autoAttempt","createdAt","updatedAt","sentAt"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GenerateOrImproveReplyRequestDto":{"type":"object","properties":{"connectionId":{"type":"string","format":"uuid","description":"Conversation (connection) ID the action addresses."},"mode":{"type":"string","enum":["Generate","Improve"],"description":"Generate writes a fresh reply; Improve rewrites the current reply text and requires instructions."},"instructions":{"type":"string","description":"Plain-text direction: optional for Generate, required for Improve.","minLength":1,"maxLength":1250},"campaignId":{"type":"string","description":"One-call Voice source: an updatable campaign in this workspace belonging to the conversation owner. Does not reassign the prospect. Omit for implicit selection, which may differ from the recommendation.","format":"uuid"}},"required":["connectionId","mode"]},"GenerateOrImproveReplyResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"dmId":{"type":"string","format":"uuid","description":"Exact reply ID required by Edit, Send, and Recover.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"connectionId":{"type":"string","format":"uuid","description":"Conversation this reply belongs to.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"text":{"type":"string","minLength":1,"description":"Effective reply text."},"source":{"type":"string","enum":["Extrovert-generated","Agent-authored","Edited"],"description":"Extrovert-generated when no authored override exists; Agent-authored when created without generation; Edited when custom text overrides a generated reply."},"state":{"type":"string","enum":["No draft","Suggested","Draft ready","Generating","Sending","Sent","History changed","Error","Paused","Skipped"]},"allowedActions":{"type":"array","items":{"type":"string","enum":["prepare-reply","generate-or-improve-reply","edit-reply","send-reply","recover-draft"]},"description":"Actions valid for the current state."},"reason":{"anyOf":[{"type":"string","enum":["Relevant post","Follow-up","First outreach","Manual"]},{"type":"null"}],"description":"Why Extrovert recommended this conversation, or null when no automatic reason applies."},"followUpNumber":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Which follow-up of the unanswered series is due, counting from 1. Null outside a follow-up series.","examples":[1,3]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","description":"Stable public error code suitable for branching. It is not a raw provider or backend status."},"message":{"type":"string","description":"Safe explanation of what failed and what the caller should do next."},"retryable":{"type":"boolean","description":"Whether retrying may succeed after the stated condition is resolved."},"occurredAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"When this failure was recorded, or null when no reliable timestamp exists."}},"required":["code","message","retryable","occurredAt"]},{"type":"null"}],"description":"Current send/workflow failure, or null when no failure is active."},"autoAttempt":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["first-dm","follow-up"],"description":"Which automatic step sent the message."},"followUpNumber":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Follow-up number in the series at send time; null for a first DM."},"followUpLimit":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Follow-up limit of the campaign at send time; null when unlimited or not recorded."}},"required":["type","followUpNumber","followUpLimit"]},{"type":"null"}],"description":"Set while this reply is an automatic send attempt that failed or whose outcome is unknown: the step Extrovert's automatic sending tried. Null for a person's reply and after it is recovered, edited or resent."},"createdAt":{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"updatedAt":{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"sentAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Time the reply was sent to LinkedIn, or null while it is not sent. Not a delivery or read confirmation."}},"required":["dmId","connectionId","text","source","state","allowedActions","reason","followUpNumber","error","autoAttempt","createdAt","updatedAt","sentAt"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"SnoozeRequestDto":{"type":"object","properties":{"connectionId":{"type":"string","format":"uuid","description":"Conversation (connection) ID the action addresses."},"untilDate":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Calendar day the conversation returns on, YYYY-MM-DD, in the owner's timezone.","examples":["2026-11-10"]}},"required":["connectionId","untilDate"]},"SnoozeResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"UnskipRequestDto2":{"type":"object","properties":{"connectionId":{"type":"string","format":"uuid","description":"Conversation (connection) ID the action addresses."}},"required":["connectionId"]},"UnskipResponseDto2":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"SkipRequestDto2":{"type":"object","properties":{"connectionId":{"type":"string","format":"uuid","description":"Conversation (connection) ID the action addresses."}},"required":["connectionId"]},"SkipResponseDto2":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"GenerateRepliesRequestDto":{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"object","properties":{"connectionId":{"type":"string","format":"uuid","description":"Conversation (connection) to generate a reply for."},"campaignId":{"description":"One-call Voice source: an updatable campaign in this workspace belonging to the conversation owner. Does not reassign the prospect. Omit for implicit selection, which may differ from the recommendation.","type":"string","format":"uuid"}},"required":["connectionId"]},"description":"Conversations to generate replies for, 1 to 10."}},"required":["items"]},"GenerateRepliesResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Position of the element in the request list, starting at 0."},"id":{"description":"Element ID. Present for every updated or deleted element, and for a created element once it was saved.","type":"string","format":"uuid"},"item":{"description":"The element as saved. Absent when the element failed.","type":"object","properties":{"dmId":{"type":"string","format":"uuid","description":"Exact reply ID required by Edit, Send, and Recover.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"connectionId":{"type":"string","format":"uuid","description":"Conversation this reply belongs to.","examples":["8d256aa6-9b12-49a7-93ee-bf41634b5b60"]},"text":{"type":"string","minLength":1,"description":"Effective reply text."},"source":{"type":"string","enum":["Extrovert-generated","Agent-authored","Edited"],"description":"Extrovert-generated when no authored override exists; Agent-authored when created without generation; Edited when custom text overrides a generated reply."},"state":{"type":"string","enum":["No draft","Suggested","Draft ready","Generating","Sending","Sent","History changed","Error","Paused","Skipped"]},"allowedActions":{"type":"array","items":{"type":"string","enum":["prepare-reply","generate-or-improve-reply","edit-reply","send-reply","recover-draft"]},"description":"Actions valid for the current state."},"reason":{"anyOf":[{"type":"string","enum":["Relevant post","Follow-up","First outreach","Manual"]},{"type":"null"}],"description":"Why Extrovert recommended this conversation, or null when no automatic reason applies."},"followUpNumber":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Which follow-up of the unanswered series is due, counting from 1. Null outside a follow-up series.","examples":[1,3]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","description":"Stable public error code suitable for branching. It is not a raw provider or backend status."},"message":{"type":"string","description":"Safe explanation of what failed and what the caller should do next."},"retryable":{"type":"boolean","description":"Whether retrying may succeed after the stated condition is resolved."},"occurredAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"When this failure was recorded, or null when no reliable timestamp exists."}},"required":["code","message","retryable","occurredAt"]},{"type":"null"}],"description":"Current send/workflow failure, or null when no failure is active."},"autoAttempt":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["first-dm","follow-up"],"description":"Which automatic step sent the message."},"followUpNumber":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Follow-up number in the series at send time; null for a first DM."},"followUpLimit":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Follow-up limit of the campaign at send time; null when unlimited or not recorded."}},"required":["type","followUpNumber","followUpLimit"]},{"type":"null"}],"description":"Set while this reply is an automatic send attempt that failed or whose outcome is unknown: the step Extrovert's automatic sending tried. Null for a person's reply and after it is recovered, edited or resent."},"createdAt":{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"updatedAt":{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},"sentAt":{"anyOf":[{"type":"string","description":"Date and time in ISO 8601 format","examples":["2025-06-30T14:02:07.456Z","2025-07-03T08:30:00.000Z"]},{"type":"null"}],"description":"Time the reply was sent to LinkedIn, or null while it is not sent. Not a delivery or read confirmation."}},"required":["dmId","connectionId","text","source","state","allowedActions","reason","followUpNumber","error","autoAttempt","createdAt","updatedAt","sentAt"]},"error":{"description":"Why this element was not applied. Absent when the element succeeded; the other elements are unaffected.","type":"object","properties":{"code":{"type":"string","description":"Status name of the failure, e.g. `NOT_FOUND`, `PERMISSION_DENIED`, `INVALID_ARGUMENT`, `INTERNAL`."},"message":{"type":"string","description":"Human-readable reason this element was not applied."}},"required":["code","message"]}},"required":["index"]},"description":"One result per requested conversation, in request order: the generated reply, or the reason it was not generated"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"EditReplyRequestDto":{"type":"object","properties":{"dmId":{"type":"string","format":"uuid","description":"Exact reply ID obtained from Prepare reply or Get conversation."},"text":{"type":"string","minLength":1,"maxLength":1250,"description":"Replacement reply text, trimmed to 1–1250 characters. Empty text cannot clear a reply; this call does not send."}},"required":["dmId","text"]},"EditReplyResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"SendReplyRequestDto":{"type":"object","properties":{"dmId":{"type":"string","format":"uuid","description":"Exact reply ID obtained from Prepare reply or Get conversation."},"mode":{"type":"string","default":"queued","description":"Queued (default): Extrovert sends it spaced by the owner's send interval and only inside the owner's Working Hours; no daily limit applies. Immediate: sends now, ignoring spacing and Working Hours, and waits for LinkedIn to accept it.","enum":["queued","immediate"]}},"required":["dmId"]},"SendReplyResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"object","properties":{"status":{"type":"string","enum":["queued","sent"],"description":"Queued: waiting in Extrovert to be sent. Sent: sent to LinkedIn; no delivery or read confirmation."},"processId":{"description":"Existing scheduler job ID, present for queued acceptance.","type":"string","format":"uuid"}},"required":["status"]},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]},"RecoverDraftRequestDto":{"type":"object","properties":{"dmId":{"type":"string","format":"uuid","description":"Current reply ID. For History changed, recovery deletes this stale reply: save any wanted text first, then re-read and prepare a new reply. Other send failures retain the draft."}},"required":["dmId"]},"RecoverDraftResponseDto":{"type":"object","properties":{"status":{"type":"string","const":"success","description":"Response status"},"data":{"type":"null","description":"No response payload"},"message":{"type":"string","description":"Success message","examples":["Operation completed successfully"]}},"required":["status","data","message"]}}}}