@arizeai/phoenix-client/dist/esm/spans/addSpanNote.js

A client for the Phoenix API

import { createClient } from "../client.js";
/**
 * Add a note to a span.
 *
 * Notes are a special type of annotation that allow multiple entries per span
 * (unlike regular annotations which are unique by name and identifier).
 * Each note gets a unique timestamp-based identifier.
 *
 * @param params - The parameters to add a span note
 * @returns The ID of the created note annotation
 *
 * @example
 * ```ts
 * const result = await addSpanNote({
 *   spanNote: {
 *     spanId: "123abc",
 *     note: "This span looks suspicious, needs review"
 *   }
 * });
 * ```
 */
export async function addSpanNote({ client: _client, spanNote, }) {
    const client = _client ?? createClient();
    const { data, error } = await client.POST("/v1/span_notes", {
        body: {
            data: {
                span_id: spanNote.spanId.trim(),
                note: spanNote.note,
            },
        },
    });
    if (error) {
        throw new Error(`Failed to add span note: ${error}`);
    }
    if (!data?.data) {
        throw new Error("Failed to add span note: no data returned");
    }
    return data.data;
}
//# sourceMappingURL=addSpanNote.js.map