@talqing/mcp 0.7.0 → 0.8.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Talqing
+Copyright (c) 2026 Oggnai Technologies Private Limited
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -10,9 +10,8 @@ the CoPilot can build, your coding agent can build.
 ## What you get
 
 One operation for everything a workspace is built out of. Agents and agent
-tasks, tools and their operation trees, integrations and triggers, knowledge
-bases from crawl to ready, carrier accounts and phone numbers, secrets, provider
-keys and webhooks; then placing outbound calls, running call and email batches,
+tasks, tools and their operation trees, integrations and triggers, carrier
+accounts and phone numbers, secrets, provider keys and webhooks; then placing outbound calls, running call and email batches,
 talking to text agents, and reading back transcripts, cost and latency. Each one
 maps to a Talqing API endpoint, and its arguments mirror that HTTP call: path and
 query parameters at the top level, request body under `body`.
@@ -34,19 +33,11 @@ ready-to-paste command for each client — the snippets below are what it shows.
 The token authenticates as you, acts with your current role, and reaches only
 your workspace.
 
-**`TALQING_BASE_URL` names a region** — `https://api.in.talqing.com`,
-`https://api.us.talqing.com` — and everything this server can reach belongs to
-that one: an agent, its calls, its phone numbers and its credit balance are all
-the region's. One token reaches every region — it names your workspace, not a
-place — so working in another region is the same token and a different base URL.
-The dashboard's snippet always carries the region you are currently looking at;
-switch region there and copy it again.
-
 **Claude Code**
 
 ```bash
 claude mcp add talqing \
-  -e TALQING_BASE_URL=https://api.in.talqing.com \
+  -e TALQING_BASE_URL=https://api.talqing.com \
   -e TALQING_API_KEY=tq_your_token \
   -- npx -y @talqing/mcp
 ```
@@ -55,7 +46,7 @@ claude mcp add talqing \
 
 ```bash
 codex mcp add talqing \
-  --env TALQING_BASE_URL=https://api.in.talqing.com \
+  --env TALQING_BASE_URL=https://api.talqing.com \
   --env TALQING_API_KEY=tq_your_token \
   -- npx -y @talqing/mcp
 ```
@@ -67,7 +58,7 @@ codex mcp add talqing \
 [mcp_servers.talqing]
 command = "npx"
 args = ["-y", "@talqing/mcp"]
