The Langfuse connector lets your AI agent work with Langfuse. Scalekit handles authentication for every call, so your agent never handles credentials. It comes with 58 tools.
- Tools
- 58
- What they doRead · write · destructive
- 32 · 16 · 1032 read16 write10 destructive
- Users sign in with
- Username and password
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Langfuse connection
In AgentKit > Connections, create a Langfuse connection. The name you give it is the
connection_nameyour code passes. See Configure connections.
Tools
Pass the exact name toexecute_toollangfuse_annotation_queue_getGet one annotation queue.Read-onlyGet Annotation Queue
Get one annotation queue. Returns its name, description and score configs.
Inputs
queue_idstringrequired- ID of the annotation queue. Get it from langfuse_annotation_queues_list. Example: cm1q2w3e4r5t6y7u8i9o0p.
langfuse_annotation_queue_item_getGet one item of an annotation queue.Read-onlyGet Annotation Queue Item
Get one item of an annotation queue. Returns the item's object, status and completion info.
Inputs
item_idstringrequired- ID of the queue item. Example: cm2a3s4d5f6g7h8j9k0l1z.
queue_idstringrequired- ID of the annotation queue. Get it from langfuse_annotation_queues_list. Example: cm1q2w3e4r5t6y7u8i9o0p.
langfuse_annotation_queue_items_listList the items in an annotation queue, optionally by status, with paging.Read-onlyList Annotation Queue Items
List the items in an annotation queue, optionally by status, with paging. Returns each item's ID, object (trace, observation or session), status and timestamps.
Inputs
queue_idstringrequired- ID of the annotation queue. Get it from langfuse_annotation_queues_list. Example: cm1q2w3e4r5t6y7u8i9o0p.
limitinteger- Items per page. Example: 50.
pageinteger- Page number, starting at 1. Example: 1.
statusstring- Filter by status. Example: PENDING.one of
PENDINGCOMPLETED
langfuse_annotation_queues_listList annotation queues, with paging.Read-onlyList Annotation Queues
List annotation queues, with paging. Returns each queue's ID, name, description and score configs.
Inputs
limitinteger- Items per page. Example: 50.
pageinteger- Page number, starting at 1. Example: 1.
langfuse_comment_getGet one comment.Read-onlyGet Comment
Get one comment. Returns its object, content, author and time.
Inputs
comment_idstringrequired- The unique langfuse identifier of a comment. Example: cm3x4c5v6b7n8m9q0w1e2r.
langfuse_comments_listList comments, optionally on one object, with paging.Read-onlyList Comments
List comments, optionally on one object, with paging. Returns each comment's ID, object, content, author and time.
Inputs
author_user_idstring- Filter comments by author user id. Example: user-1.
limitinteger- Items per page. Example: 50.
object_idstring- Filter comments by object id. If objectType is not provided, an error will be thrown. Example: 4bf92f3577b34da6a3ce929d0e0e4736.
object_typestring- Filter comments by object type (trace, observation, session, prompt). Example: TRACE.
pageinteger- Page number, starting at 1. Example: 1.
langfuse_dataset_getGet one dataset by name.Read-onlyGet Dataset
Get one dataset by name. Returns the dataset's ID, description and metadata.
Inputs
dataset_namestringrequired- Dataset Name. Example: golden-qa.
langfuse_dataset_item_getGet one dataset item.Read-onlyGet Dataset Item
Get one dataset item. Returns its input, expected output, metadata, status and source.
Inputs
dataset_item_idstringrequired- ID of the dataset item. Example: item-001.
langfuse_dataset_items_listList dataset items, optionally for one dataset or source trace, with paging.Read-onlyList Dataset Items
List dataset items, optionally for one dataset or source trace, with paging. Returns each item's ID, input, expected output, metadata and status.
Inputs
dataset_namestring- Dataset Name. Example: golden-qa.
limitinteger- Items per page. Example: 50.
pageinteger- Page number, starting at 1. Example: 1.
source_observation_idstring- Source Observation ID. Example: obs-1.
source_trace_idstring- Source Trace ID. Example: 4bf92f3577b34da6a3ce929d0e0e4736.
versionstring- ISO 8601 timestamp (RFC 3339, Section 5.6) in UTC (e.g., "2026-01-21T14:35:42Z"). If provided, returns state of dataset at this timestamp. If not provided, returns the latest version. Requires datasetName to be specified. Example: 2026-05-01T00:00:00Z.
langfuse_datasets_listList datasets in the project, with paging.Read-onlyList Datasets
List datasets in the project, with paging. Returns each dataset's ID, name, description and metadata.
Inputs
limitinteger- Items per page. Example: 50.
pageinteger- Page number, starting at 1. Example: 1.
langfuse_evaluation_rule_getGet one evaluation rule.Read-onlyGet Evaluation Rule
Get one evaluation rule. Returns its name, target, filter, sampling and evaluator assignments.
Inputs
evaluation_rule_idstringrequired- Stable evaluation-rule identifier returned by the evaluation-rule endpoints. Example: cm6n7m8q9w0e1r2t3y4u5i.
langfuse_evaluation_rules_listList evaluation rules, which run evaluators on new traces or dataset runs.Read-onlyList Evaluation Rules
List evaluation rules, which run evaluators on new traces or dataset runs. Returns each rule's ID, name, enabled flag, sampling, filter and evaluators.
Inputs
cursorstring- Cursor from the previous response's meta, for the next page. Example: eyJ0IjoxfQ.
limitinteger- Items per page. Example: 50.
langfuse_evaluator_getGet one evaluator.Read-onlyGet Evaluator
Get one evaluator. Returns its name, type, prompt or code, model config and output definition.
Inputs
evaluator_idstringrequired- Stable evaluator identifier returned by the evaluator endpoints. Example: cm7o8p9a0s1d2f3g4h5j6k.
langfuse_evaluator_versions_listList an evaluator's version history, newest first.Read-onlyList Evaluator Versions
List an evaluator's version history, newest first. Returns each version's number and definition.
Inputs
evaluator_idstringrequired- Stable evaluator identifier returned by the evaluator endpoints. Example: cm7o8p9a0s1d2f3g4h5j6k.
cursorstring- Cursor from the previous response's meta, for the next page. Example: eyJ0IjoxfQ.
limitinteger- Items per page. Example: 50.
langfuse_evaluators_listList evaluators (LLM-as-a-judge and code evaluators) in the project.Read-onlyList Evaluators
List evaluators (LLM-as-a-judge and code evaluators) in the project. Returns each evaluator's ID, name, type and latest version.
Inputs
cursorstring- Cursor from the previous response's meta, for the next page. Example: eyJ0IjoxfQ.
limitinteger- Items per page. Example: 50.
langfuse_experiment_items_listList the items of experiments with cursor paging.Read-onlyList Experiment Items
List the items of experiments with cursor paging. Returns each item's experiment, dataset item, trace and observation.
Inputs
from_start_timestringrequired- Required. Retrieve only experiment items started on or after this datetime. A lower bound is required so the query stays fast on large projects; pair it with an upper bound to select a specific window. Example: 2026-01-01T00:00:00Z.
cursorstring- Cursor from the previous response's meta, for the next page. Example: eyJ0IjoxfQ.
dataset_idstring- Comma-separated list of dataset IDs. Example: 1234567890.
experiment_idstring- Comma-separated list of experiment IDs. Example: 1234567890.
experiment_item_idstring- Comma-separated list of experiment item IDs. Example: 1234567890.
experiment_namestring- Comma-separated list of experiment names. Example: example.
fieldsstring- Comma-separated list of field groups to include. Available groups: `core`, `dataset`, `io`, `metadata`, `itemMetadata`, `experimentMetadata`, `scores`. If omitted, `core,dataset` is returned. Example: example.
filterstring- JSON string containing an array of structured filter conditions. Supported columns are `experimentId`, `experimentName`, `experimentItemId`, and `datasetId`. Example: example.
limitinteger- Items per page. Example: 50.
score_limitinteger- Number of scores to return per experiment item when `fields=scores` is requested. Maximum 50, default 50. Example: 1.
to_start_timestring- Retrieve only experiment items started before this datetime. Example: 2026-01-01T00:00:00Z.
langfuse_experiments_listList experiments (dataset runs) with cursor paging.Read-onlyList Experiments
List experiments (dataset runs) with cursor paging. Returns each experiment's ID, name, dataset, metadata and timestamps.
Inputs
from_start_timestringrequired- Required. Retrieve only experiments with events on or after this datetime. A lower bound is required so the query stays fast on large projects; pair it with an upper bound to select a specific window. Example: 2026-01-01T00:00:00Z.
cursorstring- Cursor from the previous response's meta, for the next page. Example: eyJ0IjoxfQ.
dataset_idstring- Comma-separated list of dataset IDs. Example: 1234567890.
fieldsstring- Comma-separated list of field groups to include. Available groups: `core`, `metadata`, `scores`. If omitted, `core` is returned. Example: example.
filterstring- JSON string containing an array of structured filter conditions. Supported columns are `id`, `name`, and `datasetId`. Example: example.
idstring- Comma-separated list of experiment IDs. Example: 1234567890.
limitinteger- Items per page. Example: 50.
namestring- Comma-separated list of experiment names. Example: support-answer.
score_limitinteger- Number of scores to return per experiment when `fields=scores` is requested. Maximum 50, default 50. Example: 1.
to_start_timestring- Retrieve only experiments before this datetime. Example: 2026-01-01T00:00:00Z.
langfuse_health_checkCheck that the Langfuse API and its database are up.Read-onlyCheck API Health
Check that the Langfuse API and its database are up. Returns the status and version. Run it to confirm the host and keys.
Inputs
This tool takes no inputs.
langfuse_llm_connections_listList the project's LLM provider connections used by evaluators and the playground.Read-onlyList LLM Connections
List the project's LLM provider connections used by evaluators and the playground. Returns each connection's ID, provider, adapter and models (no secret keys).
Inputs
limitinteger- Items per page. Example: 50.
pageinteger- Page number, starting at 1. Example: 1.
langfuse_media_getGet a media record attached to a trace or observation.Read-onlyGet Media
Get a media record attached to a trace or observation. Returns its content type, size and a temporary download URL.
Inputs
media_idstringrequired- The unique langfuse identifier of a media record. Example: cm8l9z0x1c2v3b4n5m6q7w.
langfuse_metrics_queryRun an aggregate metrics query over traces, observations or scores: counts, latency, tokens and cost, grouped by dimensions and time.Read-onlyQuery Metrics
Run an aggregate metrics query over traces, observations or scores: counts, latency, tokens and cost, grouped by dimensions and time. Returns the result rows. Use it for usage and cost reports.
Inputs
querystringrequired- The query as a JSON string with view (traces, observations, scores-numeric, scores-categorical), metrics, dimensions, filters, timeDimension, fromTimestamp and toTimestamp. Example: {"view": "observations", "metrics": [{"measure": "totalCost", "aggregation": "sum"}], "dimensions": [{"field": "providedModelName"}], "filters": [], "fromTimestamp": "2026-05-01T00:00:00Z", "toTimestamp": "2026-05-31T23:59:59Z"}.
langfuse_model_getGet one model definition.Read-onlyGet Model
Get one model definition. Returns its name, match pattern, unit, prices and tokenizer.
Inputs
model_idstringrequired- ID of the model. Get it from langfuse_models_list. Example: cm0q1w2e3r4t5y6u7i8o9p.
langfuse_models_listList model definitions used for token and cost tracking, with paging.Read-onlyList Models
List model definitions used for token and cost tracking, with paging. Returns each model's ID, name, match pattern, prices and tokenizer.
Inputs
limitinteger- Items per page. Example: 50.
pageinteger- Page number, starting at 1. Example: 1.
langfuse_observations_listList observations (spans, generations and events) with filters by trace, session, user, name, type, level, environment and start time, with cursor paging.Read-onlyList Observations
List observations (spans, generations and events) with filters by trace, session, user, name, type, level, environment and start time, with cursor paging. Returns each observation's IDs, type, name, timing, model, usage, cost, level and, if requested, input and output. Use it to inspect traces and LLM calls.
Inputs
cursorstring- Cursor from the previous response's meta, for the next page. Example: eyJ0IjoxfQ.
environmentarray- Optional filter for observations where the environment is one of the provided values. Example: ["production"].
expand_metadatastring- Comma-separated list of metadata keys to return non-truncated. By default, metadata values over 200 characters are truncated. Use this parameter to retrieve full values for specific keys. Example: "key1,key2".
fieldsstring- Comma-separated list of field groups to include in the response. Available groups: core, basic, time, io, metadata, model, usage, prompt, metrics, trace_context. If not specified, `core` and `basic` field groups are returned. Example: "basic,usage,model".
filterstring- JSON string containing an array of filter conditions. A condition on the same field as a query parameter filter (userId, name, type, level, environment, fromStartTime, .) replaces that parameter. Query parameters for other fields still apply. A `startTime` condition replaces both `fromStartTime` and `toStartTime`. ## Filter Structure Each filter condition has the following structure: ```json [ { "type": string, // Required. One of: "datetime", "string", "number", "stringOptions", "arrayOptions", "stringObject", "boolean", "null" "column": string, // Required. Column to filter on (see available columns below) "operator": string, // Required. Operator based on type: // - datetime: ">", "<", ">=", "<=" // - string: "=", "contains", "does not contain", "starts with", "ends with", "is not empty", "matches" (input/output only) // - stringOptions: "any of", "none of" (works on any string column except input/output) // - arrayOptions: "any of", "none of", "all of" // - number: "=", ">", "<", ">=", "<=" // - stringObject: "=", "contains", "does not contain", "starts with", "ends with", "matches", "is set", "is not set" // - boolean: "=", "<>" // - null: "is null", "is not null" "value": any, // Required. Type depends on filter type: ISO 8601 string for datetime, JSON number for number (not a numeric string), array of strings for stringOptions/arrayOptions, boolean for boolean, and "" (empty string) for null "key": string // Required only for stringObject (the metadata key to filter on) } ] ``` ## Available Columns ### Core Observation Fields - `id` (string) - Observation ID - `type` (string) - Observation type (SPAN, GENERATION, EVENT) - `name` (string) - Observation name - `traceId` (string) - Associated trace ID - `startTime` (datetime) - Observation start time - `endTime` (datetime) - Observation end time - `environment` (string) - Environment tag - `level` (string) - Log level (DEBUG, DEFAULT, WARNING, ERROR) - `statusMessage` (string) - Status message - `version` (string) - Version tag - `userId` (string) - User ID - `sessionId` (string) - Session ID - `isRootObservation` (boolean) - Whether the observation is a logical root. Observations marked as app roots by the SDK may retain a non-null parentObservationId. ### Trace-Related Fields - `traceName` (string) - Name of the parent trace - `traceTags` (arrayOptions) - Tags from the parent trace - `tags` (arrayOptions) - Alias for traceTags ### Performance Metrics - `latency` (number) - Latency in seconds (calculated: end_time - start_time) - `timeToFirstToken` (number) - Time to first token in seconds - `tokensPerSecond` (number) - Output tokens per second ### Token Usage - `inputTokens` (number) - Number of input tokens - `outputTokens` (number) - Number of output tokens - `totalTokens` (number) - Total tokens (alias: `tokens`) ### Cost Metrics - `inputCost` (number) - Input cost in USD - `outputCost` (number) - Output cost in USD - `totalCost` (number) - Total cost in USD ### Model Information - `model` (string) - Provided model name (alias: `providedModelName`) - `promptName` (string) - Associated prompt name - `promptVersion` (number) - Associated prompt version ### Structured Data - `input` (string) - Observation input. Supports accelerated indexed literal search with the `matches` operator. - `output` (string) - Observation output. Supports accelerated indexed literal search with the `matches` operator. - `metadata` (stringObject) - Metadata key-value pairs. Use the `key` parameter to filter on a specific metadata key. Metadata values are stored as strings, so match numbers and booleans by their string form with `=` (for example `"value": "true"` or `"value": "42"`); numeric comparisons such as `>` are not supported on metadata. The `matches` operator is only supported for `input`, `output`, and stringObject `metadata` filters. It performs indexed literal search with token-boundary pruning using the events table text indexes. Case sensitivity differs by target: `input` and `output` matches are case-insensitive, while metadata value matches are case-sensitive. Unlike SQL `LIKE`, `%` and `_` are treated as literal characters. Use `contains` for legacy substring semantics where the API allows it. Any v2 `input` or `output` filter must be accompanied by at least one `=` or `matches` filter on `input` or `output`; standalone `contains`, `starts with`, `ends with`, and `does not contain` filters on these columns are rejected. ## Filter Examples ```json [ { "type": "string", "column": "type", "operator": "=", "value": "GENERATION" }, { "type": "number", "column": "latency", "operator": ">=", "value": 2.5 }, { "type": "stringObject", "column": "metadata", "key": "environment", "operator": "=", "value": "production" }, { "type": "string", "column": "output", "operator": "matches", "value": "needle" }, { "type": "boolean", "column": "isRootObservation", "operator": "=", "value": true } ] ```. Example: [{"type": "string", "column": "name", "operator": "=", "value": "chat-completion"}].
from_start_timestring- Retrieve only observations with a start_time on or after this datetime (ISO 8601). Example: 2026-05-01T00:00:00Z.
is_root_observationboolean- Filter by whether an observation is a logical root. Root observations include observations without a physical parent and observations marked as app roots by the SDK. An app-root observation may have `isRootObservation=true` and a non-null `parentObservationId`. Example: true.
levelstring- Optional filter for observations with a specific level (e.g. "DEBUG", "DEFAULT", "WARNING", "ERROR"). Example: ERROR.one of
DEBUGDEFAULTWARNINGERROR limitinteger- Items per page. Example: 50.
namestring- Name. Example: chat-completion.
parent_observation_idstring- Filter by the physical parent observation ID. An empty value matches only observations without a physical parent. Use `isRootObservation` to include observations marked as app roots by the SDK, which may retain a non-null `parentObservationId`. Example: obs-1.
parse_io_as_jsonboolean- **Deprecated.** Setting this to `true` will return a 400 error. Input/output fields are always returned as raw strings. Remove this parameter or set it to `false`. Example: false.
session_idstring- Filter by session ID. Example: session-abc.
to_start_timestring- Retrieve only observations with a start_time before this datetime (ISO 8601). Example: 2026-05-31T23:59:59Z.
trace_idstring- Trace ID. Example: 4bf92f3577b34da6a3ce929d0e0e4736.
typestring- Filter by observation type (e.g., "GENERATION", "SPAN", "EVENT", "AGENT", "TOOL", "CHAIN", "RETRIEVER", "EVALUATOR", "EMBEDDING", "GUARDRAIL"). Example: GENERATION.
user_idstring- User ID. Example: user-123.
versionstring- Optional filter to only include observations with a certain version. Example: 1.0.0.
langfuse_project_getGet the project the API keys belong to.Read-onlyGet Project
Get the project the API keys belong to. Returns the project's ID, name and settings. Use the ID where tools ask for a project_id.
Inputs
This tool takes no inputs.
langfuse_prompt_getGet a prompt by name, at a version or label (production by default).Read-onlyGet Prompt
Get a prompt by name, at a version or label (production by default). Returns the prompt text or chat messages, config, version, labels and tags.
Inputs
prompt_namestringrequired- The name of the prompt. If the prompt is in a folder (e.g., "folder/subfolder/prompt-name"), the folder path must be URL encoded. Example: support-answer.
labelstring- Label of the prompt to be retrieved. Defaults to "production" if no label or version is set. Example: production.
resolveboolean- Resolve prompt dependencies before returning the prompt. Defaults to `true`. Set to `false` to return the raw stored prompt with dependency tags intact. This bypasses prompt caching and is intended for debugging or one-off jobs, not production runtime fetches. Example: true.
versioninteger- Version of the prompt to be retrieved. Example: 3.
langfuse_prompts_listList prompts with their versions, labels and tags, with filters and paging.Read-onlyList Prompts
List prompts with their versions, labels and tags, with filters and paging. Returns each prompt's name, versions, labels, tags and last update. Use langfuse_prompt_get for a prompt's content.
Inputs
from_updated_atstring- Optional filter to only include prompt versions created/updated on or after a certain datetime (ISO 8601). Example: 2026-05-01T00:00:00Z.
labelstring- Label. Example: production.
limitinteger- Items per page. Example: 50.
namestring- Name. Example: support-answer.
pageinteger- Page number, starting at 1. Example: 1.
tagstring- Tag. Example: support.
to_updated_atstring- Optional filter to only include prompt versions created/updated before a certain datetime (ISO 8601). Example: 2026-05-31T23:59:59Z.
langfuse_score_config_getGet one score configuration.Read-onlyGet Score Config
Get one score configuration. Returns its name, data type, range or categories and description.
Inputs
config_idstringrequired- The unique langfuse identifier of a score config. Example: cm4t5y6u7i8o9p0a1s2d3f.
langfuse_score_configs_listList score configurations, which define the name, data type and allowed values of scores.Read-onlyList Score Configs
List score configurations, which define the name, data type and allowed values of scores. Returns each config's ID, name, data type, range or categories.
Inputs
limitinteger- Items per page. Example: 50.
pageinteger- Page number, starting at 1. Example: 1.
langfuse_scores_listList scores with filters by name, source, data type, trace, session, observation, queue, value range and time, with cursor paging.Read-onlyList Scores
List scores with filters by name, source, data type, trace, session, observation, queue, value range and time, with cursor paging. Returns each score's ID, name, value, data type, source, comment and target.
Inputs
author_user_idstring- Comma-separated list of author user IDs to filter by. Example: user-1.
config_idstring- Comma-separated list of score config IDs to filter by. Example: cm4t5y6u7i8o9p0a1s2d3f.
cursorstring- Cursor from the previous response's meta, for the next page. Example: eyJ0IjoxfQ.
data_typestring- Comma-separated list of data types to filter by (NUMERIC, BOOLEAN, CATEGORICAL, TEXT, CORRECTION). Case-insensitive — `numeric` and `NUMERIC` are equivalent. Must be a single value when used with value, valueMin, or valueMax; otherwise the request returns HTTP 400. Must be NUMERIC when used with valueMin or valueMax. Example: NUMERIC.
environmentstring- Comma-separated list of environments to filter by. Example: production.
experiment_idstring- Comma-separated list of dataset run IDs (experiment IDs) to filter by. Mutually exclusive with traceId, sessionId, observationId. Example: exp-1.
fieldsstring- Comma-separated field groups to include in addition to the always-returned core fields. Allowed: details, subject, annotation — see the endpoint description for the fields each group adds. Unknown names return HTTP 400. Example: core.
from_timestampstring- Inclusive lower bound on the score timestamp. Example: 2026-05-01T00:00:00Z.
idstring- Comma-separated list of score IDs to filter by (OR within, AND across filters). Example: cm5g6h7j8k9l0z1x2c3v4b.
limitinteger- Items per page. Example: 50.
namestring- Comma-separated list of score names to filter by. Example: helpfulness.
observation_idstring- Comma-separated list of observation IDs to filter by. Requires traceId to be specified, because observation IDs are scoped to a trace. Mutually exclusive with sessionId, experimentId. Returns HTTP 400 when used without traceId. Example: obs-1.
queue_idstring- ID of the annotation queue. Get it from langfuse_annotation_queues_list. Example: cm1q2w3e4r5t6y7u8i9o0p.
session_idstring- Comma-separated list of session IDs to filter by. Mutually exclusive with traceId, observationId, experimentId. Example: session-abc.
sourcestring- Comma-separated list of score sources to filter by (e.g. API, ANNOTATION, EVAL). Case-insensitive — `api` and `API` are equivalent. Example: API.
to_timestampstring- Exclusive upper bound on the score timestamp. Example: 2026-05-31T23:59:59Z.
trace_idstring- Comma-separated list of trace IDs to filter by. Mutually exclusive with sessionId, experimentId. May be combined with observationId to scope the observation lookup to a specific trace. Example: 4bf92f3577b34da6a3ce929d0e0e4736.
valuestring- Comma-separated list of exact values to filter by. Requires a single dataType from NUMERIC, BOOLEAN, or CATEGORICAL; any other dataType, multiple dataTypes, or omitting dataType returns HTTP 400. For BOOLEAN, each value must be "true" or "false"; for NUMERIC, each value must be a finite number. Otherwise the request returns HTTP 400. Example: 1.
value_maxnumber- Inclusive upper bound on the numeric value. Requires dataType=NUMERIC as a single value; otherwise the request returns HTTP 400. Example: 1.
value_minnumber- Inclusive lower bound on the numeric value. Requires dataType=NUMERIC as a single value; otherwise the request returns HTTP 400. Example: 0.
langfuse_skill_getGet a skill's metadata and file manifest at a version or label.Read-onlyGet Skill
Get a skill's metadata and file manifest at a version or label. Returns the skill version and its files.
Inputs
skill_namestringrequired- Skill Name. Example: summarize-ticket.
include_contentboolean- Include UTF-8 text content in each file. Defaults to false. Example: true.
labelstring- Label. Example: example.
versioninteger- Version. Example: 3.
langfuse_skills_listList skills with their latest version metadata.Read-onlyList Skills
List skills with their latest version metadata. Returns each skill's name, tags, labels and timestamps.
Inputs
from_updated_atstring- Include skills whose latest version was updated at or after this timestamp. Example: 2026-01-01T00:00:00Z.
limitinteger- Items per page. Example: 50.
namestring- Filter by exact skill name. Example: support-answer.
pageinteger- Page number, starting at 1. Example: 1.
searchstring- Case-insensitive search across skill names and latest-version descriptions. Example: example.
tagstring- Filter by a shared skill tag. Example: example.
to_updated_atstring- Include skills whose latest version was updated before this timestamp. Example: 2026-01-01T00:00:00Z.
langfuse_annotation_queue_assignment_createAssign a user to an annotation queue.WriteAssign User to Queue
Assign a user to an annotation queue. Returns the assignment.
Inputs
queue_idstringrequired- ID of the annotation queue. Get it from langfuse_annotation_queues_list. Example: cm1q2w3e4r5t6y7u8i9o0p.
user_idstringrequired- Langfuse user ID to assign. Example: user-1.
langfuse_annotation_queue_createCreate an annotation queue for human review.WriteCreate Annotation Queue
Create an annotation queue for human review. Returns the new queue.
Inputs
namestringrequired- Name. Example: Support review.
score_config_idsarrayrequired- Score Config IDs. Example: ["cm4t5y6u7i8o9p0a1s2d3f"].
descriptionstring- Description. Example: Review flagged answers.
langfuse_annotation_queue_item_addAdd a trace, observation or session to an annotation queue for review.WriteAdd Annotation Queue Item
Add a trace, observation or session to an annotation queue for review. Returns the new queue item.
Inputs
object_idstringrequired- Object ID. Example: 4bf92f3577b34da6a3ce929d0e0e4736.
object_typestringrequired- Object Type. Example: TRACE.one of
TRACEOBSERVATIONSESSION queue_idstringrequired- ID of the annotation queue. Get it from langfuse_annotation_queues_list. Example: cm1q2w3e4r5t6y7u8i9o0p.
statusstring- Defaults to PENDING for new queue items. Example: PENDING.one of
PENDINGCOMPLETED
langfuse_annotation_queue_item_updateChange the status of an annotation queue item, for example to COMPLETED.WriteUpdate Annotation Queue Item
Change the status of an annotation queue item, for example to COMPLETED. Returns the updated item.
- Idempotent
Inputs
item_idstringrequired- ID of the queue item. Example: cm2a3s4d5f6g7h8j9k0l1z.
queue_idstringrequired- ID of the annotation queue. Get it from langfuse_annotation_queues_list. Example: cm1q2w3e4r5t6y7u8i9o0p.
statusstring- Status. Example: COMPLETED.one of
PENDINGCOMPLETED
langfuse_comment_createComment on a trace, observation, session or prompt.WriteCreate Comment
Comment on a trace, observation, session or prompt. Returns the new comment's ID.
Inputs
contentstringrequired- The content of the comment. May include markdown. Currently limited to 5000 characters. Example: Hallucinated the refund policy.
object_idstringrequired- The id of the object to attach the comment to. If this does not reference a valid existing object, an error will be thrown. Example: 4bf92f3577b34da6a3ce929d0e0e4736.
object_typestringrequired- The type of the object to attach the comment to (trace, observation, session, prompt). Example: TRACE.
project_idstringrequired- ID of the project. Get it from langfuse_project_get. Example: cm9p0o1i2u3y4t5r6e7w8q.
author_user_idstring- The id of the user who created the comment. Must be a member of the organization that owns the project, otherwise an error will be thrown. Example: user-1.
langfuse_dataset_createCreate a dataset for evaluations and experiments.WriteCreate Dataset
Create a dataset for evaluations and experiments. Returns the new dataset.
Inputs
namestringrequired- Name. Example: golden-qa.
descriptionstring- Description. Example: Golden questions for the support bot.
expected_output_schemaobject- JSON Schema for validating dataset item expected outputs. When set, all new and existing dataset items will be validated against this schema. Example: {"type": "object"}.
input_schemaobject- JSON Schema for validating dataset item inputs. When set, all new and existing dataset items will be validated against this schema. Example: {"type": "object"}.
metadataobject- Metadata. Example: {"owner": "ml-team"}.
langfuse_dataset_item_createAdd an item to a dataset, or update it when the id already exists.WriteCreate Dataset Item
Add an item to a dataset, or update it when the id already exists. Returns the item.
Inputs
dataset_namestringrequired- Dataset Name. Example: golden-qa.
expected_outputobject- Expected output; any JSON value. Example: {"answer": "Use the Forgot password link."}.
idstring- Dataset items are upserted on their id. Id needs to be unique (project-level), cannot be reused across datasets, and must be at most 255 characters. Example: item-001.
inputobject- Input of the item; any JSON value. Example: {"question": "How do I reset my password?"}.
metadataobject- Any JSON metadata. Example: {"source": "support"}.
source_observation_idstring- Source Observation ID. Example: obs-1.
source_trace_idstring- Source Trace ID. Example: 4bf92f3577b34da6a3ce929d0e0e4736.
statusstring- Defaults to ACTIVE for newly created items. Example: ACTIVE.one of
ACTIVEARCHIVED
langfuse_evaluation_rule_createCreate an evaluation rule that runs evaluators on matching new data.WriteCreate Evaluation Rule
Create an evaluation rule that runs evaluators on matching new data. Returns the new rule.
Inputs
enabledbooleanrequired- Whether live execution should start immediately. Enabled rules require at least one evaluator assignment. Example: true.
evaluator_assignmentsarrayrequired- Evaluators to attach to this rule. Disabled rules may use an empty list as a draft. Example: [{"evaluatorId": "cm7o8p9a0s1d2f3g4h5j6k"}].
namestringrequired- Human-readable rule name. Names are not identifiers and do not need to be unique. Example: Helpfulness on prod.
filterarray- Conditions used to select observations. Defaults to an empty list, which matches every incoming observation. Example: [].
samplingnumber- Fraction of matching observations to evaluate. Omit this field to use the default of `1`, which evaluates every match. `null` is not accepted. Example: 0.1.
langfuse_evaluation_rule_updateUpdate an evaluation rule's name, enabled flag, sampling, filter or evaluators.WriteUpdate Evaluation Rule
Update an evaluation rule's name, enabled flag, sampling, filter or evaluators. Returns the updated rule.
- Idempotent
Inputs
evaluation_rule_idstringrequired- Stable evaluation-rule identifier returned by the evaluation-rule endpoints. Example: cm6n7m8q9w0e1r2t3y4u5i.
enabledboolean- New desired live-execution state. Example: false.
evaluator_assignmentsarray- Complete replacement assignment list. An empty list disables the rule. Example: [{"evaluatorId": "cm7o8p9a0s1d2f3g4h5j6k"}].
filterarray- Complete replacement filter list. An empty list matches every incoming observation. Example: [].
namestring- New human-readable rule name. Example: Helpfulness on prod.
samplingnumber- New fraction of matching observations to evaluate. Omit to keep the current value. Example: 0.1.
langfuse_model_createCreate a custom model definition so Langfuse can compute cost for its generations.WriteCreate Model
Create a custom model definition so Langfuse can compute cost for its generations. Returns the new model.
Inputs
match_patternstringrequired- Regex pattern which matches this model definition to generation.model. Useful in case of fine-tuned models. If you want to exact match, use `(?i)^modelname$`. Example: (?i)^(my-finetune)$.
model_namestringrequired- Name of the model definition. If multiple with the same name exist, they are applied in the following order: (1) custom over built-in, (2) newest according to startTime where model.startTime<observation.startTime. Example: my-finetune.
unitstringrequired- Unit used by this model. Example: TOKENS.one of
CHARACTERSTOKENSMILLISECONDSSECONDSIMAGESREQUESTS input_pricenumber- Deprecated. Use 'pricingTiers' instead. Price (USD) per input unit. Creates a default tier if pricingTiers not provided. Example: 0.000002.
output_pricenumber- Deprecated. Use 'pricingTiers' instead. Price (USD) per output unit. Creates a default tier if pricingTiers not provided. Example: 0.000008.
start_datestring- Apply only to generations which are newer than this ISO date. Example: 2026-01-01T00:00:00Z.
tokenizer_configobject- Legacy tokenizer configuration retained for API compatibility. Ingestion no longer uses it to infer observation usage. Example: {"tokenizerModel": "gpt-4o"}.
tokenizer_idstring- Legacy tokenizer identifier retained for API compatibility. Ingestion no longer uses it to infer observation usage. Example: openai.one of
openaiclaude total_pricenumber- Deprecated. Use 'pricingTiers' instead. Price (USD) per total units. Cannot be set if input or output price is set. Creates a default tier if pricingTiers not provided. Example: 0.00001.
langfuse_model_upsertCreate or replace a project-owned model definition by ID.WriteCreate or Replace Model
Create or replace a project-owned model definition by ID. Returns the model. Built-in Langfuse models cannot be replaced.
- Idempotent
Inputs
match_patternstringrequired- Regex pattern which matches this model definition to generation.model. Useful in case of fine-tuned models. If you want to exact match, use `(?i)^modelname$`. Example: (?i)^(my-finetune)$.
model_idstringrequired- ID of the model to create or replace. Example: cm0q1w2e3r4t5y6u7i8o9p.
model_namestringrequired- Name of the model definition. If multiple with the same name exist, they are applied in the following order: (1) custom over built-in, (2) newest according to startTime where model.startTime<observation.startTime. Example: my-finetune.
unitstringrequired- Unit used by this model. Example: TOKENS.one of
CHARACTERSTOKENSMILLISECONDSSECONDSIMAGESREQUESTS input_pricenumber- Deprecated. Use 'pricingTiers' instead. Price (USD) per input unit. Creates a default tier if pricingTiers not provided. Example: 0.000002.
output_pricenumber- Deprecated. Use 'pricingTiers' instead. Price (USD) per output unit. Creates a default tier if pricingTiers not provided. Example: 0.000008.
start_datestring- Apply only to generations which are newer than this ISO date. Example: 2026-01-01T00:00:00Z.
tokenizer_configobject- Legacy tokenizer configuration retained for API compatibility. Ingestion no longer uses it to infer observation usage. Example: {"tokenizerModel": "gpt-4o"}.
tokenizer_idstring- Legacy tokenizer identifier retained for API compatibility. Ingestion no longer uses it to infer observation usage. Example: openai.one of
openaiclaude total_pricenumber- Deprecated. Use 'pricingTiers' instead. Price (USD) per total units. Cannot be set if input or output price is set. Creates a default tier if pricingTiers not provided. Example: 0.00001.
langfuse_prompt_createCreate a new version of a text or chat prompt; a new name creates the prompt.WriteCreate Prompt Version
Create a new version of a text or chat prompt; a new name creates the prompt. Returns the created prompt version. Set labels to ["production"] to make it the version clients fetch.
Inputs
namestringrequired- The full prompt name, including any folder path, with at most 255 characters. Example: support-answer.
promptstringrequired- The prompt: a string for a text prompt, or a list of chat messages with role and content for a chat prompt. Example: "Answer the question: {{question}}".
commit_messagestring- Commit message for this prompt version. Example: Shorter answer.
configobject- Any JSON config stored with the prompt, such as model and temperature. Example: {"model": "gpt-4o", "temperature": 0.2}.
labelsarray- List of deployment labels of this prompt version. Example: ["staging"].
tagsarray- List of tags to apply to all versions of this prompt. Example: ["support"].
typestring- text or chat; must match the shape of prompt. Example: text.one of
textchat
langfuse_prompt_version_labels_updateAdd or move labels, such as production, to a prompt version.WriteUpdate Prompt Version Labels
Add or move labels, such as production, to a prompt version. Returns the updated prompt version.
- Idempotent
Inputs
namestringrequired- Name of the prompt. Example: support-answer.
versionintegerrequired- Version number. Example: 3.
new_labelsarray- New labels for the prompt version. Labels are unique across versions. The "latest" label is reserved and managed by Langfuse. Example: ["production"].
remove_labelsarray- Labels to remove from the prompt version. The "latest" label is reserved and managed by Langfuse. Example: ["staging"].
langfuse_score_config_createCreate a score configuration for consistent scoring.WriteCreate Score Config
Create a score configuration for consistent scoring. Returns the new config.
Inputs
data_typestringrequired- Data Type. Example: NUMERIC.one of
NUMERICBOOLEANCATEGORICALTEXT namestringrequired- Name of the score config. Max 80 characters. Only letters, numbers, underscores, spaces, periods, parentheses, and hyphens are allowed. Example: helpfulness.
categoriesarray- Configure custom categories for categorical scores. Pass a list of objects with `label` and `value` properties. Categories are autogenerated for boolean configs and cannot be passed. Example: [{"label": "good", "value": 1}, {"label": "bad", "value": 0}].
descriptionstring- Description is shown across the Langfuse UI and can be used to e.g. explain the config categories in detail, why a numeric range was set, or provide additional context on config name or usage. Example: How helpful the answer was.
max_valuenumber- Configure a maximum value for numerical scores. If not set, the maximum value defaults to +∞. Example: 1.
min_valuenumber- Configure a minimum value for numerical scores. If not set, the minimum value defaults to -∞. Example: 0.
langfuse_score_config_updateUpdate a score configuration's description, range, categories or archive state.WriteUpdate Score Config
Update a score configuration's description, range, categories or archive state. Returns the updated config.
- Idempotent
Inputs
config_idstringrequired- The unique langfuse identifier of a score config. Example: cm4t5y6u7i8o9p0a1s2d3f.
categoriesarray- Configure custom categories for categorical scores. Pass a list of objects with `label` and `value` properties. Categories are autogenerated for boolean configs and cannot be passed. Example: [{"label": "good", "value": 1}, {"label": "bad", "value": 0}].
descriptionstring- Description is shown across the Langfuse UI and can be used to e.g. explain the config categories in detail, why a numeric range was set, or provide additional context on config name or usage. Example: How helpful the answer was.
is_archivedboolean- The status of the score config showing if it is archived or not. Example: false.
max_valuenumber- Configure a maximum value for numerical scores. If not set, the maximum value defaults to +∞. Example: 1.
min_valuenumber- Configure a minimum value for numerical scores. If not set, the minimum value defaults to -∞. Example: 0.
namestring- Name of the score config. Max 80 characters. Only letters, numbers, underscores, spaces, periods, parentheses, and hyphens are allowed. Example: support-answer.
langfuse_scores_createCreate one or more scores on traces, observations, sessions or dataset runs, such as user feedback or evaluation results.WriteCreate Scores
Create one or more scores on traces, observations, sessions or dataset runs, such as user feedback or evaluation results. Returns the IDs of the accepted scores; scores are written asynchronously.
Inputs
scoresarrayrequired- Scores to create. Each needs a name and a value (a number, a category string or a boolean) and a target: traceId (optionally with observationId), sessionId or datasetRunId. Optional: dataType (NUMERIC, CATEGORICAL, BOOLEAN), comment, configId to validate against a score config, environment, metadata and id (to update an existing score). Example: [{"name": "helpfulness", "value": 0.9, "traceId": "4bf92f3577b34da6a3ce929d0e0e4736", "comment": "Good answer"}].
langfuse_annotation_queue_item_deleteRemove an item from an annotation queue.DestructiveRemove Annotation Queue Item
Remove an item from an annotation queue. Returns a confirmation.
- Idempotent
Inputs
item_idstringrequired- ID of the queue item. Example: cm2a3s4d5f6g7h8j9k0l1z.
queue_idstringrequired- ID of the annotation queue. Get it from langfuse_annotation_queues_list. Example: cm1q2w3e4r5t6y7u8i9o0p.
langfuse_dataset_item_deleteDelete a dataset item and its run items.DestructiveDelete Dataset Item
Delete a dataset item and its run items. Returns a confirmation message.
- Idempotent
Inputs
dataset_item_idstringrequired- ID of the dataset item. Example: item-001.
langfuse_evaluation_rule_deleteDelete an evaluation rule.DestructiveDelete Evaluation Rule
Delete an evaluation rule. Past results stay. Returns an empty response on success.
- Idempotent
Inputs
evaluation_rule_idstringrequired- Stable evaluation-rule identifier returned by the evaluation-rule endpoints. Example: cm6n7m8q9w0e1r2t3y4u5i.
langfuse_evaluator_deleteDelete an evaluator and all its versions.DestructiveDelete Evaluator
Delete an evaluator and all its versions. Returns an empty response on success.
- Idempotent
Inputs
evaluator_idstringrequired- Stable evaluator identifier returned by the evaluator endpoints. Example: cm7o8p9a0s1d2f3g4h5j6k.
langfuse_llm_connection_deleteDelete a project LLM connection.DestructiveDelete LLM Connection
Delete a project LLM connection. Evaluators that use it stop working. Returns an empty response on success.
- Idempotent
Inputs
llm_connection_idstringrequired- ID of the LLM connection. Get it from langfuse_llm_connections_list. Example: cm1z2x3c4v5b6n7m8a9s0d.
langfuse_model_deleteDelete a project-owned model definition.DestructiveDelete Model
Delete a project-owned model definition. Returns an empty response on success.
- Idempotent
Inputs
model_idstringrequired- ID of the model. Get it from langfuse_models_list. Example: cm0q1w2e3r4t5y6u7i8o9p.
langfuse_prompt_deleteDelete a prompt, or only the versions with a given version number or label.DestructiveDelete Prompt Versions
Delete a prompt, or only the versions with a given version number or label. Returns an empty response on success.
- Idempotent
Inputs
prompt_namestringrequired- The name of the prompt. Example: support-answer.
labelstring- Optional label to filter deletion. If specified, deletes all prompt versions that have this label. Example: staging.
versioninteger- Optional version to filter deletion. If specified, deletes only this specific version of the prompt. Example: 3.
langfuse_score_deleteDelete a score.DestructiveDelete Score
Delete a score. Returns an empty response on success.
- Idempotent
Inputs
score_idstringrequired- The unique langfuse identifier of a score. Example: cm5g6h7j8k9l0z1x2c3v4b.
langfuse_trace_deleteDelete one trace and its observations.DestructiveDelete Trace
Delete one trace and its observations. Returns a confirmation message. Use langfuse_traces_delete for several traces.
- Idempotent
Inputs
trace_idstringrequired- ID of the trace to delete. Example: 4bf92f3577b34da6a3ce929d0e0e4736.
langfuse_traces_deleteDelete several traces and their observations.DestructiveDelete Traces
Delete several traces and their observations. Returns a confirmation message.
- Idempotent
Inputs
trace_idsarrayrequired- IDs of the traces to delete. Example: ["4bf92f3577b34da6a3ce929d0e0e4736", "5ce03a4688c45eb7b4df030e1f1f5847"].
No tools match.