@arizeai/phoenix-client 7.13.0 → 7.15.0

package/docs/datasets.mdx

@@ -3,7 +3,7 @@ title: "Datasets"
 description: "Create and inspect datasets with @arizeai/phoenix-client"
 ---
 
-Datasets are the foundation for experiment runs. The dataset helpers cover creation (which upserts by name), record inspection, and example appends.
+Datasets are the foundation for experiment runs. The dataset helpers cover creation (which upserts by name), record inspection, example appends, and split management.
 
 <section className="hidden" data-agent-context="relevant-source-files" aria-label="Relevant source files">
   <h2>Relevant Source Files</h2>
@@ -25,14 +25,27 @@ const { datasetId } = await createDataset({
   description: "Support questions with expected answers",
   examples: [
     {
+      id: "order-tracking",
       input: { question: "Where is my order?" },
       output: { answer: "Use the tracking page in your account." },
       metadata: { channel: "chat" },
     },
+    {
+      id: "password-reset",
+      input: { question: "How do I reset my password?" },
+      output: { answer: "Use the forgot password flow." },
+      metadata: { channel: "chat" },
+    },
   ],
 });
 ```
 
+`id` is optional. When you do provide it, give every example its own value:
+example IDs are unique per dataset, so reusing one across examples in the same
+dataset is an error. A stable, unique `id` is what `createDataset()` matches on
+when it upserts, and what you can hand to the split helpers below instead of the
+server-generated `nodeId`. Omit `id` and the server generates one for you.
+
 ## Upsert Or Append
 
 `createDataset()` upserts by name: re-running it with the same name updates the existing dataset to match the examples you pass, and an unchanged upload is a no-op. To keep existing examples and add more, use `appendDatasetExamples()` instead of re-running `createDataset()` with the extra examples.
@@ -48,6 +61,7 @@ const dataset = await createDataset({
   description: "Support questions with expected answers",
   examples: [
     {
+      id: "order-tracking",
       input: { question: "Where is my order?" },
       output: { answer: "Use the tracking page in your account." },
     },
@@ -58,6 +72,7 @@ await appendDatasetExamples({
   dataset,
   examples: [
     {
+      id: "password-reset",
       input: { question: "How do I reset my password?" },
       output: { answer: "Use the forgot password flow." },
     },
@@ -71,6 +86,61 @@ await appendDatasetExamples({
 
 Use `getDataset`, `getDatasetExamples`, and `getDatasetInfo` to inspect datasets after creation.
 
+## Manage Splits On An Existing Dataset
+
+Use `createDatasetSplit`, `updateDatasetSplit`, and `deleteDatasetSplit` to
+manage train, test, validation, or other named subsets after a dataset exists.
+Select the dataset by name or GlobalID. Example membership accepts either the
+user-provided `id` or Phoenix `nodeId` returned by `getDatasetExamples`.
+
+```ts
+import {
+  createDatasetSplit,
+  deleteDatasetSplit,
+  getDatasetExamples,
+  updateDatasetSplit,
+} from "@arizeai/phoenix-client/datasets";
+
+const datasetIdentifier = "support-eval";
+const dataset = { datasetName: datasetIdentifier };
+const { examples } = await getDatasetExamples({
+  dataset,
+});
+const [firstExample, secondExample] = examples;
+if (firstExample == null || secondExample == null) {
+  throw new Error("At least two examples are required to demonstrate split updates");
+}
+
+const testSplit = await createDatasetSplit({
+  dataset,
+  name: "test",
+  description: "Held-out evaluation examples",
+  exampleIds: [firstExample.id],
+});
+
+// Only provided fields change. Adding an existing member or removing a
+// non-member is an idempotent no-op.
+await updateDatasetSplit({
+  dataset,
+  splitId: testSplit.id,
+  description: "Reviewed held-out examples",
+  addExampleIds: [secondExample.id],
+  removeExampleIds: [firstExample.id],
+});
+
+// Deleting a split removes its memberships, not the underlying examples.
+await deleteDatasetSplit({
+  dataset,
+  splitId: testSplit.id,
+});
+```
+
+Split names are unique across the Phoenix instance. Creating or renaming a
+split to an existing name fails with HTTP 409. These helpers require Phoenix
+server 19.20.0 or newer. Servers on 19.20.0 through 20.15.0 resolve membership
+by `nodeId` only — user-provided `id` values are accepted from the release that
+follows 20.15.0, so pass `nodeId` when you target an older server.
+
 <section className="hidden" data-agent-context="source-map" aria-label="Source map">
   <h2>Source Map</h2>
   <ul>
@@ -79,5 +149,8 @@ Use `getDataset`, `getDatasetExamples`, and `getDatasetInfo` to inspect datasets
     <li><code>src/datasets/getDataset.ts</code></li>
     <li><code>src/datasets/getDatasetExamples.ts</code></li>
     <li><code>src/datasets/getDatasetInfo.ts</code></li>
+    <li><code>src/datasets/createDatasetSplit.ts</code></li>
+    <li><code>src/datasets/updateDatasetSplit.ts</code></li>
+    <li><code>src/datasets/deleteDatasetSplit.ts</code></li>
   </ul>
 </section>

package/docs/prompts.mdx

@@ -3,7 +3,7 @@ title: "Prompts"
 description: "Manage prompts with @arizeai/phoenix-client"
 ---
 
-The prompts module lets you create prompt versions in Phoenix, fetch them back by selector, list prompts, update a prompt's description and metadata, delete a prompt, and adapt prompt versions to supported provider SDKs.
+The prompts module lets you create prompt versions in Phoenix, fetch them back by selector, manage prompt version tags, list prompts, update a prompt's description and metadata, delete a prompt, and adapt prompt versions to supported provider SDKs.
 
 <section className="hidden" data-agent-context="relevant-source-files" aria-label="Relevant source files">
   <h2>Relevant Source Files</h2>
@@ -43,6 +43,32 @@ const prompt = await getPrompt({
 
 `prompt` can be selected by `{ name }`, `{ name, tag }`, or `{ versionId }`.
 
+## Manage Version Tags
+
+```ts
+import {
+  deletePromptVersionTag,
+  upsertPromptVersionTag,
+} from "@arizeai/phoenix-client/prompts";
+
+await upsertPromptVersionTag({
+  prompt: { versionId: "UHJvbXB0VmVyc2lvbjox" },
+  name: "production",
+  description: "Currently deployed version",
+});
+
+await deletePromptVersionTag({
+  prompt: { versionId: "UHJvbXB0VmVyc2lvbjox" },
+  name: "staging",
+});
+```
+
+Tag names are unique within a prompt, not within an individual version. Upserting a new name creates the tag on the target version. Upserting a name that already exists on another version of the same prompt moves that tag to the target version and updates its description. The same name can still be used independently by unrelated prompts.
+
+Deletion also resolves the name within the prompt identified by `prompt.versionId`; the tag can be attached to any version of that prompt.
+
+Tag upserts require Phoenix 8.22.0 or later. Tag deletion requires Phoenix 13.20.0 or later.
+
 ## Update Description And Metadata
 
 ```ts
