View as Markdown
Eppo icon

Eppo ACTION

List Experiments

Retrieve all experiments in Eppo with their name, key, status, entity ID, and assignment source ID. Use this to discover experiment IDs for Get Experiment Results, or find entity_id values needed to create new experiments. Filter by type (all, experiments, or holdouts), experimentKey, entityId, tagNames, isDeleted, updatedSince, or createdSince to narrow results. Set withCalculatedMetrics or withFullCupedData to include additional metric data in the response. See the documentation
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Eppo account once, then configure and run List Experiments from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "eppo-list-experiments",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    eppo: { authProvisionId: "apn_xxxxxxx" },
    experimentKey: "Experiment Key",
    entityId: 10,
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

List Experiments inputs
Property Type Description
experimentKey Experiment Key string
Filter experiments by experiment key
Optional
entityId Entity ID integer
The numeric entity type ID this metric measures (e.g. user, session). Use List Metrics to find the entity_id from any existing metric — all metrics in the same workspace typically share the same entity ID.
Optional
type Type string
Filter experiments by type. Accepted values are: all, experiments, holdouts
Optional
withCalculatedMetrics With Calculated Metrics boolean
Whether to include calculated metrics in the response
Optional
withFullCupedData With Full Cuped Data boolean
Whether to include full Cuped data in the response
Optional
isDeleted Is Deleted boolean
Filter experiments by deleted status. Accepted values are: true, false
Optional
tagNames Tag Names string[]
Filter experiments by tag names
Optional
updatedSince Updated Since string
Filter experiments updated after this date (ISO 8601 format in UTC, e.g., 2024-01-01T00:00:00Z or 2024-01-01)
Optional
createdSince Created Since string
Filter experiments created after this date (ISO 8601 format in UTC, e.g., 2024-01-01T00:00:00Z or 2024-01-01)
Optional
limit Limit integer
Maximum number of items to return per page (max 250).
Optional
offset Offset integer
Offset the number of items in response
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
eppo-list-experiments
Version
0.0.2
App
Eppo
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes