@epilot/sdk 2.20.82 → 2.20.84

package/dist/targeting-C4H6GCPJ.cjs

@@ -0,0 +1,7 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-NJK5F5TF.cjs');
+
+// src/docs/targeting.json
+var targeting_default = '# Targeting API\n\n- **Base URL:** `https://targeting.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/targeting](https://docs.epilot.io/api/targeting)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.targeting.changeCampaignStatus(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/targeting\'\n\nconst targetingClient = getClient()\nauthorize(targetingClient, () => \'<token>\')\nconst { data } = await targetingClient.changeCampaignStatus(...)\n```\n\n## Operations\n\n**Campaign**\n- [`changeCampaignStatus`](#changecampaignstatus)\n- [`getCampaignJobStatus`](#getcampaignjobstatus)\n- [`getCampaignPortals`](#getcampaignportals)\n- [`setupCampaign`](#setupcampaign)\n- [`matchCampaigns`](#matchcampaigns)\n- [`discoverCampaigns`](#discovercampaigns)\n\n**Campaign Delivery**\n- [`retriggerCampaignAutomations`](#retriggercampaignautomations)\n\n**Target**\n- [`matchTargets`](#matchtargets)\n- [`getTargetQueries`](#gettargetqueries)\n\n**Campaign Recipient**\n- [`createRecipient`](#createrecipient)\n- [`updateRecipient`](#updaterecipient)\n- [`updateRecipientPortalStatus`](#updaterecipientportalstatus)\n- [`updateRecipientEntityUiStatus`](#updaterecipiententityuistatus)\n- [`restoreRecipientEntityUiStatus`](#restorerecipiententityuistatus)\n- [`getRecipients`](#getrecipients)\n- [`getEmailStats`](#getemailstats)\n\n**Schemas**\n- [`BaseError`](#baseerror)\n- [`ServerError`](#servererror)\n- [`ClientError`](#clienterror)\n- [`BaseUUID`](#baseuuid)\n- [`BaseNanoID`](#basenanoid)\n- [`BaseTags`](#basetags)\n- [`BaseRelation`](#baserelation)\n- [`BaseSystemId`](#basesystemid)\n- [`BaseEntityOwner`](#baseentityowner)\n- [`BaseEntityAcl`](#baseentityacl)\n- [`BaseSystemFields`](#basesystemfields)\n- [`BaseSystemFieldsRequired`](#basesystemfieldsrequired)\n- [`CampaignStatus`](#campaignstatus)\n- [`ExecutionSummaryItem`](#executionsummaryitem)\n- [`JobStatus`](#jobstatus)\n- [`Campaign`](#campaign)\n- [`Target`](#target)\n- [`TargetEntityFilters`](#targetentityfilters)\n- [`TargetSortItem`](#targetsortitem)\n- [`MatchCampaignParams`](#matchcampaignparams)\n- [`NextBestAction`](#nextbestaction)\n- [`DiscoverCampaignsParams`](#discovercampaignsparams)\n- [`DiscoverResult`](#discoverresult)\n- [`MatchTargetParams`](#matchtargetparams)\n- [`GetTargetQueriesParams`](#gettargetqueriesparams)\n- [`TargetQueryResult`](#targetqueryresult)\n- [`AutomationStatus`](#automationstatus)\n- [`PortalStatus`](#portalstatus)\n- [`EntityUiStatus`](#entityuistatus)\n- [`EmailStatus`](#emailstatus)\n- [`EmailBounceType`](#emailbouncetype)\n- [`Recipient`](#recipient)\n- [`BaseRecipientPayload`](#baserecipientpayload)\n- [`AutomationRecipientPayload`](#automationrecipientpayload)\n- [`PortalRecipientPayload`](#portalrecipientpayload)\n- [`CreateRecipientPayload`](#createrecipientpayload)\n- [`UpdateRecipientPayload`](#updaterecipientpayload)\n- [`RetriggerAutomationsRequest`](#retriggerautomationsrequest)\n- [`RetriggerAutomationsResult`](#retriggerautomationsresult)\n- [`UpdatePortalStatusRequest`](#updateportalstatusrequest)\n- [`UpdateEntityUiStatusRequest`](#updateentityuistatusrequest)\n- [`SetupCampaignRequest`](#setupcampaignrequest)\n- [`SetupTariffChangeCampaignRequest`](#setuptariffchangecampaignrequest)\n- [`SetupTariffChangeCampaignResponse`](#setuptariffchangecampaignresponse)\n\n### `changeCampaignStatus`\n\nChange the status of a campaign to a desired status.\n\n`POST /v1/campaign/{campaign_id}/status`\n\n```ts\nconst { data } = await client.changeCampaignStatus({\n  campaign_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "campaign": {\n    "_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n    "_org": "string",\n    "_owners": [\n      {\n        "org_id": "123",\n        "user_id": "123"\n      }\n    ],\n    "_schema": "string",\n    "_title": "string",\n    "_tags": ["string"],\n    "_created_at": "1970-01-01T00:00:00.000Z",\n    "_updated_at": "1970-01-01T00:00:00.000Z",\n    "_acl": {\n      "view": ["org:456"],\n      "edit": ["org:456"],\n      "delete": ["org:456"]\n    },\n    "name": "string",\n    "goal": "string",\n    "status": "draft",\n    "start_date": "1970-01-01",\n    "end_date": "1970-01-01",\n    "flow_id": "string",\n    "job_id": "string",\n    "target": {\n      "$relation": [\n        {\n          "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n          "_tags": ["string"]\n        }\n      ]\n    }\n  }\n}\n```\n\n</details>\n\n---\n\n### `getCampaignJobStatus`\n\nGet the status of a campaign\'s automation job\n\n`GET /v1/campaign/{campaign_id}/job`\n\n```ts\nconst { data } = await client.getCampaignJobStatus({\n  campaign_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "status": "queued",\n  "execution_summary": [\n    {\n      "execution_id": "string",\n      "execution_status": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getCampaignPortals`\n\nGet the list of portals and its widgets where the campaign is used.\n\n`GET /v1/campaign/{campaign_id}/portals`\n\n```ts\nconst { data } = await client.getCampaignPortals({\n  campaign_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n[\n  {\n    "portal": {\n      "origin": "string",\n      "domain": "string",\n      "name": "string"\n    },\n    "widgets": [\n      {\n        "id": "string",\n        "headline": {\n          "en": "string",\n          "de": "string"\n        }\n      }\n    ]\n  }\n]\n```\n\n</details>\n\n---\n\n### `retriggerCampaignAutomations`\n\nRetrigger automation executions for specific campaign recipients that have failed.\n\n`POST /v1/campaign/{campaign_id}/automations:retrigger`\n\n```ts\nconst { data } = await client.retriggerCampaignAutomations(\n  {\n    campaign_id: \'example\',\n  },\n  {\n    recipient_ids: [\'3fa85f64-5717-4562-b3fc-2c963f66afa6\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "message": "string",\n  "results": [\n    {\n      "recipient_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "result": "success",\n      "execution_id": "string",\n      "error": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `setupCampaign`\n\nCreates a `campaign` entity together with its related entities and configurations in a single call.\nUsed by the campaign wizard UI, but not restricted to it.\n\n`POST /v1/campaign:setup`\n\n```ts\nconst { data } = await client.setupCampaign(\n  null,\n  {\n    type: \'tariff_change\',\n    product_recommendation: {\n      name: \'string\',\n      source_product_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n      source_price_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n      offers: [\n        {\n          target_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n          items: [\n            {\n              product_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n              price_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n              highlight_config: {}\n            }\n          ]\n        }\n      ]\n    },\n    campaign: {\n      name: \'string\',\n      goal: \'string\',\n      target_ids: [\'b8c01433-5556-4e2b-aad4-6f5348d1df84\']\n    },\n    journey: {\n      journey_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\'\n    },\n    channels: {\n      portal_widget: {\n        portal_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n        block_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\'\n      },\n      email: {\n        automation_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n        template_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\'\n      },\n      entity_ui: {\n        category: \'string\',\n        icon: {\n          name: \'string\',\n          color: \'string\'\n        },\n        title: \'string\',\n        body: \'string\',\n        priority: \'medium\',\n        is_dismissable: true,\n        cta: {\n          type: \'journey\',\n          target: \'string\',\n          context_params: [\n            {\n              key: \'string\',\n              value: \'string\'\n            }\n          ]\n        }\n      }\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "type": "tariff_change",\n  "product_recommendation_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "campaign_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "journey_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "portal_widget_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84"\n}\n```\n\n</details>\n\n---\n\n### `matchCampaigns`\n\nMatch campaigns based on target entities.\n\n`POST /v1/campaign:match`\n\n```ts\nconst { data } = await client.matchCampaigns(\n  null,\n  {\n    entity_refs: [\n      {\n        entity_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n        entity_schema: \'string\'\n      }\n    ],\n    campaign_ids: [\'b8c01433-5556-4e2b-aad4-6f5348d1df84\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "hits": 0,\n  "results": [\n    {\n      "campaign": {\n        "_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n        "_org": "string",\n        "_owners": [\n          {\n            "org_id": "123",\n            "user_id": "123"\n          }\n        ],\n        "_schema": "string",\n        "_title": "string",\n        "_tags": ["string"],\n        "_created_at": "1970-01-01T00:00:00.000Z",\n        "_updated_at": "1970-01-01T00:00:00.000Z",\n        "_acl": {\n          "view": ["org:456"],\n          "edit": ["org:456"],\n          "delete": ["org:456"]\n        },\n        "name": "string",\n        "goal": "string",\n        "status": "draft",\n        "start_date": "1970-01-01",\n        "end_date": "1970-01-01",\n        "flow_id": "string",\n        "job_id": "string",\n        "target": {\n          "$relation": [\n            {\n              "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n              "_tags": ["string"]\n            }\n          ]\n        }\n      }\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `discoverCampaigns`\n\nGiven an entity, returns the Next Best Actions it should see on the Entity-UI channel.\n\n`POST /v1/campaign:discover`\n\n```ts\nconst { data } = await client.discoverCampaigns(\n  null,\n  {\n    entity_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n    entity_schema: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "hits": 0,\n  "results": [\n    {\n      "campaign_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n      "nba": {\n        "category": "string",\n        "icon": {\n          "name": "string",\n          "color": "string"\n        },\n        "title": "string",\n        "body": "string",\n        "priority": "medium",\n        "is_dismissable": true,\n        "cta": {\n          "type": "journey",\n          "target": "string",\n          "context_params": [\n            {\n              "key": "string",\n              "value": "string"\n            }\n          ]\n        }\n      },\n      "status": "seen",\n      "status_updated_at": "1970-01-01T00:00:00.000Z"\n    }\n  ],\n  "dismissed": [\n    {\n      "campaign_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n      "nba": {\n        "category": "string",\n        "icon": {\n          "name": "string",\n          "color": "string"\n        },\n        "title": "string",\n        "body": "string",\n        "priority": "medium",\n        "is_dismissable": true,\n        "cta": {\n          "type": "journey",\n          "target": "string",\n          "context_params": [\n            {\n              "key": "string",\n              "value": "string"\n            }\n          ]\n        }\n      },\n      "status": "seen",\n      "status_updated_at": "1970-01-01T00:00:00.000Z"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `matchTargets`\n\nFind targets from the provided list that include the provide entities.\n\n`POST /v1/target:match`\n\n```ts\nconst { data } = await client.matchTargets(\n  null,\n  {\n    entity_refs: [\n      {\n        entity_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n        entity_schema: \'string\'\n      }\n    ],\n    target_ids: [\'b8c01433-5556-4e2b-aad4-6f5348d1df84\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "hits": 0,\n  "results": [\n    {\n      "target": {\n        "_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n        "_org": "string",\n        "_owners": [\n          {\n            "org_id": "123",\n            "user_id": "123"\n          }\n        ],\n        "_schema": "string",\n        "_title": "string",\n        "_tags": ["string"],\n        "_created_at": "1970-01-01T00:00:00.000Z",\n        "_updated_at": "1970-01-01T00:00:00.000Z",\n        "_acl": {\n          "view": ["org:456"],\n          "edit": ["org:456"],\n          "delete": ["org:456"]\n        },\n        "name": "string",\n        "description": "string",\n        "entity_schema": "string",\n        "entity_filters": {\n          "filter": {},\n          "search": "string",\n          "sort": [\n            {\n              "key": "billing_address.postal_code",\n              "order": "asc"\n            }\n          ],\n          "limit": 1\n        }\n      }\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getTargetQueries`\n\nTransform target filters into Lucene queries for the provided target IDs.\nReturns the transformed query string for each target along with any errors encountered.\nIf the target defines a sort order or \n\n`POST /v1/target/queries`\n\n```ts\nconst { data } = await client.getTargetQueries(\n  null,\n  {\n    target_ids: [\'b8c01433-5556-4e2b-aad4-6f5348d1df84\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "target_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n      "query": "string",\n      "error": "string",\n      "sort": ["billing_date:desc", "_title.keyword:asc", "_id:desc"],\n      "limit": 1\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `createRecipient`\n\nCreates a new recipient associated with a campaign.\n\n`POST /v1/campaign/{campaign_id}/recipient`\n\n```ts\nconst { data } = await client.createRecipient(\n  {\n    campaign_id: \'example\',\n  },\n  {\n    entity_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n    entity_schema: \'string\',\n    automation_status: \'pending\',\n    automation_execution_id: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "entity_schema": "string",\n  "title": "string",\n  "automation_status": "pending",\n  "automation_execution_id": "string",\n  "portal_status": "sent",\n  "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "portal_state": {},\n  "entity_ui_status": "seen",\n  "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "entity_ui_status_before_dismiss": "seen",\n  "message_entity_id": "string",\n  "email_status": "sent",\n  "email_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "email_bounce_type": "permanent",\n  "email_bounce_subtype": "string",\n  "email_complaint_type": "string",\n  "email_bounce_reason": "string",\n  "email_send_error": {},\n  "email_unsubscribed_at": "1970-01-01T00:00:00.000Z",\n  "email_open_count": 0,\n  "email_first_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_last_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_click_count": 0,\n  "email_first_clicked_at": "1970-01-01T00:00:00.000Z",\n  "email_clicked_links": [\n    {\n      "url": "string",\n      "clicked_at": "1970-01-01T00:00:00.000Z"\n    }\n  ],\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `updateRecipient`\n\nUpdates a recipient\'s attributes.\n\n`PATCH /v1/campaign/{campaign_id}/recipient/{recipient_id}`\n\n```ts\nconst { data } = await client.updateRecipient(\n  {\n    campaign_id: \'example\',\n    recipient_id: \'example\',\n  },\n  {\n    automation_status: \'pending\',\n    automation_execution_id: \'string\',\n    portal_status: \'sent\',\n    portal_state: {}\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "entity_schema": "string",\n  "title": "string",\n  "automation_status": "pending",\n  "automation_execution_id": "string",\n  "portal_status": "sent",\n  "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "portal_state": {},\n  "entity_ui_status": "seen",\n  "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "entity_ui_status_before_dismiss": "seen",\n  "message_entity_id": "string",\n  "email_status": "sent",\n  "email_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "email_bounce_type": "permanent",\n  "email_bounce_subtype": "string",\n  "email_complaint_type": "string",\n  "email_bounce_reason": "string",\n  "email_send_error": {},\n  "email_unsubscribed_at": "1970-01-01T00:00:00.000Z",\n  "email_open_count": 0,\n  "email_first_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_last_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_click_count": 0,\n  "email_first_clicked_at": "1970-01-01T00:00:00.000Z",\n  "email_clicked_links": [\n    {\n      "url": "string",\n      "clicked_at": "1970-01-01T00:00:00.000Z"\n    }\n  ],\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `updateRecipientPortalStatus`\n\nUpdates the portal status for a specific campaign recipient.\nThe portal_status_updated_at timestamp is automatically set when the status changes.\n\n`PATCH /v1/campaign/{campaign_id}/recipient/{recipient_id}/portal:status`\n\n```ts\nconst { data } = await client.updateRecipientPortalStatus(\n  {\n    campaign_id: \'example\',\n    recipient_id: \'example\',\n  },\n  {\n    status: \'sent\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "entity_schema": "string",\n  "title": "string",\n  "automation_status": "pending",\n  "automation_execution_id": "string",\n  "portal_status": "sent",\n  "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "portal_state": {},\n  "entity_ui_status": "seen",\n  "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "entity_ui_status_before_dismiss": "seen",\n  "message_entity_id": "string",\n  "email_status": "sent",\n  "email_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "email_bounce_type": "permanent",\n  "email_bounce_subtype": "string",\n  "email_complaint_type": "string",\n  "email_bounce_reason": "string",\n  "email_send_error": {},\n  "email_unsubscribed_at": "1970-01-01T00:00:00.000Z",\n  "email_open_count": 0,\n  "email_first_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_last_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_click_count": 0,\n  "email_first_clicked_at": "1970-01-01T00:00:00.000Z",\n  "email_clicked_links": [\n    {\n      "url": "string",\n      "clicked_at": "1970-01-01T00:00:00.000Z"\n    }\n  ],\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `updateRecipientEntityUiStatus`\n\nRecords a Next Best Action interaction for a recipient on the Entity-UI channel.\n\n`PATCH /v1/campaign/{campaign_id}/recipient/{recipient_id}/entity_ui:status`\n\n```ts\nconst { data } = await client.updateRecipientEntityUiStatus(\n  {\n    campaign_id: \'example\',\n    recipient_id: \'example\',\n  },\n  {\n    status: \'seen\',\n    entity_schema: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "entity_schema": "string",\n  "title": "string",\n  "automation_status": "pending",\n  "automation_execution_id": "string",\n  "portal_status": "sent",\n  "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "portal_state": {},\n  "entity_ui_status": "seen",\n  "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "entity_ui_status_before_dismiss": "seen",\n  "message_entity_id": "string",\n  "email_status": "sent",\n  "email_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "email_bounce_type": "permanent",\n  "email_bounce_subtype": "string",\n  "email_complaint_type": "string",\n  "email_bounce_reason": "string",\n  "email_send_error": {},\n  "email_unsubscribed_at": "1970-01-01T00:00:00.000Z",\n  "email_open_count": 0,\n  "email_first_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_last_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_click_count": 0,\n  "email_first_clicked_at": "1970-01-01T00:00:00.000Z",\n  "email_clicked_links": [\n    {\n      "url": "string",\n      "clicked_at": "1970-01-01T00:00:00.000Z"\n    }\n  ],\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `restoreRecipientEntityUiStatus`\n\nUndo a dismissal on the Entity-UI (Next Best Action) channel\n\n`POST /v1/campaign/{campaign_id}/recipient/{recipient_id}/entity_ui:restore`\n\n```ts\nconst { data } = await client.restoreRecipientEntityUiStatus({\n  campaign_id: \'example\',\n  recipient_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "entity_schema": "string",\n  "title": "string",\n  "automation_status": "pending",\n  "automation_execution_id": "string",\n  "portal_status": "sent",\n  "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "portal_state": {},\n  "entity_ui_status": "seen",\n  "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "entity_ui_status_before_dismiss": "seen",\n  "message_entity_id": "string",\n  "email_status": "sent",\n  "email_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "email_bounce_type": "permanent",\n  "email_bounce_subtype": "string",\n  "email_complaint_type": "string",\n  "email_bounce_reason": "string",\n  "email_send_error": {},\n  "email_unsubscribed_at": "1970-01-01T00:00:00.000Z",\n  "email_open_count": 0,\n  "email_first_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_last_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_click_count": 0,\n  "email_first_clicked_at": "1970-01-01T00:00:00.000Z",\n  "email_clicked_links": [\n    {\n      "url": "string",\n      "clicked_at": "1970-01-01T00:00:00.000Z"\n    }\n  ],\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `getRecipients`\n\nGet a paginated list of recipients for a campaign.\n\n`GET /v1/campaign/{campaign_id}/recipients`\n\n```ts\nconst { data } = await client.getRecipients({\n  campaign_id: \'example\',\n  limit: 1,\n  next: \'example\',\n  q: \'example\',\n  automation_status: [\'...\'],\n  portal_status: \'example\',\n  email_status: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n      "entity_schema": "string",\n      "title": "string",\n      "automation_status": "pending",\n      "automation_execution_id": "string",\n      "portal_status": "sent",\n      "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n      "portal_state": {},\n      "entity_ui_status": "seen",\n      "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n      "entity_ui_status_before_dismiss": "seen",\n      "message_entity_id": "string",\n      "email_status": "sent",\n      "email_status_updated_at": "1970-01-01T00:00:00.000Z",\n      "email_bounce_type": "permanent",\n      "email_bounce_subtype": "string",\n      "email_complaint_type": "string",\n      "email_bounce_reason": "string",\n      "email_send_error": {},\n      "email_unsubscribed_at": "1970-01-01T00:00:00.000Z",\n      "email_open_count": 0,\n      "email_first_opened_at": "1970-01-01T00:00:00.000Z",\n      "email_last_opened_at": "1970-01-01T00:00:00.000Z",\n      "email_click_count": 0,\n      "email_first_clicked_at": "1970-01-01T00:00:00.000Z",\n      "email_clicked_links": [\n        {\n          "url": "string",\n          "clicked_at": "1970-01-01T00:00:00.000Z"\n        }\n      ],\n      "updated_at": "1970-01-01T00:00:00.000Z"\n    }\n  ],\n  "next": "string",\n  "total": 0\n}\n```\n\n</details>\n\n---\n\n### `getEmailStats`\n\nAggregate email delivery counts for a campaign, for the KPI summary on the campaign UI.\nCounts cover the email (automation) channel only; `total_emailed` is the number of\nrecipients with a recorded em\n\n`GET /v1/campaign/{campaign_id}/email-stats`\n\n```ts\nconst { data } = await client.getEmailStats({\n  campaign_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "total_emailed": 0,\n  "sent": 0,\n  "delivered": 0,\n  "bounced": 0,\n  "bounced_hard": 0,\n  "bounced_soft": 0,\n  "complained": 0,\n  "failed": 0,\n  "unsubscribed": 0,\n  "opened": 0,\n  "clicked": 0,\n  "total_opens": 0,\n  "total_clicks": 0\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `BaseError`\n\n```ts\ntype BaseError = {\n  status: number\n  message: string\n}\n```\n\n### `ServerError`\n\n```ts\ntype ServerError = {\n  status: number\n  message: string\n}\n```\n\n### `ClientError`\n\nDescribes the structure of a client error response, which can be one of several types:\n1. `MessageError`: Contains a \'message\' field for general descriptive errors.\n2. `CodeError`: Contains a \'code\' field for specific, machine-readable error codes.\n3. `StatusedError`: Contains \'error\' and \'status\' f\n\n```ts\ntype ClientError = {\n  message: string\n} | {\n  code: "CAMPAIGN_NOT_FOUND" | "CAMPAIGN_HAS_NO_TARGET" | "CAMPAIGN_HAS_NO_DELIVERY_METHOD" | "INVALID_NEXT_BEST_ACTION" | "CAMPAIGN_HAS_JOB_IN_PROGRESS" | "CAMPAIGN_HAS_UNEXPECTED_STATUS" | "JOB_TOKEN_MISSING" | "TARGET_WITHOUT_FILTERS"\n} | {\n  error: string\n  status: number\n}\n```\n\n### `BaseUUID`\n\n```ts\ntype BaseUUID = string // uuid\n```\n\n### `BaseNanoID`\n\n```ts\ntype BaseNanoID = string\n```\n\n### `BaseTags`\n\n```ts\ntype BaseTags = string[]\n```\n\n### `BaseRelation`\n\n```ts\ntype BaseRelation = {\n  $relation?: Array<{\n    entity_id?: string // uuid\n    _tags?: string[]\n  }>\n}\n```\n\n### `BaseSystemId`\n\n```ts\ntype BaseSystemId = {\n  _id: string // uuid\n}\n```\n\n### `BaseEntityOwner`\n\nThe user / organization owning this entity.\n\nNote: Owner implicitly has access to the entity regardless of ACLs.\n\n\n```ts\ntype BaseEntityOwner = {\n  org_id: string\n  user_id?: string\n}\n```\n\n### `BaseEntityAcl`\n\nAccess control list (ACL) for an entity. Defines sharing access to external orgs or users.\n\n```ts\ntype BaseEntityAcl = {\n  view?: string[]\n  edit?: string[]\n  delete?: string[]\n}\n```\n\n### `BaseSystemFields`\n\n```ts\ntype BaseSystemFields = {\n  _id?: string // uuid\n  _org?: string\n  _owners?: Array<{\n    org_id: string\n    user_id?: string\n  }>\n  _schema?: string\n  _title?: string\n  _tags?: string[]\n  _created_at?: string // date-time\n  _updated_at?: string // date-time\n  _acl?: {\n    view?: string[]\n    edit?: string[]\n    delete?: string[]\n  }\n}\n```\n\n### `BaseSystemFieldsRequired`\n\n```ts\ntype BaseSystemFieldsRequired = object\n```\n\n### `CampaignStatus`\n\n```ts\ntype CampaignStatus = "draft" | "activating" | "active" | "inactive"\n```\n\n### `ExecutionSummaryItem`\n\n```ts\ntype ExecutionSummaryItem = {\n  execution_id?: string\n  execution_status?: string\n}\n```\n\n### `JobStatus`\n\n```ts\ntype JobStatus = {\n  status?: "queued" | "processing" | "finished" | "failed" | "cancelled" | "send_report"\n  execution_summary?: Array<{\n    execution_id?: string\n    execution_status?: string\n  }>\n}\n```\n\n### `Campaign`\n\n```ts\ntype Campaign = {\n  _id?: string // uuid\n  _org?: string\n  _owners?: Array<{\n    org_id: string\n    user_id?: string\n  }>\n  _schema?: string\n  _title?: string\n  _tags?: string[]\n  _created_at?: string // date-time\n  _updated_at?: string // date-time\n  _acl?: {\n    view?: string[]\n    edit?: string[]\n    delete?: string[]\n  }\n  name?: string\n  goal?: string\n  status?: "draft" | "activating" | "active" | "inactive"\n  start_date?: string // date\n  end_date?: string // date\n  flow_id?: string\n  job_id?: string\n  target?: {\n    $relation?: Array<{\n      entity_id?: { ... }\n      _tags?: { ... }\n    }>\n  }\n}\n```\n\n### `Target`\n\n```ts\ntype Target = {\n  _id?: string // uuid\n  _org?: string\n  _owners?: Array<{\n    org_id: string\n    user_id?: string\n  }>\n  _schema?: string\n  _title?: string\n  _tags?: string[]\n  _created_at?: string // date-time\n  _updated_at?: string // date-time\n  _acl?: {\n    view?: string[]\n    edit?: string[]\n    delete?: string[]\n  }\n  name?: string\n  description?: string\n  entity_schema?: string\n  entity_filters?: {\n    filter?: Record<string, unknown>\n    search?: string\n    sort?: Array<{\n      key: { ... }\n      order: { ... }\n    }>\n    limit?: number\n  }\n}\n```\n\n### `TargetEntityFilters`\n\nSearch state of the target. `filter` and `search` use the same shape as the search state of entity views.\nBesides the filters, it optionally defines the order and maximum number of results.\n\n\n```ts\ntype TargetEntityFilters = {\n  filter?: Record<string, unknown>\n  search?: string\n  sort?: Array<{\n    key: string\n    order: "asc" | "desc"\n  }>\n  limit?: number\n}\n```\n\n### `TargetSortItem`\n\n```ts\ntype TargetSortItem = {\n  key: string\n  order: "asc" | "desc"\n}\n```\n\n### `MatchCampaignParams`\n\n```ts\ntype MatchCampaignParams = {\n  entity_refs: Array<{\n    entity_id: string // uuid\n    entity_schema: string\n  }>\n  campaign_ids: string // uuid[]\n}\n```\n\n### `NextBestAction`\n\nA Next Best Action configured on a campaign\'s Entity-UI channel.\nThis is the canonical NBA contract shared by discovery (this API), authoring, and rendering.\nNBA content is single-language in v1; text fields may contain `{{placeholders}}` resolved at render time.\n\n\n```ts\ntype NextBestAction = {\n  category?: string\n  icon?: {\n    name: string\n    color?: string\n  }\n  title: string\n  body?: string\n  priority?: "low" | "medium" | "high"\n  is_dismissable?: boolean\n  cta: {\n    type: "journey" | "workflow" | "flow"\n    target: string\n    context_params?: Array<{\n      key: { ... }\n      value: { ... }\n    }>\n  }\n}\n```\n\n### `DiscoverCampaignsParams`\n\n```ts\ntype DiscoverCampaignsParams = {\n  entity_id: string // uuid\n  entity_schema: string\n}\n```\n\n### `DiscoverResult`\n\nOne discovered Next Best Action, plus this entity\'s interaction state for it.\n\n```ts\ntype DiscoverResult = {\n  campaign_id: string // uuid\n  nba: {\n    category?: string\n    icon?: {\n      name: { ... }\n      color?: { ... }\n    }\n    title: string\n    body?: string\n    priority?: "low" | "medium" | "high"\n    is_dismissable?: boolean\n    cta: {\n      type: { ... }\n      target: { ... }\n      context_params?: { ... }\n    }\n  }\n  status?: "seen" | "dismissed" | "clicked"\n  status_updated_at?: string // date-time\n}\n```\n\n### `MatchTargetParams`\n\n```ts\ntype MatchTargetParams = {\n  entity_refs: Array<{\n    entity_id: string // uuid\n    entity_schema: string\n  }>\n  target_ids: string // uuid[]\n}\n```\n\n### `GetTargetQueriesParams`\n\n```ts\ntype GetTargetQueriesParams = {\n  target_ids: string // uuid[]\n}\n```\n\n### `TargetQueryResult`\n\n```ts\ntype TargetQueryResult = {\n  target_id: string // uuid\n  query: string\n  error?: string\n  sort?: string[]\n  limit?: number\n}\n```\n\n### `AutomationStatus`\n\n```ts\ntype AutomationStatus = "pending" | "in_progress" | "success" | "failed" | "cancelled"\n```\n\n### `PortalStatus`\n\n```ts\ntype PortalStatus = "sent" | "seen" | "dismissed" | "clicked"\n```\n\n### `EntityUiStatus`\n\nLifecycle status of a Next Best Action on the Entity-UI channel. Unlike the portal\nchannel there is no `sent` state: an NBA recipient is born at `seen`, the moment the\naction is first rendered to an agent.\n\n\n```ts\ntype EntityUiStatus = "seen" | "dismissed" | "clicked"\n```\n\n### `EmailStatus`\n\nDelivery status of the email a campaign\'s automation sends to a recipient. Set to `sent`\nonce the automation hands the email off, then updated asynchronously as SES notifications\narrive (`bounced` / `complained`; an SES Reject maps to `bounced`). `failed` is a send-time\nfailure (the automation execu\n\n```ts\ntype EmailStatus = "sent" | "delivered" | "bounced" | "complained" | "failed"\n```\n\n### `EmailBounceType`\n\nSES bounce classification: `permanent` (hard) or `transient` (soft).\n\n```ts\ntype EmailBounceType = "permanent" | "transient"\n```\n\n### `Recipient`\n\n```ts\ntype Recipient = {\n  entity_id?: string // uuid\n  entity_schema?: string\n  title?: string\n  automation_status?: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id?: string\n  portal_status?: "sent" | "seen" | "dismissed" | "clicked"\n  portal_status_updated_at?: string // date-time\n  portal_state?: Record<string, unknown>\n  entity_ui_status?: "seen" | "dismissed" | "clicked"\n  entity_ui_status_updated_at?: string // date-time\n  entity_ui_status_before_dismiss?: "seen" | "dismissed" | "clicked"\n  message_entity_id?: string\n  email_status?: "sent" | "delivered" | "bounced" | "complained" | "failed"\n  email_status_updated_at?: string // date-time\n  email_bounce_type?: "permanent" | "transient"\n  email_bounce_subtype?: string\n  email_complaint_type?: string\n  email_bounce_reason?: string\n  email_send_error?: Record<string, unknown>\n  email_unsubscribed_at?: string // date-time\n  email_open_count?: number\n  email_first_opened_at?: string // date-time\n  email_last_opened_at?: string // date-time\n  email_click_count?: number\n  email_first_clicked_at?: string // date-time\n  email_clicked_links?: Array<{\n    url: string\n    clicked_at: string // date-time\n  }>\n  updated_at?: string // date-time\n}\n```\n\n### `BaseRecipientPayload`\n\n```ts\ntype BaseRecipientPayload = {\n  entity_id: string // uuid\n  entity_schema: string\n}\n```\n\n### `AutomationRecipientPayload`\n\n```ts\ntype AutomationRecipientPayload = {\n  automation_status: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id: string\n}\n```\n\n### `PortalRecipientPayload`\n\n```ts\ntype PortalRecipientPayload = {\n  portal_status: "sent" | "seen" | "dismissed" | "clicked"\n  portal_state?: Record<string, unknown>\n}\n```\n\n### `CreateRecipientPayload`\n\n```ts\ntype CreateRecipientPayload = {\n  entity_id: string // uuid\n  entity_schema: string\n  automation_status: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id: string\n} | {\n  entity_id: string // uuid\n  entity_schema: string\n  portal_status: "sent" | "seen" | "dismissed" | "clicked"\n  portal_state?: Record<string, unknown>\n} | {\n  entity_id: string // uuid\n  entity_schema: string\n  automation_status: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id: string\n  portal_status: "sent" | "seen" | "dismissed" | "clicked"\n  portal_state?: Record<string, unknown>\n}\n```\n\n### `UpdateRecipientPayload`\n\n```ts\ntype UpdateRecipientPayload = {\n  automation_status?: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id?: string\n  portal_status?: "sent" | "seen" | "dismissed" | "clicked"\n  portal_state?: Record<string, unknown>\n}\n```\n\n### `RetriggerAutomationsRequest`\n\n```ts\ntype RetriggerAutomationsRequest = {\n  recipient_ids: string // uuid[]\n}\n```\n\n### `RetriggerAutomationsResult`\n\n```ts\ntype RetriggerAutomationsResult = {\n  recipient_id: string // uuid\n  result: "success" | "failure" | "not_found" | "invalid_status"\n  execution_id?: string\n  error?: string\n}\n```\n\n### `UpdatePortalStatusRequest`\n\n```ts\ntype UpdatePortalStatusRequest = {\n  status: "sent" | "seen" | "dismissed" | "clicked"\n}\n```\n\n### `UpdateEntityUiStatusRequest`\n\n```ts\ntype UpdateEntityUiStatusRequest = {\n  status: "seen" | "dismissed" | "clicked"\n  entity_schema?: string\n}\n```\n\n### `SetupCampaignRequest`\n\nDiscriminated by `type`. Each campaign variant has its own request shape;\nnew variants are added by introducing a new schema and extending the `oneOf` list.\n\n\n```ts\ntype SetupCampaignRequest = {\n  type: "tariff_change"\n  product_recommendation: {\n    name?: string\n    source_product_id?: string // uuid\n    source_price_id?: string // uuid\n    offers?: Array<{\n      target_id?: { ... }\n      items: { ... }\n    }>\n  }\n  campaign: {\n    name: string\n    goal?: string\n    target_ids: string // uuid[]\n  }\n  journey?: {\n    journey_id: string // uuid\n  }\n  channels?: {\n    portal_widget?: {\n      portal_id: { ... }\n      block_id: { ... }\n    }\n    email?: {\n      automation_id?: { ... }\n      template_id?: { ... }\n    }\n    entity_ui?: {\n      category?: { ... }\n      icon?: { ... }\n      title: { ... }\n      body?: { ... }\n      priority?: { ... }\n      is_dismissable?: { ... }\n      cta: { ... }\n    }\n  }\n}\n```\n\n### `SetupTariffChangeCampaignRequest`\n\n```ts\ntype SetupTariffChangeCampaignRequest = {\n  type: "tariff_change"\n  product_recommendation: {\n    name?: string\n    source_product_id?: string // uuid\n    source_price_id?: string // uuid\n    offers?: Array<{\n      target_id?: { ... }\n      items: { ... }\n    }>\n  }\n  campaign: {\n    name: string\n    goal?: string\n    target_ids: string // uuid[]\n  }\n  journey?: {\n    journey_id: string // uuid\n  }\n  channels?: {\n    portal_widget?: {\n      portal_id: { ... }\n      block_id: { ... }\n    }\n    email?: {\n      automation_id?: { ... }\n      template_id?: { ... }\n    }\n    entity_ui?: {\n      category?: { ... }\n      icon?: { ... }\n      title: { ... }\n      body?: { ... }\n      priority?: { ... }\n      is_dismissable?: { ... }\n      cta: { ... }\n    }\n  }\n}\n```\n\n### `SetupTariffChangeCampaignResponse`\n\n```ts\ntype SetupTariffChangeCampaignResponse = {\n  type: "tariff_change"\n  product_recommendation_id: string // uuid\n  campaign_id: string // uuid\n  journey_id?: string // uuid\n  portal_widget_id?: string // uuid\n}\n```\n';
+
+
+exports.default = targeting_default;