@@ -99,9 +125,12 @@ Supported `sdk` targets:
   <ul>
     <li><code>src/prompts/createPrompt.ts</code></li>
     <li><code>src/prompts/deletePrompt.ts</code></li>
+    <li><code>src/prompts/deletePromptVersionTag.ts</code></li>
     <li><code>src/prompts/getPrompt.ts</code></li>
     <li><code>src/prompts/listPrompts.ts</code></li>
     <li><code>src/prompts/updatePrompt.ts</code></li>
+    <li><code>src/prompts/upsertPromptVersionTag.ts</code></li>
+    <li><code>src/utils/resolvePromptVersionId.ts</code></li>
     <li><code>src/prompts/sdks/toSDK.ts</code></li>
     <li><code>src/types/prompts.ts</code></li>
   </ul>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arizeai/phoenix-client",
-  "version": "7.13.0",
+  "version": "7.15.0",
   "description": "A client for the Phoenix API",
   "keywords": [
     "arize",
@@ -116,22 +116,22 @@
     "zod": "^4.6.5"
   },
   "devDependencies": {
-    "@ai-sdk/openai": "^4.0.71",
-    "@ai-sdk/otel": "^1.0.107",
+    "@ai-sdk/openai": "^4.0.78",
+    "@ai-sdk/otel": "^1.0.116",
     "@anthropic-ai/sdk": "^0.111.0",
     "@arizeai/phoenix-evals": "2.6.0",
     "@arizeai/phoenix-testing": "0.0.0",
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/sdk-trace-node": "^2.11.0",
     "@types/async": "^3.2.26",
-    "@types/node": "^26.6.2",
-    "ai": "^7.0.107",
+    "@types/node": "^26.6.3",
+    "ai": "^7.0.116",
     "dotenv": "^17.4.2",
     "jest": "^30.5.2",
     "openai": "^6.49.0",
     "openapi-typescript": "^7.13.0",
-    "tsx": "^4.23.13",
-    "vitest": "^5.0.1"
+    "tsx": "^4.23.15",
+    "vitest": "^5.0.2"
   },
   "peerDependencies": {
     "@anthropic-ai/sdk": "^0.35.0",

package/src/__generated__/api/v1.ts

@@ -2679,7 +2679,7 @@ export interface components {
             };
             /**
              * Example Ids
-             * @description Optional dataset example IDs (GlobalIDs) to seed the split with. Each example must belong to this dataset. Omit to create an empty split.
+             * @description Optional dataset example identifiers (GlobalIDs or user-provided IDs) to seed the split with. Each example must belong to this dataset. Omit to create an empty split.
              */
             example_ids?: string[];
         };