-env = { TALQING_BASE_URL = "https://api.in.talqing.com", TALQING_API_KEY = "tq_your_token" }
+env = { TALQING_BASE_URL = "https://api.talqing.com", TALQING_API_KEY = "tq_your_token" }
 ```
 
 **Any other MCP client** — a stdio server, configured the usual way:
@@ -79,7 +70,7 @@ env = { TALQING_BASE_URL = "https://api.in.talqing.com", TALQING_API_KEY = "tq_y
       "command": "npx",
       "args": ["-y", "@talqing/mcp"],
       "env": {
-        "TALQING_BASE_URL": "https://api.in.talqing.com",
+        "TALQING_BASE_URL": "https://api.talqing.com",
         "TALQING_API_KEY": "tq_your_token"
       }
     }
@@ -107,9 +98,9 @@ Four things are deliberately out of reach:
   where a human is in the loop.
 - **Buying credits.** Reading the balance would be harmless; starting a payment
   spends the workspace's money, and neither belongs on a coding agent's surface.
-- **Streaming endpoints**, which are not tool-shaped. Every one has a polling
-  equivalent here — `list_conversation_items` for a conversation, `get_kb` for a
-  knowledge build — so nothing is unreachable.
+- **Streaming endpoints**, which are not tool-shaped. Each has a polling
+  equivalent here — `list_conversation_items` for a conversation — so nothing is
+  unreachable.
 - **Deleting a call or its recording.** Every other `delete_*` removes
   configuration you could write again; this one destroys the record of something
   that happened, and can take a contact's memory of past calls with it.
@@ -135,7 +126,7 @@ cd mcp && npm install && npm run build
       "command": "node",
       "args": ["/absolute/path/to/talqing/mcp/dist/index.js"],
       "env": {
-        "TALQING_BASE_URL": "https://api.in.talqing.com",
+        "TALQING_BASE_URL": "https://api.talqing.com",
         "TALQING_API_KEY": "tq_your_token"
       }
     }

package/SKILL.md

@@ -3,9 +3,9 @@ name: talqing
 description: >-
   Build, publish and operate Talqing AI voice, video and text agents — agent
   config and model stack, custom tools and their operation trees, MCP and
-  messaging integrations, knowledge bases, phone numbers, secrets and webhooks,
-  plus placing calls and reading back transcripts, cost and latency. Use
-  whenever working against a Talqing workspace through the talqing MCP server.
+  messaging integrations, phone numbers, secrets and webhooks, plus placing
+  calls and reading back transcripts, cost and latency. Use whenever working
+  against a Talqing workspace through the talqing MCP server.
 ---
 
 <!-- Generated by openapi/export.py from backend/services/copilot/skill.md. Edit that file, then re-run the export. -->
@@ -14,7 +14,7 @@ description: >-
 
 Talqing is a no-code builder for AI voice, video and text agents. Everything you
 can build here you could otherwise have written as a LiveKit agent by hand: a
-model stack, a system prompt, callable tools, knowledge, and lifecycle hooks.
+model stack, a system prompt, callable tools, and lifecycle hooks.
 The same machinery also runs **agent tasks** — an agent nobody talks to, which
 takes named inputs and returns a typed result.
 
@@ -27,12 +27,6 @@ request body under `body`. Every operation acts as the signed-in user, inside
 their workspace only, with their role's permissions. Managing who is in the
 workspace is the one thing that stays in the dashboard.
 
-**Everything here belongs to one region.** A workspace exists in every region and
-its resources do not: an agent, its calls, its phone numbers and its credit
-balance all live in the region whose API you are pointed at. One token reaches
-every region — it names the workspace, not a place — so working in another one is
-the same token and a different base URL.
-
 ## What an agent is
 
 An agent is a single object, `config`, plus what you attach to it:
@@ -156,13 +150,17 @@ An agent is a single object, `config`, plus what you attach to it:
   create it, publish v1 and store `{"tool_id": "..."}` in its place, so the
   agent and its tools can be built in one request. Use it for exactly that.
   Attaching an existing tool is still `tool_id`.
-- **`kb_ids`** — ready knowledge bases for grounded answers.
 - **`mcps`** — external MCP servers whose tools the agent may call, each
   `{"integration_id": "..."}` naming an active, MCP-capable integration. Which
   of a server's tools may be called is the integration's own `allowed_tools`,
   not this list. As with `tools`, an entry may instead carry `{"mcp": {name,
   url, headers, allowed_tools, tools_namespace}}`, which is created as a
   `custom_mcp` integration and replaced by its id.
+- **`faqs`** — FAQs the agent answers from, each `{"faq_id": "..."}`, up to ten
+  (see FAQs below). As with `tools`, an entry may instead carry `{"faq": {name,
+  entries: [{question, answer}]}}`, which `create_agent` and `update_agent`
+  create as a stored FAQ and replace by its id — so an agent and its FAQ can be
+  built in one request.
 - **`tasks`** — jobs this agent can enter and come back from, each
   `{"name": "collect_shipping_address", "task_id": "...", "description": "...",
   "message": "..."}`. Each becomes one ordinary tool the model can call: the
@@ -337,9 +335,8 @@ starts that object over, so send its `voice` and settings with it. Unknown field
 
 The config is validated on every write. Unknown models, a model that does not
 support the channel, a language the model does not offer, a speed outside the
-model's range, an unpublished tool, a knowledge base that is not ready — all are
-refused with an explanation. Read the error and correct it; that is faster than
-guessing.
+model's range, an unpublished tool — all are refused with an explanation. Read
+the error and correct it; that is faster than guessing.
 
 Some fields are normalized for you. Switching to `text` clears `stt`, `tts`,
 `greeting`, `turn_handling` and `avatar`. Switching to `video` fills in an
@@ -579,7 +576,7 @@ of whatever the models cost.
 A tool is one capability the agent's LLM can call mid-conversation. It has:
 
 - **`name`** — the function name the LLM sees. A valid identifier, snake_case,
-  describing the capability. `knowledge_fetch` is reserved.
+  describing the capability.
 - **`description`** — tells the LLM *when* to call it. This matters as much as
   the implementation.
 - **`json_schema`** — the arguments the LLM supplies. Declare only values the
@@ -871,9 +868,9 @@ Each hook points at a **published tool id**, or null.
 ## Agent tasks
 
 An **agent task** takes named inputs, does some work, and returns a **typed
-structured output**. Same prompt, same model, same tools, same MCP servers, same
-knowledge and same lifecycle hooks as an agent — minus everything that belongs
-to a *session*, because a task never owns one.
+structured output**. Same prompt, same model, same tools, same MCP servers and
+same lifecycle hooks as an agent — minus everything that belongs to a
+*session*, because a task never owns one.
 
 **It runs two ways, and declares nothing that ties it to either.** On its own —
 `POST /v1/tasks/{task_id}/runs`, or an email batch drafting a row — it is an LLM
@@ -901,7 +898,7 @@ message, draft an opening line, take a shipping address mid-call.
   a step rather than as one, so it costs no steps and real seconds. It is the
   one media slot a task keeps, because an LLM is stateless per request and
   swapping one in rebuilds nothing.
-- **`kb_ids`**, **`on_enter`**, **`on_exit`**, **`on_user_turn_completed`** —
+- **`on_enter`**, **`on_exit`**, **`on_user_turn_completed`** —
   exactly an agent's. `on_user_turn_completed` only ever fires when an agent
   entered the task; a standalone run has nobody to take a turn.
 - There is no `stt`, `tts`, `realtime`, `language`, `turn_handling`, `channel`,
@@ -913,6 +910,7 @@ message, draft an opening line, take a shipping address mid-call.
 - **`tools`** / **`mcps`** — exactly an agent's, attached by id or defined
   inline, and pinned by publish exactly as an agent's are: republishing a tool
   does not change a published task until that task is published again.
+- **`faqs`** — exactly an agent's.
 - **`vars`** — the task's **inputs**, declared exactly as an agent's variables
   are: a `name`, a `description`, an optional `default` and `required`. A run
   supplies values by name; one it omits falls back to the `default`, and a
@@ -1048,14 +1046,42 @@ tell apart.
 Task runs are **not** in the Observability charts, which are built on calls and
 conversations. `list_task_runs` is where a task's own history lives.
 
+## FAQs
+
+An FAQ is a named list of question/answer pairs the business wrote. Attached
+through `faqs`, its **questions** are added to the agent's prompt and the agent
+gets one generated tool, `get_faq_answers`, that returns the written **answers**
+for the questions it picks — so what the agent says is the business's own text.
+Do not create a tool with that name; it is reserved.
+
+- **Use one for stable facts people ask often and the business wants answered
+  exactly**: opening hours, refund policy, delivery areas, pricing. Behaviour,
+  tone and what to do next belong in the prompt; anything that changes per
+  caller or needs a live lookup belongs in a tool.
+- **Edits are live.** Changing a question or an answer reaches every agent using
+  the FAQ from its next session, with no republish. Attaching or detaching an
+  FAQ is a config change and does take a publish.
+- **Phrase each question the way a caller would ask it** — "Do you deliver on
+  Sundays?", not "Sunday delivery policy". The model matches what was asked
+  against the question text, so paraphrases need no extra entries.
+- **Keep answers short and speakable on a voice agent**: one or two sentences,
+  no lists, links or markdown, since the agent will say it aloud.
+- **Add many at once with `create_faq_entries`** (up to 500 per FAQ, all or
+  nothing), and fix one with `update_faq_entry` rather than recreating the FAQ.
+  A question may appear only once per FAQ.
+- Do not also paste the answers into the prompt, and do not tell the agent to
+  refuse what the FAQ lacks unless the user asks for that.
+
+`delete_faq` is refused with 409 while an agent or task attaches it; detach it
+there first.
+
 ## Integrations
 
 Integrations are external services, and they come in two shapes.
 
 **MCP integrations** give an agent tools from an external server. Attach them
-in the agent's own config, as `mcps` — the same place as `tools` and
-`kb_ids`, written by `create_agent` or `update_agent`, and frozen at publish
-like the rest of it. So attaching one **takes a publish** before a call sees it.
+in the agent's own config, as `mcps` — the same place as `tools`, written by
+`create_agent` or `update_agent`, and frozen at publish like the rest of it. So attaching one **takes a publish** before a call sees it.
 `list_integration_mcp_tools` connects to the server and lists everything it
 offers, which also proves the connection works.
 
@@ -1357,33 +1383,6 @@ Replies are answered by the agent on the sender's
 `{{userdata.<column>}}` and the whole template, buttons included, as its own
 first message — so write that agent's prompt against the CSV's column names.
 
-## Knowledge bases
-
-A knowledge base gives an agent grounded answers over crawled content. Attach
-it through the agent's `kb_ids`. A call reads only `ready` ones, so one still
-building can be attached now and is used once it finishes.
-
-Building one runs in three stages and takes minutes, not seconds:
-
-1. `create_kb` with the site URLs starts the crawl. It returns immediately at
-   `discovering` — poll `get_kb` until `status` is `review`.
-2. At `review`, `discovered` holds every URL the crawl found. Choose the ones
-   worth indexing and pass them to `build_kb`. This choice decides the quality
-   of the whole knowledge base: prefer pages that answer real questions over
-   everything the crawl happened to reach.
-3. The KB moves through `transcribing` and `generating` to `ready`. Keep
-   polling `get_kb`; `progress` says what stage it is in and `error` says if it
-   stopped.
-
-Once ready, `get_kb_prompt` is the table of contents exactly as the agent
-receives it — read it to judge what the agent will actually be able to find,
-since a vague entry is one it will never fetch. `list_pages` shows which URLs
-failed to transcribe, `patch_node` corrects an entry by hand, and
-`regenerate_toc` rebuilds the structure without crawling again.
-
-Tell the user a build is running rather than waiting silently through it, and
-never poll a build in a tight loop.
-
 ## Secrets, keys and webhooks
 
 **Secrets** are workspace values referenced as `{{secrets.NAME}}` from tool
@@ -1496,8 +1495,8 @@ and the final `userdata` usually name the cause.
   connected channel is a message they receive. Both are irreversible. Test
   against a number or thread the user has named, never one you picked.
 - **Delete only on an explicit request naming the target.** Agents, tools,
-  knowledge bases, carrier accounts, integrations, triggers, secrets, webhooks
-  and tokens are all permanent. Taking a phone number out of service stops real
+  carrier accounts, integrations, triggers, secrets, webhooks and tokens are
+  all permanent. Taking a phone number out of service stops real
   callers from reaching anyone — treat it the same way.
 - **Never echo a secret back.** Personal access tokens, webhook signing secrets
   and provider keys are shown once; repeating one puts it in the conversation

package/dist/index.js

@@ -28,7 +28,7 @@ function required(name, hint) {
         throw new Error(`${name} is not set — ${hint}`);
     return value;
 }
-const BASE_URL = required("TALQING_BASE_URL", "set it to your region's Talqing API URL, e.g. https://api.in.talqing.com").replace(/\/+$/, "");
+const BASE_URL = required("TALQING_BASE_URL", "set it to the Talqing API URL, e.g. https://api.talqing.com").replace(/\/+$/, "");
 const API_KEY = required("TALQING_API_KEY", "create a personal access token in the dashboard under Organization → API Tokens");
 const { tools: functions } = JSON.parse(readPackageFile("tools.json"));
 const byName = new Map(functions.map((fn) => [fn.name, fn]));

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talqing/mcp",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "MCP server for building Talqing AI voice, video and text agents from Claude Code, Codex, or any MCP client.",
   "license": "MIT",
   "homepage": "https://talqing.com",

package/tools.json

@@ -591,156 +591,114 @@
       "role": "write"
     },
     {
-      "description": "List the workspace's knowledge bases with their build status.",
+      "description": "List the workspace's FAQs by name, with how many questions each holds.",
       "method": "GET",
-      "name": "list_kbs",
+      "name": "list_faqs",
       "parameters": {
         "additionalProperties": true,
-        "description": "Arguments not inlined: call describe_function('list_kbs').",
+        "description": "Arguments not inlined: call describe_function('list_faqs').",
         "properties": {},
         "type": "object"
       },
-      "path": "/v1/knowledge",
+      "path": "/v1/faqs",
       "read_only": true,
       "role": "read"
     },
     {
-      "description": "Start a knowledge base by crawling one or more websites.",
+      "description": "Create an FAQ, optionally with its first question/answer entries.",
       "method": "POST",
-      "name": "create_kb",
+      "name": "create_faq",
       "parameters": {
         "additionalProperties": true,
-        "description": "Arguments not inlined: call describe_function('create_kb').",
+        "description": "Arguments not inlined: call describe_function('create_faq').",
         "properties": {},
         "type": "object"
       },
-      "path": "/v1/knowledge",
+      "path": "/v1/faqs",
       "read_only": false,
       "role": "write"
     },
     {
-      "description": "Read one knowledge base: build status, progress and content tree.",
+      "description": "Get one FAQ with every entry, in the order they were added.",
       "method": "GET",
-      "name": "get_kb",
+      "name": "get_faq",
       "parameters": {
         "additionalProperties": true,
-        "description": "Arguments not inlined: call describe_function('get_kb').",
+        "description": "Arguments not inlined: call describe_function('get_faq').",
         "properties": {},
         "type": "object"
       },
-      "path": "/v1/knowledge/{kb_id}",
+      "path": "/v1/faqs/{faq_id}",
       "read_only": true,
       "role": "read"
     },
     {
-      "description": "Index the chosen pages, then write the table of contents.",
-      "method": "POST",
-      "name": "build_kb",
+      "description": "Rename an FAQ.",
+      "method": "PATCH",
+      "name": "update_faq",
       "parameters": {
         "additionalProperties": true,
-        "description": "Arguments not inlined: call describe_function('build_kb').",
+        "description": "Arguments not inlined: call describe_function('update_faq').",
         "properties": {},
         "type": "object"
       },
-      "path": "/v1/knowledge/{kb_id}/build",
+      "path": "/v1/faqs/{faq_id}",
       "read_only": false,
       "role": "write"
     },
     {
-      "description": "Rewrite the table of contents from the pages already indexed.",
-      "method": "POST",
-      "name": "regenerate_toc",
+      "description": "Delete an FAQ and its entries. Refused with 409 while an agent or task still attaches it.",
+      "method": "DELETE",
+      "name": "delete_faq",
       "parameters": {
         "additionalProperties": true,
-        "description": "Arguments not inlined: call describe_function('regenerate_toc').",
+        "description": "Arguments not inlined: call describe_function('delete_faq').",
         "properties": {},
         "type": "object"
       },
-      "path": "/v1/knowledge/{kb_id}/toc",
+      "path": "/v1/faqs/{faq_id}",
       "read_only": false,
       "role": "write"
     },
     {
-      "description": "List the crawled pages and how each one transcribed.",
-      "method": "GET",
-      "name": "list_pages",
-      "parameters": {
-        "additionalProperties": true,
-        "description": "Arguments not inlined: call describe_function('list_pages').",
-        "properties": {},
-        "type": "object"
-      },
-      "path": "/v1/knowledge/{kb_id}/pages",
-      "read_only": true,
-      "role": "read"
-    },
-    {
-      "description": "The table of contents exactly as an agent using this KB is given it.",
-      "method": "GET",
-      "name": "get_kb_prompt",
-      "parameters": {
-        "additionalProperties": true,
-        "description": "Arguments not inlined: call describe_function('get_kb_prompt').",
-        "properties": {},
-        "type": "object"
-      },
-      "path": "/v1/knowledge/{kb_id}/prompt",
-      "read_only": true,
-      "role": "read"
-    },
-    {
-      "description": "Read one entry of the table of contents, with its full content.",
-      "method": "GET",
-      "name": "get_node",
-      "parameters": {
-        "additionalProperties": true,
-        "description": "Arguments not inlined: call describe_function('get_node').",
-        "properties": {},
-        "type": "object"
-      },
-      "path": "/v1/knowledge/{kb_id}/nodes/{node_id}",
-      "read_only": true,
-      "role": "read"
-    },
-    {
-      "description": "Correct one entry's title, summary or content by hand \u2014 the way to fix a fact the crawl got wrong without rebuilding.",
-      "method": "PATCH",
-      "name": "patch_node",
+      "description": "Append question/answer entries to an FAQ, all or nothing. Live at once: agents using the FAQ read them from their next session.",
+      "method": "POST",
+      "name": "create_faq_entries",
       "parameters": {
         "additionalProperties": true,
-        "description": "Arguments not inlined: call describe_function('patch_node').",
+        "description": "Arguments not inlined: call describe_function('create_faq_entries').",
         "properties": {},
         "type": "object"
       },
-      "path": "/v1/knowledge/{kb_id}/nodes/{node_id}",
+      "path": "/v1/faqs/{faq_id}/entries",
       "read_only": false,
       "role": "write"
     },
     {
-      "description": "Drop one entry from the table of contents, permanently.",
-      "method": "DELETE",
-      "name": "delete_node",
+      "description": "Change one entry's question, answer or both. Live from the next session.",
+      "method": "PATCH",
+      "name": "update_faq_entry",
       "parameters": {
         "additionalProperties": true,
-        "description": "Arguments not inlined: call describe_function('delete_node').",
+        "description": "Arguments not inlined: call describe_function('update_faq_entry').",
         "properties": {},
         "type": "object"
       },
-      "path": "/v1/knowledge/{kb_id}/nodes/{node_id}",
+      "path": "/v1/faqs/{faq_id}/entries/{entry_id}",
       "read_only": false,
       "role": "write"
     },
     {
-      "description": "Delete a knowledge base and everything crawled into it, permanently.",
+      "description": "Delete one entry from an FAQ.",
       "method": "DELETE",
-      "name": "delete_kb",
+      "name": "delete_faq_entry",
       "parameters": {
         "additionalProperties": true,
-        "description": "Arguments not inlined: call describe_function('delete_kb').",
+        "description": "Arguments not inlined: call describe_function('delete_faq_entry').",
         "properties": {},
         "type": "object"
       },
-      "path": "/v1/knowledge/{kb_id}",
+      "path": "/v1/faqs/{faq_id}/entries/{entry_id}",
       "read_only": false,
       "role": "write"
     },
@@ -1122,6 +1080,20 @@
       "read_only": false,
       "role": "write"
     },
+    {
+      "description": "Remove rows that were never dialled. Not reversible; a dialled row is refused in `rejected`.",
+      "method": "POST",
+      "name": "delete_call_batch_recipients",
+      "parameters": {
+        "additionalProperties": true,
+        "description": "Arguments not inlined: call describe_function('delete_call_batch_recipients').",
+        "properties": {},
+        "type": "object"
+      },
+      "path": "/v1/calls/batches/{batch_id}/recipients/delete",
+      "read_only": false,
+      "role": "write"
+    },
     {
       "description": "Stop placing new calls; calls in progress run to their end.",
       "method": "POST",
@@ -1319,30 +1291,16 @@
       "role": "write"
     },
     {
-      "description": "Take rows out of consideration. Reversible with `restore`.",
-      "method": "POST",
-      "name": "skip_email_batch_recipients",
-      "parameters": {
-        "additionalProperties": true,
-        "description": "Arguments not inlined: call describe_function('skip_email_batch_recipients').",
-        "properties": {},
-        "type": "object"
-      },
-      "path": "/v1/email/batches/{batch_id}/skip",
-      "read_only": false,
-      "role": "write"
-    },
-    {
-      "description": "Put skipped rows back. `selection: \"all_eligible\"` means every row a person skipped; an `unfillable` row is restored by filling in its cell instead.",
+      "description": "Remove rows that were never sent. Not reversible; a sent row is refused in `rejected`.",
       "method": "POST",