package/dist/targeting-PPD4TUSO.js

@@ -0,0 +1,7 @@
+import "./chunk-YPSWSI3M.js";
+
+// src/docs/targeting.json
+var targeting_default = '# Targeting API\n\n- **Base URL:** `https://targeting.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/targeting](https://docs.epilot.io/api/targeting)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.targeting.changeCampaignStatus(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/targeting\'\n\nconst targetingClient = getClient()\nauthorize(targetingClient, () => \'<token>\')\nconst { data } = await targetingClient.changeCampaignStatus(...)\n```\n\n## Operations\n\n**Campaign**\n- [`changeCampaignStatus`](#changecampaignstatus)\n- [`getCampaignJobStatus`](#getcampaignjobstatus)\n- [`getCampaignPortals`](#getcampaignportals)\n- [`setupCampaign`](#setupcampaign)\n- [`matchCampaigns`](#matchcampaigns)\n- [`discoverCampaigns`](#discovercampaigns)\n\n**Campaign Delivery**\n- [`retriggerCampaignAutomations`](#retriggercampaignautomations)\n\n**Target**\n- [`matchTargets`](#matchtargets)\n- [`getTargetQueries`](#gettargetqueries)\n\n**Campaign Recipient**\n- [`createRecipient`](#createrecipient)\n- [`updateRecipient`](#updaterecipient)\n- [`updateRecipientPortalStatus`](#updaterecipientportalstatus)\n- [`updateRecipientEntityUiStatus`](#updaterecipiententityuistatus)\n- [`restoreRecipientEntityUiStatus`](#restorerecipiententityuistatus)\n- [`getRecipients`](#getrecipients)\n- [`getEmailStats`](#getemailstats)\n\n**Schemas**\n- [`BaseError`](#baseerror)\n- [`ServerError`](#servererror)\n- [`ClientError`](#clienterror)\n- [`BaseUUID`](#baseuuid)\n- [`BaseNanoID`](#basenanoid)\n- [`BaseTags`](#basetags)\n- [`BaseRelation`](#baserelation)\n- [`BaseSystemId`](#basesystemid)\n- [`BaseEntityOwner`](#baseentityowner)\n- [`BaseEntityAcl`](#baseentityacl)\n- [`BaseSystemFields`](#basesystemfields)\n- [`BaseSystemFieldsRequired`](#basesystemfieldsrequired)\n- [`CampaignStatus`](#campaignstatus)\n- [`ExecutionSummaryItem`](#executionsummaryitem)\n- [`JobStatus`](#jobstatus)\n- [`Campaign`](#campaign)\n- [`Target`](#target)\n- [`TargetEntityFilters`](#targetentityfilters)\n- [`TargetSortItem`](#targetsortitem)\n- [`MatchCampaignParams`](#matchcampaignparams)\n- [`NextBestAction`](#nextbestaction)\n- [`DiscoverCampaignsParams`](#discovercampaignsparams)\n- [`DiscoverResult`](#discoverresult)\n- [`MatchTargetParams`](#matchtargetparams)\n- [`GetTargetQueriesParams`](#gettargetqueriesparams)\n- [`TargetQueryResult`](#targetqueryresult)\n- [`AutomationStatus`](#automationstatus)\n- [`PortalStatus`](#portalstatus)\n- [`EntityUiStatus`](#entityuistatus)\n- [`EmailStatus`](#emailstatus)\n- [`EmailBounceType`](#emailbouncetype)\n- [`Recipient`](#recipient)\n- [`BaseRecipientPayload`](#baserecipientpayload)\n- [`AutomationRecipientPayload`](#automationrecipientpayload)\n- [`PortalRecipientPayload`](#portalrecipientpayload)\n- [`CreateRecipientPayload`](#createrecipientpayload)\n- [`UpdateRecipientPayload`](#updaterecipientpayload)\n- [`RetriggerAutomationsRequest`](#retriggerautomationsrequest)\n- [`RetriggerAutomationsResult`](#retriggerautomationsresult)\n- [`UpdatePortalStatusRequest`](#updateportalstatusrequest)\n- [`UpdateEntityUiStatusRequest`](#updateentityuistatusrequest)\n- [`SetupCampaignRequest`](#setupcampaignrequest)\n- [`SetupTariffChangeCampaignRequest`](#setuptariffchangecampaignrequest)\n- [`SetupTariffChangeCampaignResponse`](#setuptariffchangecampaignresponse)\n\n### `changeCampaignStatus`\n\nChange the status of a campaign to a desired status.\n\n`POST /v1/campaign/{campaign_id}/status`\n\n```ts\nconst { data } = await client.changeCampaignStatus({\n  campaign_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "campaign": {\n    "_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n    "_org": "string",\n    "_owners": [\n      {\n        "org_id": "123",\n        "user_id": "123"\n      }\n    ],\n    "_schema": "string",\n    "_title": "string",\n    "_tags": ["string"],\n    "_created_at": "1970-01-01T00:00:00.000Z",\n    "_updated_at": "1970-01-01T00:00:00.000Z",\n    "_acl": {\n      "view": ["org:456"],\n      "edit": ["org:456"],\n      "delete": ["org:456"]\n    },\n    "name": "string",\n    "goal": "string",\n    "status": "draft",\n    "start_date": "1970-01-01",\n    "end_date": "1970-01-01",\n    "flow_id": "string",\n    "job_id": "string",\n    "target": {\n      "$relation": [\n        {\n          "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n          "_tags": ["string"]\n        }\n      ]\n    }\n  }\n}\n```\n\n</details>\n\n---\n\n### `getCampaignJobStatus`\n\nGet the status of a campaign\'s automation job\n\n`GET /v1/campaign/{campaign_id}/job`\n\n```ts\nconst { data } = await client.getCampaignJobStatus({\n  campaign_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "status": "queued",\n  "execution_summary": [\n    {\n      "execution_id": "string",\n      "execution_status": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getCampaignPortals`\n\nGet the list of portals and its widgets where the campaign is used.\n\n`GET /v1/campaign/{campaign_id}/portals`\n\n```ts\nconst { data } = await client.getCampaignPortals({\n  campaign_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n[\n  {\n    "portal": {\n      "origin": "string",\n      "domain": "string",\n      "name": "string"\n    },\n    "widgets": [\n      {\n        "id": "string",\n        "headline": {\n          "en": "string",\n          "de": "string"\n        }\n      }\n    ]\n  }\n]\n```\n\n</details>\n\n---\n\n### `retriggerCampaignAutomations`\n\nRetrigger automation executions for specific campaign recipients that have failed.\n\n`POST /v1/campaign/{campaign_id}/automations:retrigger`\n\n```ts\nconst { data } = await client.retriggerCampaignAutomations(\n  {\n    campaign_id: \'example\',\n  },\n  {\n    recipient_ids: [\'3fa85f64-5717-4562-b3fc-2c963f66afa6\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "message": "string",\n  "results": [\n    {\n      "recipient_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "result": "success",\n      "execution_id": "string",\n      "error": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `setupCampaign`\n\nCreates a `campaign` entity together with its related entities and configurations in a single call.\nUsed by the campaign wizard UI, but not restricted to it.\n\n`POST /v1/campaign:setup`\n\n```ts\nconst { data } = await client.setupCampaign(\n  null,\n  {\n    type: \'tariff_change\',\n    product_recommendation: {\n      name: \'string\',\n      source_product_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n      source_price_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n      offers: [\n        {\n          target_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n          items: [\n            {\n              product_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n              price_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n              highlight_config: {}\n            }\n          ]\n        }\n      ]\n    },\n    campaign: {\n      name: \'string\',\n      goal: \'string\',\n      target_ids: [\'b8c01433-5556-4e2b-aad4-6f5348d1df84\']\n    },\n    journey: {\n      journey_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\'\n    },\n    channels: {\n      portal_widget: {\n        portal_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n        block_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\'\n      },\n      email: {\n        automation_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n        template_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\'\n      },\n      entity_ui: {\n        category: \'string\',\n        icon: {\n          name: \'string\',\n          color: \'string\'\n        },\n        title: \'string\',\n        body: \'string\',\n        priority: \'medium\',\n        is_dismissable: true,\n        cta: {\n          type: \'journey\',\n          target: \'string\',\n          context_params: [\n            {\n              key: \'string\',\n              value: \'string\'\n            }\n          ]\n        }\n      }\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "type": "tariff_change",\n  "product_recommendation_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "campaign_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "journey_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "portal_widget_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84"\n}\n```\n\n</details>\n\n---\n\n### `matchCampaigns`\n\nMatch campaigns based on target entities.\n\n`POST /v1/campaign:match`\n\n```ts\nconst { data } = await client.matchCampaigns(\n  null,\n  {\n    entity_refs: [\n      {\n        entity_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n        entity_schema: \'string\'\n      }\n    ],\n    campaign_ids: [\'b8c01433-5556-4e2b-aad4-6f5348d1df84\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "hits": 0,\n  "results": [\n    {\n      "campaign": {\n        "_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n        "_org": "string",\n        "_owners": [\n          {\n            "org_id": "123",\n            "user_id": "123"\n          }\n        ],\n        "_schema": "string",\n        "_title": "string",\n        "_tags": ["string"],\n        "_created_at": "1970-01-01T00:00:00.000Z",\n        "_updated_at": "1970-01-01T00:00:00.000Z",\n        "_acl": {\n          "view": ["org:456"],\n          "edit": ["org:456"],\n          "delete": ["org:456"]\n        },\n        "name": "string",\n        "goal": "string",\n        "status": "draft",\n        "start_date": "1970-01-01",\n        "end_date": "1970-01-01",\n        "flow_id": "string",\n        "job_id": "string",\n        "target": {\n          "$relation": [\n            {\n              "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n              "_tags": ["string"]\n            }\n          ]\n        }\n      }\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `discoverCampaigns`\n\nGiven an entity, returns the Next Best Actions it should see on the Entity-UI channel.\n\n`POST /v1/campaign:discover`\n\n```ts\nconst { data } = await client.discoverCampaigns(\n  null,\n  {\n    entity_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n    entity_schema: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "hits": 0,\n  "results": [\n    {\n      "campaign_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n      "nba": {\n        "category": "string",\n        "icon": {\n          "name": "string",\n          "color": "string"\n        },\n        "title": "string",\n        "body": "string",\n        "priority": "medium",\n        "is_dismissable": true,\n        "cta": {\n          "type": "journey",\n          "target": "string",\n          "context_params": [\n            {\n              "key": "string",\n              "value": "string"\n            }\n          ]\n        }\n      },\n      "status": "seen",\n      "status_updated_at": "1970-01-01T00:00:00.000Z"\n    }\n  ],\n  "dismissed": [\n    {\n      "campaign_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n      "nba": {\n        "category": "string",\n        "icon": {\n          "name": "string",\n          "color": "string"\n        },\n        "title": "string",\n        "body": "string",\n        "priority": "medium",\n        "is_dismissable": true,\n        "cta": {\n          "type": "journey",\n          "target": "string",\n          "context_params": [\n            {\n              "key": "string",\n              "value": "string"\n            }\n          ]\n        }\n      },\n      "status": "seen",\n      "status_updated_at": "1970-01-01T00:00:00.000Z"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `matchTargets`\n\nFind targets from the provided list that include the provide entities.\n\n`POST /v1/target:match`\n\n```ts\nconst { data } = await client.matchTargets(\n  null,\n  {\n    entity_refs: [\n      {\n        entity_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n        entity_schema: \'string\'\n      }\n    ],\n    target_ids: [\'b8c01433-5556-4e2b-aad4-6f5348d1df84\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "hits": 0,\n  "results": [\n    {\n      "target": {\n        "_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n        "_org": "string",\n        "_owners": [\n          {\n            "org_id": "123",\n            "user_id": "123"\n          }\n        ],\n        "_schema": "string",\n        "_title": "string",\n        "_tags": ["string"],\n        "_created_at": "1970-01-01T00:00:00.000Z",\n        "_updated_at": "1970-01-01T00:00:00.000Z",\n        "_acl": {\n          "view": ["org:456"],\n          "edit": ["org:456"],\n          "delete": ["org:456"]\n        },\n        "name": "string",\n        "description": "string",\n        "entity_schema": "string",\n        "entity_filters": {\n          "filter": {},\n          "search": "string",\n          "sort": [\n            {\n              "key": "billing_address.postal_code",\n              "order": "asc"\n            }\n          ],\n          "limit": 1\n        }\n      }\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getTargetQueries`\n\nTransform target filters into Lucene queries for the provided target IDs.\nReturns the transformed query string for each target along with any errors encountered.\nIf the target defines a sort order or \n\n`POST /v1/target/queries`\n\n```ts\nconst { data } = await client.getTargetQueries(\n  null,\n  {\n    target_ids: [\'b8c01433-5556-4e2b-aad4-6f5348d1df84\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "target_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n      "query": "string",\n      "error": "string",\n      "sort": ["billing_date:desc", "_title.keyword:asc", "_id:desc"],\n      "limit": 1\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `createRecipient`\n\nCreates a new recipient associated with a campaign.\n\n`POST /v1/campaign/{campaign_id}/recipient`\n\n```ts\nconst { data } = await client.createRecipient(\n  {\n    campaign_id: \'example\',\n  },\n  {\n    entity_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n    entity_schema: \'string\',\n    automation_status: \'pending\',\n    automation_execution_id: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "entity_schema": "string",\n  "title": "string",\n  "automation_status": "pending",\n  "automation_execution_id": "string",\n  "portal_status": "sent",\n  "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "portal_state": {},\n  "entity_ui_status": "seen",\n  "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "entity_ui_status_before_dismiss": "seen",\n  "message_entity_id": "string",\n  "email_status": "sent",\n  "email_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "email_bounce_type": "permanent",\n  "email_bounce_subtype": "string",\n  "email_complaint_type": "string",\n  "email_bounce_reason": "string",\n  "email_send_error": {},\n  "email_unsubscribed_at": "1970-01-01T00:00:00.000Z",\n  "email_open_count": 0,\n  "email_first_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_last_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_click_count": 0,\n  "email_first_clicked_at": "1970-01-01T00:00:00.000Z",\n  "email_clicked_links": [\n    {\n      "url": "string",\n      "clicked_at": "1970-01-01T00:00:00.000Z"\n    }\n  ],\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `updateRecipient`\n\nUpdates a recipient\'s attributes.\n\n`PATCH /v1/campaign/{campaign_id}/recipient/{recipient_id}`\n\n```ts\nconst { data } = await client.updateRecipient(\n  {\n    campaign_id: \'example\',\n    recipient_id: \'example\',\n  },\n  {\n    automation_status: \'pending\',\n    automation_execution_id: \'string\',\n    portal_status: \'sent\',\n    portal_state: {}\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "entity_schema": "string",\n  "title": "string",\n  "automation_status": "pending",\n  "automation_execution_id": "string",\n  "portal_status": "sent",\n  "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "portal_state": {},\n  "entity_ui_status": "seen",\n  "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "entity_ui_status_before_dismiss": "seen",\n  "message_entity_id": "string",\n  "email_status": "sent",\n  "email_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "email_bounce_type": "permanent",\n  "email_bounce_subtype": "string",\n  "email_complaint_type": "string",\n  "email_bounce_reason": "string",\n  "email_send_error": {},\n  "email_unsubscribed_at": "1970-01-01T00:00:00.000Z",\n  "email_open_count": 0,\n  "email_first_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_last_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_click_count": 0,\n  "email_first_clicked_at": "1970-01-01T00:00:00.000Z",\n  "email_clicked_links": [\n    {\n      "url": "string",\n      "clicked_at": "1970-01-01T00:00:00.000Z"\n    }\n  ],\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `updateRecipientPortalStatus`\n\nUpdates the portal status for a specific campaign recipient.\nThe portal_status_updated_at timestamp is automatically set when the status changes.\n\n`PATCH /v1/campaign/{campaign_id}/recipient/{recipient_id}/portal:status`\n\n```ts\nconst { data } = await client.updateRecipientPortalStatus(\n  {\n    campaign_id: \'example\',\n    recipient_id: \'example\',\n  },\n  {\n    status: \'sent\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "entity_schema": "string",\n  "title": "string",\n  "automation_status": "pending",\n  "automation_execution_id": "string",\n  "portal_status": "sent",\n  "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "portal_state": {},\n  "entity_ui_status": "seen",\n  "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "entity_ui_status_before_dismiss": "seen",\n  "message_entity_id": "string",\n  "email_status": "sent",\n  "email_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "email_bounce_type": "permanent",\n  "email_bounce_subtype": "string",\n  "email_complaint_type": "string",\n  "email_bounce_reason": "string",\n  "email_send_error": {},\n  "email_unsubscribed_at": "1970-01-01T00:00:00.000Z",\n  "email_open_count": 0,\n  "email_first_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_last_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_click_count": 0,\n  "email_first_clicked_at": "1970-01-01T00:00:00.000Z",\n  "email_clicked_links": [\n    {\n      "url": "string",\n      "clicked_at": "1970-01-01T00:00:00.000Z"\n    }\n  ],\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `updateRecipientEntityUiStatus`\n\nRecords a Next Best Action interaction for a recipient on the Entity-UI channel.\n\n`PATCH /v1/campaign/{campaign_id}/recipient/{recipient_id}/entity_ui:status`\n\n```ts\nconst { data } = await client.updateRecipientEntityUiStatus(\n  {\n    campaign_id: \'example\',\n    recipient_id: \'example\',\n  },\n  {\n    status: \'seen\',\n    entity_schema: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "entity_schema": "string",\n  "title": "string",\n  "automation_status": "pending",\n  "automation_execution_id": "string",\n  "portal_status": "sent",\n  "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "portal_state": {},\n  "entity_ui_status": "seen",\n  "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "entity_ui_status_before_dismiss": "seen",\n  "message_entity_id": "string",\n  "email_status": "sent",\n  "email_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "email_bounce_type": "permanent",\n  "email_bounce_subtype": "string",\n  "email_complaint_type": "string",\n  "email_bounce_reason": "string",\n  "email_send_error": {},\n  "email_unsubscribed_at": "1970-01-01T00:00:00.000Z",\n  "email_open_count": 0,\n  "email_first_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_last_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_click_count": 0,\n  "email_first_clicked_at": "1970-01-01T00:00:00.000Z",\n  "email_clicked_links": [\n    {\n      "url": "string",\n      "clicked_at": "1970-01-01T00:00:00.000Z"\n    }\n  ],\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `restoreRecipientEntityUiStatus`\n\nUndo a dismissal on the Entity-UI (Next Best Action) channel\n\n`POST /v1/campaign/{campaign_id}/recipient/{recipient_id}/entity_ui:restore`\n\n```ts\nconst { data } = await client.restoreRecipientEntityUiStatus({\n  campaign_id: \'example\',\n  recipient_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "entity_schema": "string",\n  "title": "string",\n  "automation_status": "pending",\n  "automation_execution_id": "string",\n  "portal_status": "sent",\n  "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "portal_state": {},\n  "entity_ui_status": "seen",\n  "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "entity_ui_status_before_dismiss": "seen",\n  "message_entity_id": "string",\n  "email_status": "sent",\n  "email_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "email_bounce_type": "permanent",\n  "email_bounce_subtype": "string",\n  "email_complaint_type": "string",\n  "email_bounce_reason": "string",\n  "email_send_error": {},\n  "email_unsubscribed_at": "1970-01-01T00:00:00.000Z",\n  "email_open_count": 0,\n  "email_first_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_last_opened_at": "1970-01-01T00:00:00.000Z",\n  "email_click_count": 0,\n  "email_first_clicked_at": "1970-01-01T00:00:00.000Z",\n  "email_clicked_links": [\n    {\n      "url": "string",\n      "clicked_at": "1970-01-01T00:00:00.000Z"\n    }\n  ],\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `getRecipients`\n\nGet a paginated list of recipients for a campaign.\n\n`GET /v1/campaign/{campaign_id}/recipients`\n\n```ts\nconst { data } = await client.getRecipients({\n  campaign_id: \'example\',\n  limit: 1,\n  next: \'example\',\n  q: \'example\',\n  automation_status: [\'...\'],\n  portal_status: \'example\',\n  email_status: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n      "entity_schema": "string",\n      "title": "string",\n      "automation_status": "pending",\n      "automation_execution_id": "string",\n      "portal_status": "sent",\n      "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n      "portal_state": {},\n      "entity_ui_status": "seen",\n      "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n      "entity_ui_status_before_dismiss": "seen",\n      "message_entity_id": "string",\n      "email_status": "sent",\n      "email_status_updated_at": "1970-01-01T00:00:00.000Z",\n      "email_bounce_type": "permanent",\n      "email_bounce_subtype": "string",\n      "email_complaint_type": "string",\n      "email_bounce_reason": "string",\n      "email_send_error": {},\n      "email_unsubscribed_at": "1970-01-01T00:00:00.000Z",\n      "email_open_count": 0,\n      "email_first_opened_at": "1970-01-01T00:00:00.000Z",\n      "email_last_opened_at": "1970-01-01T00:00:00.000Z",\n      "email_click_count": 0,\n      "email_first_clicked_at": "1970-01-01T00:00:00.000Z",\n      "email_clicked_links": [\n        {\n          "url": "string",\n          "clicked_at": "1970-01-01T00:00:00.000Z"\n        }\n      ],\n      "updated_at": "1970-01-01T00:00:00.000Z"\n    }\n  ],\n  "next": "string",\n  "total": 0\n}\n```\n\n</details>\n\n---\n\n### `getEmailStats`\n\nAggregate email delivery counts for a campaign, for the KPI summary on the campaign UI.\nCounts cover the email (automation) channel only; `total_emailed` is the number of\nrecipients with a recorded em\n\n`GET /v1/campaign/{campaign_id}/email-stats`\n\n```ts\nconst { data } = await client.getEmailStats({\n  campaign_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "total_emailed": 0,\n  "sent": 0,\n  "delivered": 0,\n  "bounced": 0,\n  "bounced_hard": 0,\n  "bounced_soft": 0,\n  "complained": 0,\n  "failed": 0,\n  "unsubscribed": 0,\n  "opened": 0,\n  "clicked": 0,\n  "total_opens": 0,\n  "total_clicks": 0\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `BaseError`\n\n```ts\ntype BaseError = {\n  status: number\n  message: string\n}\n```\n\n### `ServerError`\n\n```ts\ntype ServerError = {\n  status: number\n  message: string\n}\n```\n\n### `ClientError`\n\nDescribes the structure of a client error response, which can be one of several types:\n1. `MessageError`: Contains a \'message\' field for general descriptive errors.\n2. `CodeError`: Contains a \'code\' field for specific, machine-readable error codes.\n3. `StatusedError`: Contains \'error\' and \'status\' f\n\n```ts\ntype ClientError = {\n  message: string\n} | {\n  code: "CAMPAIGN_NOT_FOUND" | "CAMPAIGN_HAS_NO_TARGET" | "CAMPAIGN_HAS_NO_DELIVERY_METHOD" | "INVALID_NEXT_BEST_ACTION" | "CAMPAIGN_HAS_JOB_IN_PROGRESS" | "CAMPAIGN_HAS_UNEXPECTED_STATUS" | "JOB_TOKEN_MISSING" | "TARGET_WITHOUT_FILTERS"\n} | {\n  error: string\n  status: number\n}\n```\n\n### `BaseUUID`\n\n```ts\ntype BaseUUID = string // uuid\n```\n\n### `BaseNanoID`\n\n```ts\ntype BaseNanoID = string\n```\n\n### `BaseTags`\n\n```ts\ntype BaseTags = string[]\n```\n\n### `BaseRelation`\n\n```ts\ntype BaseRelation = {\n  $relation?: Array<{\n    entity_id?: string // uuid\n    _tags?: string[]\n  }>\n}\n```\n\n### `BaseSystemId`\n\n```ts\ntype BaseSystemId = {\n  _id: string // uuid\n}\n```\n\n### `BaseEntityOwner`\n\nThe user / organization owning this entity.\n\nNote: Owner implicitly has access to the entity regardless of ACLs.\n\n\n```ts\ntype BaseEntityOwner = {\n  org_id: string\n  user_id?: string\n}\n```\n\n### `BaseEntityAcl`\n\nAccess control list (ACL) for an entity. Defines sharing access to external orgs or users.\n\n```ts\ntype BaseEntityAcl = {\n  view?: string[]\n  edit?: string[]\n  delete?: string[]\n}\n```\n\n### `BaseSystemFields`\n\n```ts\ntype BaseSystemFields = {\n  _id?: string // uuid\n  _org?: string\n  _owners?: Array<{\n    org_id: string\n    user_id?: string\n  }>\n  _schema?: string\n  _title?: string\n  _tags?: string[]\n  _created_at?: string // date-time\n  _updated_at?: string // date-time\n  _acl?: {\n    view?: string[]\n    edit?: string[]\n    delete?: string[]\n  }\n}\n```\n\n### `BaseSystemFieldsRequired`\n\n```ts\ntype BaseSystemFieldsRequired = object\n```\n\n### `CampaignStatus`\n\n```ts\ntype CampaignStatus = "draft" | "activating" | "active" | "inactive"\n```\n\n### `ExecutionSummaryItem`\n\n```ts\ntype ExecutionSummaryItem = {\n  execution_id?: string\n  execution_status?: string\n}\n```\n\n### `JobStatus`\n\n```ts\ntype JobStatus = {\n  status?: "queued" | "processing" | "finished" | "failed" | "cancelled" | "send_report"\n  execution_summary?: Array<{\n    execution_id?: string\n    execution_status?: string\n  }>\n}\n```\n\n### `Campaign`\n\n```ts\ntype Campaign = {\n  _id?: string // uuid\n  _org?: string\n  _owners?: Array<{\n    org_id: string\n    user_id?: string\n  }>\n  _schema?: string\n  _title?: string\n  _tags?: string[]\n  _created_at?: string // date-time\n  _updated_at?: string // date-time\n  _acl?: {\n    view?: string[]\n    edit?: string[]\n    delete?: string[]\n  }\n  name?: string\n  goal?: string\n  status?: "draft" | "activating" | "active" | "inactive"\n  start_date?: string // date\n  end_date?: string // date\n  flow_id?: string\n  job_id?: string\n  target?: {\n    $relation?: Array<{\n      entity_id?: { ... }\n      _tags?: { ... }\n    }>\n  }\n}\n```\n\n### `Target`\n\n```ts\ntype Target = {\n  _id?: string // uuid\n  _org?: string\n  _owners?: Array<{\n    org_id: string\n    user_id?: string\n  }>\n  _schema?: string\n  _title?: string\n  _tags?: string[]\n  _created_at?: string // date-time\n  _updated_at?: string // date-time\n  _acl?: {\n    view?: string[]\n    edit?: string[]\n    delete?: string[]\n  }\n  name?: string\n  description?: string\n  entity_schema?: string\n  entity_filters?: {\n    filter?: Record<string, unknown>\n    search?: string\n    sort?: Array<{\n      key: { ... }\n      order: { ... }\n    }>\n    limit?: number\n  }\n}\n```\n\n### `TargetEntityFilters`\n\nSearch state of the target. `filter` and `search` use the same shape as the search state of entity views.\nBesides the filters, it optionally defines the order and maximum number of results.\n\n\n```ts\ntype TargetEntityFilters = {\n  filter?: Record<string, unknown>\n  search?: string\n  sort?: Array<{\n    key: string\n    order: "asc" | "desc"\n  }>\n  limit?: number\n}\n```\n\n### `TargetSortItem`\n\n```ts\ntype TargetSortItem = {\n  key: string\n  order: "asc" | "desc"\n}\n```\n\n### `MatchCampaignParams`\n\n```ts\ntype MatchCampaignParams = {\n  entity_refs: Array<{\n    entity_id: string // uuid\n    entity_schema: string\n  }>\n  campaign_ids: string // uuid[]\n}\n```\n\n### `NextBestAction`\n\nA Next Best Action configured on a campaign\'s Entity-UI channel.\nThis is the canonical NBA contract shared by discovery (this API), authoring, and rendering.\nNBA content is single-language in v1; text fields may contain `{{placeholders}}` resolved at render time.\n\n\n```ts\ntype NextBestAction = {\n  category?: string\n  icon?: {\n    name: string\n    color?: string\n  }\n  title: string\n  body?: string\n  priority?: "low" | "medium" | "high"\n  is_dismissable?: boolean\n  cta: {\n    type: "journey" | "workflow" | "flow"\n    target: string\n    context_params?: Array<{\n      key: { ... }\n      value: { ... }\n    }>\n  }\n}\n```\n\n### `DiscoverCampaignsParams`\n\n```ts\ntype DiscoverCampaignsParams = {\n  entity_id: string // uuid\n  entity_schema: string\n}\n```\n\n### `DiscoverResult`\n\nOne discovered Next Best Action, plus this entity\'s interaction state for it.\n\n```ts\ntype DiscoverResult = {\n  campaign_id: string // uuid\n  nba: {\n    category?: string\n    icon?: {\n      name: { ... }\n      color?: { ... }\n    }\n    title: string\n    body?: string\n    priority?: "low" | "medium" | "high"\n    is_dismissable?: boolean\n    cta: {\n      type: { ... }\n      target: { ... }\n      context_params?: { ... }\n    }\n  }\n  status?: "seen" | "dismissed" | "clicked"\n  status_updated_at?: string // date-time\n}\n```\n\n### `MatchTargetParams`\n\n```ts\ntype MatchTargetParams = {\n  entity_refs: Array<{\n    entity_id: string // uuid\n    entity_schema: string\n  }>\n  target_ids: string // uuid[]\n}\n```\n\n### `GetTargetQueriesParams`\n\n```ts\ntype GetTargetQueriesParams = {\n  target_ids: string // uuid[]\n}\n```\n\n### `TargetQueryResult`\n\n```ts\ntype TargetQueryResult = {\n  target_id: string // uuid\n  query: string\n  error?: string\n  sort?: string[]\n  limit?: number\n}\n```\n\n### `AutomationStatus`\n\n```ts\ntype AutomationStatus = "pending" | "in_progress" | "success" | "failed" | "cancelled"\n```\n\n### `PortalStatus`\n\n```ts\ntype PortalStatus = "sent" | "seen" | "dismissed" | "clicked"\n```\n\n### `EntityUiStatus`\n\nLifecycle status of a Next Best Action on the Entity-UI channel. Unlike the portal\nchannel there is no `sent` state: an NBA recipient is born at `seen`, the moment the\naction is first rendered to an agent.\n\n\n```ts\ntype EntityUiStatus = "seen" | "dismissed" | "clicked"\n```\n\n### `EmailStatus`\n\nDelivery status of the email a campaign\'s automation sends to a recipient. Set to `sent`\nonce the automation hands the email off, then updated asynchronously as SES notifications\narrive (`bounced` / `complained`; an SES Reject maps to `bounced`). `failed` is a send-time\nfailure (the automation execu\n\n```ts\ntype EmailStatus = "sent" | "delivered" | "bounced" | "complained" | "failed"\n```\n\n### `EmailBounceType`\n\nSES bounce classification: `permanent` (hard) or `transient` (soft).\n\n```ts\ntype EmailBounceType = "permanent" | "transient"\n```\n\n### `Recipient`\n\n```ts\ntype Recipient = {\n  entity_id?: string // uuid\n  entity_schema?: string\n  title?: string\n  automation_status?: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id?: string\n  portal_status?: "sent" | "seen" | "dismissed" | "clicked"\n  portal_status_updated_at?: string // date-time\n  portal_state?: Record<string, unknown>\n  entity_ui_status?: "seen" | "dismissed" | "clicked"\n  entity_ui_status_updated_at?: string // date-time\n  entity_ui_status_before_dismiss?: "seen" | "dismissed" | "clicked"\n  message_entity_id?: string\n  email_status?: "sent" | "delivered" | "bounced" | "complained" | "failed"\n  email_status_updated_at?: string // date-time\n  email_bounce_type?: "permanent" | "transient"\n  email_bounce_subtype?: string\n  email_complaint_type?: string\n  email_bounce_reason?: string\n  email_send_error?: Record<string, unknown>\n  email_unsubscribed_at?: string // date-time\n  email_open_count?: number\n  email_first_opened_at?: string // date-time\n  email_last_opened_at?: string // date-time\n  email_click_count?: number\n  email_first_clicked_at?: string // date-time\n  email_clicked_links?: Array<{\n    url: string\n    clicked_at: string // date-time\n  }>\n  updated_at?: string // date-time\n}\n```\n\n### `BaseRecipientPayload`\n\n```ts\ntype BaseRecipientPayload = {\n  entity_id: string // uuid\n  entity_schema: string\n}\n```\n\n### `AutomationRecipientPayload`\n\n```ts\ntype AutomationRecipientPayload = {\n  automation_status: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id: string\n}\n```\n\n### `PortalRecipientPayload`\n\n```ts\ntype PortalRecipientPayload = {\n  portal_status: "sent" | "seen" | "dismissed" | "clicked"\n  portal_state?: Record<string, unknown>\n}\n```\n\n### `CreateRecipientPayload`\n\n```ts\ntype CreateRecipientPayload = {\n  entity_id: string // uuid\n  entity_schema: string\n  automation_status: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id: string\n} | {\n  entity_id: string // uuid\n  entity_schema: string\n  portal_status: "sent" | "seen" | "dismissed" | "clicked"\n  portal_state?: Record<string, unknown>\n} | {\n  entity_id: string // uuid\n  entity_schema: string\n  automation_status: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id: string\n  portal_status: "sent" | "seen" | "dismissed" | "clicked"\n  portal_state?: Record<string, unknown>\n}\n```\n\n### `UpdateRecipientPayload`\n\n```ts\ntype UpdateRecipientPayload = {\n  automation_status?: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id?: string\n  portal_status?: "sent" | "seen" | "dismissed" | "clicked"\n  portal_state?: Record<string, unknown>\n}\n```\n\n### `RetriggerAutomationsRequest`\n\n```ts\ntype RetriggerAutomationsRequest = {\n  recipient_ids: string // uuid[]\n}\n```\n\n### `RetriggerAutomationsResult`\n\n```ts\ntype RetriggerAutomationsResult = {\n  recipient_id: string // uuid\n  result: "success" | "failure" | "not_found" | "invalid_status"\n  execution_id?: string\n  error?: string\n}\n```\n\n### `UpdatePortalStatusRequest`\n\n```ts\ntype UpdatePortalStatusRequest = {\n  status: "sent" | "seen" | "dismissed" | "clicked"\n}\n```\n\n### `UpdateEntityUiStatusRequest`\n\n```ts\ntype UpdateEntityUiStatusRequest = {\n  status: "seen" | "dismissed" | "clicked"\n  entity_schema?: string\n}\n```\n\n### `SetupCampaignRequest`\n\nDiscriminated by `type`. Each campaign variant has its own request shape;\nnew variants are added by introducing a new schema and extending the `oneOf` list.\n\n\n```ts\ntype SetupCampaignRequest = {\n  type: "tariff_change"\n  product_recommendation: {\n    name?: string\n    source_product_id?: string // uuid\n    source_price_id?: string // uuid\n    offers?: Array<{\n      target_id?: { ... }\n      items: { ... }\n    }>\n  }\n  campaign: {\n    name: string\n    goal?: string\n    target_ids: string // uuid[]\n  }\n  journey?: {\n    journey_id: string // uuid\n  }\n  channels?: {\n    portal_widget?: {\n      portal_id: { ... }\n      block_id: { ... }\n    }\n    email?: {\n      automation_id?: { ... }\n      template_id?: { ... }\n    }\n    entity_ui?: {\n      category?: { ... }\n      icon?: { ... }\n      title: { ... }\n      body?: { ... }\n      priority?: { ... }\n      is_dismissable?: { ... }\n      cta: { ... }\n    }\n  }\n}\n```\n\n### `SetupTariffChangeCampaignRequest`\n\n```ts\ntype SetupTariffChangeCampaignRequest = {\n  type: "tariff_change"\n  product_recommendation: {\n    name?: string\n    source_product_id?: string // uuid\n    source_price_id?: string // uuid\n    offers?: Array<{\n      target_id?: { ... }\n      items: { ... }\n    }>\n  }\n  campaign: {\n    name: string\n    goal?: string\n    target_ids: string // uuid[]\n  }\n  journey?: {\n    journey_id: string // uuid\n  }\n  channels?: {\n    portal_widget?: {\n      portal_id: { ... }\n      block_id: { ... }\n    }\n    email?: {\n      automation_id?: { ... }\n      template_id?: { ... }\n    }\n    entity_ui?: {\n      category?: { ... }\n      icon?: { ... }\n      title: { ... }\n      body?: { ... }\n      priority?: { ... }\n      is_dismissable?: { ... }\n      cta: { ... }\n    }\n  }\n}\n```\n\n### `SetupTariffChangeCampaignResponse`\n\n```ts\ntype SetupTariffChangeCampaignResponse = {\n  type: "tariff_change"\n  product_recommendation_id: string // uuid\n  campaign_id: string // uuid\n  journey_id?: string // uuid\n  portal_widget_id?: string // uuid\n}\n```\n';
+export {
+  targeting_default as default
+};