@@ -3334,6 +3334,11 @@ export interface components {
              * @description The description of the experiment
              */
             description: string | null;
+            /**
+             * Sequence Number
+             * @description The 1-based sequence number of the experiment within its dataset, in creation order.
+             */
+            sequence_number: number;
             /**
              * Repetitions
              * @description Number of times the experiment is repeated
@@ -6716,12 +6721,12 @@ export interface components {
             } | null;
             /**
              * Add Example Ids
-             * @description Dataset example IDs (GlobalIDs) to add to the split. Each example must belong to this dataset. Adding an example already in the split is a no-op.
+             * @description Dataset example identifiers (GlobalIDs or user-provided IDs) to add to the split. Each example must belong to this dataset. Adding an example already in the split is a no-op.
              */
             add_example_ids?: string[];
             /**
              * Remove Example Ids
-             * @description Dataset example IDs (GlobalIDs) to remove from the split.
+             * @description Dataset example identifiers (GlobalIDs or user-provided IDs) to remove from the split.
              */
             remove_example_ids?: string[];
         };
@@ -9383,6 +9388,10 @@ export interface operations {
                 cursor?: string | null;
                 /** @description The max number of experiments to return at a time. */
                 limit?: number;
+                /** @description Order by creation: 'desc' (default) returns newest experiments first, 'asc' returns oldest first so the lowest sequence numbers are on the first page. */
+                sort_dir?: "asc" | "desc";
+                /** @description When provided, return only the experiments with these 1-based per-dataset sequence numbers. */
+                sequence_numbers?: number[] | null;
             };
             header?: never;
             path: {
@@ -10580,10 +10589,14 @@ export interface operations {
     getSpans: {
         parameters: {
             query?: {
-                /** @description Pagination cursor (Span Global ID) */
+                /** @description Pagination cursor: the next_cursor of a previous response with the same sort */
                 cursor?: string | null;
                 /** @description Maximum number of spans to return */
                 limit?: number;
+                /** @description Sort field. 'id' orders by insertion; 'start_time' orders by when the span started, breaking ties by id. */
+                sort?: "id" | "start_time";
+                /** @description Sort direction */
+                order?: "asc" | "desc";
                 /** @description Inclusive lower bound time */
                 start_time?: string | null;
                 /** @description Exclusive upper bound time */

package/src/constants/serverRequirements.ts

@@ -147,6 +147,27 @@ export const DATASET_UPLOAD_EXAMPLE_IDS: ParameterRequirement = {
   minServerVersion: [15, 0, 0],
 };
 
+export const CREATE_DATASET_SPLIT: RouteRequirement = {
+  kind: "route",
+  method: "POST",
+  path: "/v1/datasets/{dataset_identifier}/splits",
+  minServerVersion: [19, 20, 0],
+};
+
+export const UPDATE_DATASET_SPLIT: RouteRequirement = {
+  kind: "route",
+  method: "PATCH",
+  path: "/v1/datasets/{dataset_identifier}/splits/{split_id}",
+  minServerVersion: [19, 20, 0],
+};
+
+export const DELETE_DATASET_SPLIT: RouteRequirement = {
+  kind: "route",
+  method: "DELETE",
+  path: "/v1/datasets/{dataset_identifier}/splits/{split_id}",
+  minServerVersion: [19, 20, 0],
+};
+
 export const ADD_TRACE_NOTE_IDENTIFIER: ParameterRequirement = {
   kind: "parameter",
   parameterName: "identifier",
@@ -178,6 +199,20 @@ export const DELETE_PROMPT: RouteRequirement = {
   minServerVersion: [13, 20, 0],
 };
 
+export const UPSERT_PROMPT_VERSION_TAG: RouteRequirement = {
+  kind: "route",
+  method: "POST",
+  path: "/v1/prompt_versions/{prompt_version_id}/tags",
+  minServerVersion: [8, 22, 0],
+};
+
+export const DELETE_PROMPT_VERSION_TAG: RouteRequirement = {
+  kind: "route",
+  method: "DELETE",
+  path: "/v1/prompt_versions/{prompt_version_id}/tags/{tag_name}",
+  minServerVersion: [13, 20, 0],
+};
+
 export const PATCH_PROMPT: RouteRequirement = {
   kind: "route",
   method: "PATCH",
@@ -265,10 +300,15 @@ export const ALL_REQUIREMENTS: readonly CapabilityRequirement[] = [
   LIST_SESSIONS_FILTER_EXPRESSION,
   TRANSFER_TRACES,
   DATASET_UPLOAD_EXAMPLE_IDS,
+  CREATE_DATASET_SPLIT,
+  UPDATE_DATASET_SPLIT,
+  DELETE_DATASET_SPLIT,
   ADD_TRACE_NOTE_IDENTIFIER,
   ADD_SPAN_NOTE_IDENTIFIER,
   ADD_SESSION_NOTE_IDENTIFIER,
   DELETE_PROMPT,
+  UPSERT_PROMPT_VERSION_TAG,
+  DELETE_PROMPT_VERSION_TAG,
   PATCH_PROMPT,
   AGENT_SESSION_CREATE,
   AGENT_SESSION_LIST,

package/src/datasets/createDatasetSplit.ts

@@ -0,0 +1,80 @@
+import invariant from "tiny-invariant";
+
+import type { components } from "../__generated__/api/v1";
+import { createClient } from "../client";
+import { CREATE_DATASET_SPLIT } from "../constants/serverRequirements";
+import type { ClientFn } from "../types/core";
+import type { DatasetIdentifier, DatasetSplit } from "../types/datasets";
+import { ensureServerCapability } from "../utils/serverVersionUtils";
+import { resolveDatasetIdentifier } from "./resolveDatasetIdentifier";
+
+type CreateDatasetSplitRequestBody =
+  components["schemas"]["CreateDatasetSplitRequestBody"];
+type CreateDatasetSplitResponseBody =
+  components["schemas"]["CreateDatasetSplitResponseBody"];
+
+/** Parameters for creating a dataset split. */
+export interface CreateDatasetSplitParams extends ClientFn {
+  /** The dataset, selected by name or GlobalID. */
+  dataset: DatasetIdentifier;
+  /** A unique name for the split. */
+  name: CreateDatasetSplitRequestBody["name"];
+  /** An optional description of the split. */
+  description?: CreateDatasetSplitRequestBody["description"];
+  /** An optional hex color for the split. */
+  color?: CreateDatasetSplitRequestBody["color"];
+  /** Arbitrary JSON metadata for the split. */
+  metadata?: CreateDatasetSplitRequestBody["metadata"];
+  /** Dataset example GlobalIDs or user-provided IDs with which to seed the split. */
+  exampleIds?: CreateDatasetSplitRequestBody["example_ids"];
+}
+
+/**
+ * Create a split on an existing dataset.
+ *
+ * @param params - The split to create.
+ * @param params.client - Optional Phoenix client instance.
+ * @param params.dataset - The dataset, selected by name or GlobalID.
+ * @param params.name - A unique name for the split.
+ * @param params.description - An optional description of the split.
+ * @param params.color - An optional hex color for the split.
+ * @param params.metadata - Arbitrary JSON metadata for the split.
+ * @param params.exampleIds - Dataset example GlobalIDs or user-provided IDs with which to seed the split.
+ * @returns The created dataset split.
+ * @throws {HttpError} If the dataset or an example does not exist, the name is
+ * already in use, or the request is invalid.
+ *
+ * @requires Phoenix server >= 19.20.0
+ */
+export async function createDatasetSplit({
+  client: _client,
+  dataset,
+  name,
+  description,
+  color,
+  metadata,
+  exampleIds,
+}: CreateDatasetSplitParams): Promise<DatasetSplit> {
+  const client = _client ?? createClient();
+  await ensureServerCapability({ client, requirement: CREATE_DATASET_SPLIT });
+  const datasetIdentifier = resolveDatasetIdentifier(dataset);
+
+  const body: CreateDatasetSplitRequestBody = {
+    name,
+    ...(description !== undefined ? { description } : {}),
+    ...(color !== undefined ? { color } : {}),
+    ...(metadata !== undefined ? { metadata } : {}),
+    ...(exampleIds !== undefined ? { example_ids: exampleIds } : {}),
+  };
+  const response = await client.POST(
+    "/v1/datasets/{dataset_identifier}/splits",
+    {
+      params: { path: { dataset_identifier: datasetIdentifier } },
+      body,
+    }
+  );
+  const responseBody: CreateDatasetSplitResponseBody | undefined =
+    response.data;
+  invariant(responseBody?.data, "Failed to create dataset split");
+  return responseBody.data;
+}

package/src/datasets/deleteDatasetSplit.ts

@@ -0,0 +1,46 @@
+import { createClient } from "../client";
+import { DELETE_DATASET_SPLIT } from "../constants/serverRequirements";
+import type { ClientFn } from "../types/core";
+import type { DatasetIdentifier } from "../types/datasets";
+import { ensureServerCapability } from "../utils/serverVersionUtils";
+import { resolveDatasetIdentifier } from "./resolveDatasetIdentifier";
+
+/** Parameters for deleting a dataset split. */
+export interface DeleteDatasetSplitParams extends ClientFn {
+  /** The dataset, selected by name or GlobalID. */
+  dataset: DatasetIdentifier;
+  /** The dataset split GlobalID. */
+  splitId: string;
+}
+
+/**
+ * Delete a dataset split and its memberships without deleting its examples.
+ *
+ * @param params - The split to delete.
+ * @param params.client - Optional Phoenix client instance.
+ * @param params.dataset - The dataset, selected by name or GlobalID.
+ * @param params.splitId - The dataset split GlobalID.
+ * @returns A promise that resolves once the split is deleted.
+ * @throws {HttpError} If the dataset or split does not exist, or the split ID
+ * is invalid.
+ *
+ * @requires Phoenix server >= 19.20.0
+ */
+export async function deleteDatasetSplit({
+  client: _client,
+  dataset,
+  splitId,
+}: DeleteDatasetSplitParams): Promise<void> {
+  const client = _client ?? createClient();
+  await ensureServerCapability({ client, requirement: DELETE_DATASET_SPLIT });
+  const datasetIdentifier = resolveDatasetIdentifier(dataset);
+
+  await client.DELETE("/v1/datasets/{dataset_identifier}/splits/{split_id}", {
+    params: {
+      path: {
+        dataset_identifier: datasetIdentifier,
+        split_id: splitId,
+      },
+    },
+  });
+}

package/src/datasets/index.ts

@@ -1,5 +1,9 @@
 export * from "./createDataset";
+export * from "./createDatasetSplit";
+export * from "./deleteDatasetSplit";
 export * from "./getDataset";
 export * from "./getDatasetExamples";
 export * from "./appendDatasetExamples";
 export * from "./getDatasetInfo";
+export * from "./updateDatasetSplit";
+export type { DatasetIdentifier, DatasetSplit } from "../types/datasets";

package/src/datasets/resolveDatasetIdentifier.ts

@@ -0,0 +1,6 @@
+import type { DatasetIdentifier } from "../types/datasets";
+
+/** Resolve a typed dataset selector to the REST path identifier. */
+export function resolveDatasetIdentifier(dataset: DatasetIdentifier): string {
+  return "datasetName" in dataset ? dataset.datasetName : dataset.datasetId;
+}

package/src/datasets/updateDatasetSplit.ts

@@ -0,0 +1,99 @@
+import invariant from "tiny-invariant";
+
+import type { components } from "../__generated__/api/v1";
+import { createClient } from "../client";
+import { UPDATE_DATASET_SPLIT } from "../constants/serverRequirements";
+import type { ClientFn } from "../types/core";
+import type { DatasetIdentifier, DatasetSplit } from "../types/datasets";
+import { ensureServerCapability } from "../utils/serverVersionUtils";
+import { resolveDatasetIdentifier } from "./resolveDatasetIdentifier";
+
+type UpdateDatasetSplitRequestBody =
+  components["schemas"]["UpdateDatasetSplitRequestBody"];
+type UpdateDatasetSplitResponseBody =
+  components["schemas"]["UpdateDatasetSplitResponseBody"];
+
+/** Parameters for partially updating a dataset split. */
+export interface UpdateDatasetSplitParams extends ClientFn {
+  /** The dataset, selected by name or GlobalID. */
+  dataset: DatasetIdentifier;
+  /** The dataset split GlobalID. */
+  splitId: string;
+  /** A new unique name for the split. */
+  name?: UpdateDatasetSplitRequestBody["name"];
+  /** A new description, or null to clear it. */
+  description?: UpdateDatasetSplitRequestBody["description"];
+  /** A new hex color for the split. */
+  color?: UpdateDatasetSplitRequestBody["color"];
+  /** JSON metadata that replaces the existing metadata. */
+  metadata?: UpdateDatasetSplitRequestBody["metadata"];
+  /** Dataset example GlobalIDs or user-provided IDs to add. Existing memberships are no-ops. */
+  addExampleIds?: UpdateDatasetSplitRequestBody["add_example_ids"];
+  /** Dataset example GlobalIDs or user-provided IDs to remove. Missing memberships are no-ops. */
+  removeExampleIds?: UpdateDatasetSplitRequestBody["remove_example_ids"];
+}
+
+/**
+ * Partially update a dataset split and/or its example membership.
+ *
+ * Only provided fields change. Membership additions and removals are
+ * idempotent; if an example appears in both arrays, removal wins.
+ *
+ * @param params - The split fields and memberships to update.
+ * @param params.client - Optional Phoenix client instance.
+ * @param params.dataset - The dataset, selected by name or GlobalID.
+ * @param params.splitId - The dataset split GlobalID.
+ * @param params.name - A new unique name for the split.
+ * @param params.description - A new description, or null to clear it.
+ * @param params.color - A new hex color for the split.
+ * @param params.metadata - JSON metadata that replaces the existing metadata.
+ * @param params.addExampleIds - Dataset example GlobalIDs or user-provided IDs to add.
+ * @param params.removeExampleIds - Dataset example GlobalIDs or user-provided IDs to remove.
+ * @returns The updated dataset split.
+ * @throws {HttpError} If the dataset, split, or an example does not exist, the
+ * name is already in use, or the request is invalid.
+ *
+ * @requires Phoenix server >= 19.20.0
+ */
+export async function updateDatasetSplit({
+  client: _client,
+  dataset,
+  splitId,
+  name,
+  description,
+  color,
+  metadata,
+  addExampleIds,
+  removeExampleIds,
+}: UpdateDatasetSplitParams): Promise<DatasetSplit> {
+  const client = _client ?? createClient();
+  await ensureServerCapability({ client, requirement: UPDATE_DATASET_SPLIT });
+  const datasetIdentifier = resolveDatasetIdentifier(dataset);
+
+  const body: UpdateDatasetSplitRequestBody = {
+    ...(name !== undefined ? { name } : {}),
+    ...(description !== undefined ? { description } : {}),
+    ...(color !== undefined ? { color } : {}),
+    ...(metadata !== undefined ? { metadata } : {}),
+    ...(addExampleIds !== undefined ? { add_example_ids: addExampleIds } : {}),
+    ...(removeExampleIds !== undefined
+      ? { remove_example_ids: removeExampleIds }
+      : {}),
+  };
+  const response = await client.PATCH(
+    "/v1/datasets/{dataset_identifier}/splits/{split_id}",
+    {
+      params: {
+        path: {
+          dataset_identifier: datasetIdentifier,
+          split_id: splitId,
+        },
+      },
+      body,
+    }
+  );
+  const responseBody: UpdateDatasetSplitResponseBody | undefined =
+    response.data;
+  invariant(responseBody?.data, "Failed to update dataset split");
+  return responseBody.data;
+}

package/src/prompts/deletePromptVersionTag.ts

@@ -0,0 +1,64 @@
+import { createClient } from "../client";
+import { DELETE_PROMPT_VERSION_TAG } from "../constants/serverRequirements";
+import type { ClientFn } from "../types/core";
+import type { GetPromptByVersionSelector } from "../types/prompts";
+import { resolvePromptVersionId } from "../utils/resolvePromptVersionId";
+import { ensureServerCapability } from "../utils/serverVersionUtils";
+
+/**
+ * Parameters for deleting a prompt version tag.
+ */
+export interface DeletePromptVersionTagParams extends ClientFn {
+  /** A version belonging to the prompt that owns the tag. */
+  prompt: GetPromptByVersionSelector;
+  /** The prompt-scoped tag name to delete. */
+  name: string;
+}
+
+/**
+ * Delete a tag from the prompt that owns the given prompt version.
+ *
+ * Tag names are unique within a prompt, so `name` identifies the tag across
+ * all versions of that prompt. The tag does not need to be attached to the
+ * selected version.
+ *
+ * @param params - The prompt version tag to delete.
+ * @param params.prompt - A version selector used to identify the prompt.
+ * @param params.name - The prompt-scoped tag name to delete.
+ * @returns A promise that resolves once the tag has been deleted.
+ * @throws {@link HttpError} when Phoenix rejects the request.
+ *
+ * @example
+ * ```ts
+ * import { deletePromptVersionTag } from "@arizeai/phoenix-client/prompts";
+ *
+ * await deletePromptVersionTag({
+ *   prompt: { versionId: "UHJvbXB0VmVyc2lvbjox" },
+ *   name: "production",
+ * });
+ * ```
+ */
+export async function deletePromptVersionTag({
+  client: _client,
+  prompt,
+  name,
+}: DeletePromptVersionTagParams): Promise<void> {
+  const promptVersionId = resolvePromptVersionId(prompt);
+  const client = _client ?? createClient();
+  await ensureServerCapability({
+    client,
+    requirement: DELETE_PROMPT_VERSION_TAG,
+  });
+
+  await client.DELETE(
+    "/v1/prompt_versions/{prompt_version_id}/tags/{tag_name}",
+    {
+      params: {
+        path: {
+          prompt_version_id: promptVersionId,
+          tag_name: name,
+        },
+      },
+    }
+  );
+}

package/src/prompts/index.ts

@@ -1,6 +1,8 @@
 export * from "./getPrompt";
 export * from "./createPrompt";
 export * from "./deletePrompt";
+export * from "./deletePromptVersionTag";
 export * from "./listPrompts";
+export * from "./upsertPromptVersionTag";
 export * from "./updatePrompt";
 export * from "./sdks";