-      "name": "restore_email_batch_recipients",
+      "name": "delete_email_batch_recipients",
       "parameters": {
         "additionalProperties": true,
-        "description": "Arguments not inlined: call describe_function('restore_email_batch_recipients').",
+        "description": "Arguments not inlined: call describe_function('delete_email_batch_recipients').",
         "properties": {},
         "type": "object"
       },
-      "path": "/v1/email/batches/{batch_id}/restore",
+      "path": "/v1/email/batches/{batch_id}/recipients/delete",
       "read_only": false,
       "role": "write"
     },
@@ -1599,30 +1557,16 @@
       "role": "write"
     },
     {
-      "description": "Take ready rows out of the send. Reversible with restore.",
-      "method": "POST",
-      "name": "skip_whatsapp_batch_recipients",
-      "parameters": {
-        "additionalProperties": true,
-        "description": "Arguments not inlined: call describe_function('skip_whatsapp_batch_recipients').",
-        "properties": {},
-        "type": "object"
-      },
-      "path": "/v1/whatsapp/batches/{batch_id}/recipients/skip",
-      "read_only": false,
-      "role": "write"
-    },
-    {
-      "description": "Put rows a person skipped back. A row skipped for its cells returns when they are fixed.",
+      "description": "Remove rows that were never sent. Not reversible; a sent row is refused in `rejected`.",
       "method": "POST",
-      "name": "restore_whatsapp_batch_recipients",
+      "name": "delete_whatsapp_batch_recipients",
       "parameters": {
         "additionalProperties": true,
-        "description": "Arguments not inlined: call describe_function('restore_whatsapp_batch_recipients').",
+        "description": "Arguments not inlined: call describe_function('delete_whatsapp_batch_recipients').",
         "properties": {},
         "type": "object"
       },
-      "path": "/v1/whatsapp/batches/{batch_id}/recipients/restore",
+      "path": "/v1/whatsapp/batches/{batch_id}/recipients/delete",
       "read_only": false,
       "role": "write"
     },