package/dist/{targeting.d-BYVSahmV.d.cts → targeting.d-ZvHqD3kC.d.cts}

@@ -1876,6 +1876,19 @@ declare namespace Components {
                      */
                     BaseUUID /* uuid */;
                 };
+                /**
+                 * Entity-UI (Next Best Action) card shown to agents on contact and account pages.
+                 * Persisted verbatim on the campaign's `entity_ui` attribute.
+                 * Only sent by the consumer once the channel has been enabled and configured.
+                 *
+                 */
+                entity_ui?: /**
+                 * A Next Best Action configured on a campaign's Entity-UI channel.
+                 * This is the canonical NBA contract shared by discovery (this API), authoring, and rendering.
+                 * NBA content is single-language in v1; text fields may contain `{{placeholders}}` resolved at render time.
+                 *
+                 */
+                NextBestAction;
             };
         }
         export interface SetupTariffChangeCampaignResponse {
@@ -1927,9 +1940,48 @@ declare namespace Components {
             name?: string;
             description?: string;
             entity_schema?: string;
-            entity_filters?: {
+            entity_filters?: /**
+             * Search state of the target. `filter` and `search` use the same shape as the search state of entity views.
+             * Besides the filters, it optionally defines the order and maximum number of results.
+             *
+             */
+            TargetEntityFilters;
+        }
+        /**
+         * Search state of the target. `filter` and `search` use the same shape as the search state of entity views.
+         * Besides the filters, it optionally defines the order and maximum number of results.
+         *
+         */
+        export interface TargetEntityFilters {
+            [name: string]: any;
+            /**
+             * Group of filters that define which entities match the target.
+             */
+            filter?: {
                 [name: string]: any;
             };
+            /**
+             * Free text search entered in the target builder.
+             * Not applied when resolving the target, e.g. by `getTargetQueries` or `matchTargets`.
+             *
+             */
+            search?: string;
+            /**
+             * Optional sort order of the target results, in priority order.
+             * Only changes the order of the results, never which entities match the target.
+             *
+             * Uses the same key and order pairs as the sort of entity views, but as structured items:
+             * entity views persist their sort as a `key:order,key:order` string instead.
+             *
+             */
+            sort?: TargetSortItem[];
+            /**
+             * Optional maximum number of results returned by the target, applied after sorting.
+             * At most 1000, the maximum number of results entity search returns; larger values are capped to 1000.
+             * Only caps how many results are returned, never which entities match the target.
+             *
+             */
+            limit?: number;
         }
         export interface TargetQueryResult {
             target_id: /**
@@ -1945,6 +1997,32 @@ declare namespace Components {
              * Error message if query transformation failed.
              */
             error?: string;
+            /**
+             * Elasticsearch sort fields for the target's sort order, ready to be passed to entity search.
+             * Ends with an `_id` tie-breaker so the order is stable. Omitted when the target has no sort.
+             *
+             * example:
+             * [
+             *   "billing_date:desc",
+             *   "_title.keyword:asc",
+             *   "_id:desc"
+             * ]
+             */
+            sort?: string[];
+            /**
+             * Maximum number of results the target returns, at most 1000. Omitted when the target has no limit.
+             *
+             */
+            limit?: number;
+        }
+        export interface TargetSortItem {
+            /**
+             * Attribute to sort by. Sub-fields of addresses and relations use a dot path.
+             * example:
+             * billing_address.postal_code
+             */
+            key: string;
+            order: "asc" | "desc";
         }
         export interface UpdateEntityUiStatusRequest {
             status: /**
@@ -2186,6 +2264,7 @@ declare namespace Paths {
             export type $201 = Components.Responses.SetupCampaignResponse;
             export type $400 = Components.Responses.ClientErrorResponse;
             export type $500 = Components.Responses.ServerErrorResponse;
+            export type $504 = Components.Responses.ServerErrorResponse;
         }
     }
     namespace UpdateRecipient {
@@ -2380,6 +2459,7 @@ interface OperationMethods {
    * 
    * Transform target filters into Lucene queries for the provided target IDs.
    * Returns the transformed query string for each target along with any errors encountered.
+   * If the target defines a sort order or a result limit, they are returned as well.
    * 
    */
   'getTargetQueries'(
@@ -2629,6 +2709,7 @@ interface PathsDictionary {
      * 
      * Transform target filters into Lucene queries for the provided target IDs.
      * Returns the transformed query string for each target along with any errors encountered.
+     * If the target defines a sort order or a result limit, they are returned as well.
      * 
      */
     'post'(
@@ -2804,9 +2885,11 @@ type SetupCampaignRequest = Components.Schemas.SetupCampaignRequest;
 type SetupTariffChangeCampaignRequest = Components.Schemas.SetupTariffChangeCampaignRequest;
 type SetupTariffChangeCampaignResponse = Components.Schemas.SetupTariffChangeCampaignResponse;
 type Target = Components.Schemas.Target;
+type TargetEntityFilters = Components.Schemas.TargetEntityFilters;
 type TargetQueryResult = Components.Schemas.TargetQueryResult;
+type TargetSortItem = Components.Schemas.TargetSortItem;
 type UpdateEntityUiStatusRequest = Components.Schemas.UpdateEntityUiStatusRequest;
 type UpdatePortalStatusRequest = Components.Schemas.UpdatePortalStatusRequest;
 type UpdateRecipientPayload = Components.Schemas.UpdateRecipientPayload;
 
-export { type AutomationRecipientPayload as A, type BaseEntityAcl as B, type Client as C, type DiscoverCampaignsParams as D, type EmailBounceType as E, type SetupCampaignRequest as F, type GetTargetQueriesParams as G, type SetupTariffChangeCampaignRequest as H, type SetupTariffChangeCampaignResponse as I, type JobStatus as J, type TargetQueryResult as K, type UpdatePortalStatusRequest as L, type MatchCampaignParams as M, type NextBestAction as N, type OperationMethods as O, Paths as P, type UpdateRecipientPayload as Q, type Recipient as R, type ServerError as S, type Target as T, type UpdateEntityUiStatusRequest as U, Components as a, type PathsDictionary as b, type AutomationStatus as c, type BaseEntityOwner as d, type BaseError as e, type BaseNanoID as f, type BaseRecipientPayload as g, type BaseRelation as h, type BaseSystemFields as i, type BaseSystemFieldsRequired as j, type BaseSystemId as k, type BaseTags as l, type BaseUUID as m, type Campaign as n, type CampaignStatus as o, type ClientError as p, type CreateRecipientPayload as q, type DiscoverResult as r, type EmailStatus as s, type EntityUiStatus as t, type ExecutionSummaryItem as u, type MatchTargetParams as v, type PortalRecipientPayload as w, type PortalStatus as x, type RetriggerAutomationsRequest as y, type RetriggerAutomationsResult as z };
+export { type AutomationRecipientPayload as A, type BaseEntityAcl as B, type Client as C, type DiscoverCampaignsParams as D, type EmailBounceType as E, type SetupCampaignRequest as F, type GetTargetQueriesParams as G, type SetupTariffChangeCampaignRequest as H, type SetupTariffChangeCampaignResponse as I, type JobStatus as J, type TargetEntityFilters as K, type TargetQueryResult as L, type MatchCampaignParams as M, type NextBestAction as N, type OperationMethods as O, Paths as P, type TargetSortItem as Q, type Recipient as R, type ServerError as S, type Target as T, type UpdateEntityUiStatusRequest as U, type UpdatePortalStatusRequest as V, type UpdateRecipientPayload as W, Components as a, type PathsDictionary as b, type AutomationStatus as c, type BaseEntityOwner as d, type BaseError as e, type BaseNanoID as f, type BaseRecipientPayload as g, type BaseRelation as h, type BaseSystemFields as i, type BaseSystemFieldsRequired as j, type BaseSystemId as k, type BaseTags as l, type BaseUUID as m, type Campaign as n, type CampaignStatus as o, type ClientError as p, type CreateRecipientPayload as q, type DiscoverResult as r, type EmailStatus as s, type EntityUiStatus as t, type ExecutionSummaryItem as u, type MatchTargetParams as v, type PortalRecipientPayload as w, type PortalStatus as x, type RetriggerAutomationsRequest as y, type RetriggerAutomationsResult as z };

package/dist/{targeting.d-BYVSahmV.d.ts → targeting.d-ZvHqD3kC.d.ts}

@@ -1876,6 +1876,19 @@ declare namespace Components {
                      */
                     BaseUUID /* uuid */;
                 };
+                /**
+                 * Entity-UI (Next Best Action) card shown to agents on contact and account pages.
+                 * Persisted verbatim on the campaign's `entity_ui` attribute.
+                 * Only sent by the consumer once the channel has been enabled and configured.
+                 *
+                 */
+                entity_ui?: /**
+                 * A Next Best Action configured on a campaign's Entity-UI channel.
+                 * This is the canonical NBA contract shared by discovery (this API), authoring, and rendering.
+                 * NBA content is single-language in v1; text fields may contain `{{placeholders}}` resolved at render time.
+                 *
+                 */
+                NextBestAction;
             };
         }
         export interface SetupTariffChangeCampaignResponse {
@@ -1927,9 +1940,48 @@ declare namespace Components {
             name?: string;
             description?: string;
             entity_schema?: string;
-            entity_filters?: {
+            entity_filters?: /**
+             * Search state of the target. `filter` and `search` use the same shape as the search state of entity views.
+             * Besides the filters, it optionally defines the order and maximum number of results.
+             *
+             */
+            TargetEntityFilters;
+        }
+        /**
+         * Search state of the target. `filter` and `search` use the same shape as the search state of entity views.
+         * Besides the filters, it optionally defines the order and maximum number of results.
+         *
+         */
+        export interface TargetEntityFilters {
+            [name: string]: any;
+            /**
+             * Group of filters that define which entities match the target.
+             */
+            filter?: {
                 [name: string]: any;
             };
+            /**
+             * Free text search entered in the target builder.
+             * Not applied when resolving the target, e.g. by `getTargetQueries` or `matchTargets`.
+             *
+             */
+            search?: string;
+            /**
+             * Optional sort order of the target results, in priority order.
+             * Only changes the order of the results, never which entities match the target.
+             *
+             * Uses the same key and order pairs as the sort of entity views, but as structured items:
+             * entity views persist their sort as a `key:order,key:order` string instead.
+             *
+             */
+            sort?: TargetSortItem[];
+            /**
+             * Optional maximum number of results returned by the target, applied after sorting.
+             * At most 1000, the maximum number of results entity search returns; larger values are capped to 1000.
+             * Only caps how many results are returned, never which entities match the target.
+             *
+             */
+            limit?: number;
         }
         export interface TargetQueryResult {
             target_id: /**
@@ -1945,6 +1997,32 @@ declare namespace Components {
              * Error message if query transformation failed.
              */
             error?: string;
+            /**
+             * Elasticsearch sort fields for the target's sort order, ready to be passed to entity search.
+             * Ends with an `_id` tie-breaker so the order is stable. Omitted when the target has no sort.
+             *
+             * example:
+             * [
+             *   "billing_date:desc",
+             *   "_title.keyword:asc",
+             *   "_id:desc"
+             * ]
+             */
+            sort?: string[];
+            /**
+             * Maximum number of results the target returns, at most 1000. Omitted when the target has no limit.
+             *
+             */
+            limit?: number;
+        }
+        export interface TargetSortItem {
+            /**
+             * Attribute to sort by. Sub-fields of addresses and relations use a dot path.
+             * example:
+             * billing_address.postal_code
+             */
+            key: string;
+            order: "asc" | "desc";
         }
         export interface UpdateEntityUiStatusRequest {
             status: /**
@@ -2186,6 +2264,7 @@ declare namespace Paths {
             export type $201 = Components.Responses.SetupCampaignResponse;
             export type $400 = Components.Responses.ClientErrorResponse;
             export type $500 = Components.Responses.ServerErrorResponse;
+            export type $504 = Components.Responses.ServerErrorResponse;
         }
     }
     namespace UpdateRecipient {
@@ -2380,6 +2459,7 @@ interface OperationMethods {
    * 
    * Transform target filters into Lucene queries for the provided target IDs.
    * Returns the transformed query string for each target along with any errors encountered.
+   * If the target defines a sort order or a result limit, they are returned as well.
    * 
    */
   'getTargetQueries'(
@@ -2629,6 +2709,7 @@ interface PathsDictionary {
      * 
      * Transform target filters into Lucene queries for the provided target IDs.
      * Returns the transformed query string for each target along with any errors encountered.
+     * If the target defines a sort order or a result limit, they are returned as well.
      * 
      */
     'post'(
@@ -2804,9 +2885,11 @@ type SetupCampaignRequest = Components.Schemas.SetupCampaignRequest;
 type SetupTariffChangeCampaignRequest = Components.Schemas.SetupTariffChangeCampaignRequest;
 type SetupTariffChangeCampaignResponse = Components.Schemas.SetupTariffChangeCampaignResponse;
 type Target = Components.Schemas.Target;
+type TargetEntityFilters = Components.Schemas.TargetEntityFilters;
 type TargetQueryResult = Components.Schemas.TargetQueryResult;
+type TargetSortItem = Components.Schemas.TargetSortItem;
 type UpdateEntityUiStatusRequest = Components.Schemas.UpdateEntityUiStatusRequest;
 type UpdatePortalStatusRequest = Components.Schemas.UpdatePortalStatusRequest;
 type UpdateRecipientPayload = Components.Schemas.UpdateRecipientPayload;
 
-export { type AutomationRecipientPayload as A, type BaseEntityAcl as B, type Client as C, type DiscoverCampaignsParams as D, type EmailBounceType as E, type SetupCampaignRequest as F, type GetTargetQueriesParams as G, type SetupTariffChangeCampaignRequest as H, type SetupTariffChangeCampaignResponse as I, type JobStatus as J, type TargetQueryResult as K, type UpdatePortalStatusRequest as L, type MatchCampaignParams as M, type NextBestAction as N, type OperationMethods as O, Paths as P, type UpdateRecipientPayload as Q, type Recipient as R, type ServerError as S, type Target as T, type UpdateEntityUiStatusRequest as U, Components as a, type PathsDictionary as b, type AutomationStatus as c, type BaseEntityOwner as d, type BaseError as e, type BaseNanoID as f, type BaseRecipientPayload as g, type BaseRelation as h, type BaseSystemFields as i, type BaseSystemFieldsRequired as j, type BaseSystemId as k, type BaseTags as l, type BaseUUID as m, type Campaign as n, type CampaignStatus as o, type ClientError as p, type CreateRecipientPayload as q, type DiscoverResult as r, type EmailStatus as s, type EntityUiStatus as t, type ExecutionSummaryItem as u, type MatchTargetParams as v, type PortalRecipientPayload as w, type PortalStatus as x, type RetriggerAutomationsRequest as y, type RetriggerAutomationsResult as z };
+export { type AutomationRecipientPayload as A, type BaseEntityAcl as B, type Client as C, type DiscoverCampaignsParams as D, type EmailBounceType as E, type SetupCampaignRequest as F, type GetTargetQueriesParams as G, type SetupTariffChangeCampaignRequest as H, type SetupTariffChangeCampaignResponse as I, type JobStatus as J, type TargetEntityFilters as K, type TargetQueryResult as L, type MatchCampaignParams as M, type NextBestAction as N, type OperationMethods as O, Paths as P, type TargetSortItem as Q, type Recipient as R, type ServerError as S, type Target as T, type UpdateEntityUiStatusRequest as U, type UpdatePortalStatusRequest as V, type UpdateRecipientPayload as W, Components as a, type PathsDictionary as b, type AutomationStatus as c, type BaseEntityOwner as d, type BaseError as e, type BaseNanoID as f, type BaseRecipientPayload as g, type BaseRelation as h, type BaseSystemFields as i, type BaseSystemFieldsRequired as j, type BaseSystemId as k, type BaseTags as l, type BaseUUID as m, type Campaign as n, type CampaignStatus as o, type ClientError as p, type CreateRecipientPayload as q, type DiscoverResult as r, type EmailStatus as s, type EntityUiStatus as t, type ExecutionSummaryItem as u, type MatchTargetParams as v, type PortalRecipientPayload as w, type PortalStatus as x, type RetriggerAutomationsRequest as y, type RetriggerAutomationsResult as z };