v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB

LLM Observability

List LLM Observability experiments

List all LLM Observability experiments sorted by creation date, newest first.

get/api/v2/llm-obs/v1/experiments

Query parameters

filter[project_id]string

Filter experiments by project ID. Required if filter[dataset_id] is not provided.

filter[dataset_id]string

Filter experiments by dataset ID.

filter[id]string

Filter experiments by experiment ID. Can be specified multiple times.

filter[name]string

Filter experiments by their exact run name.

filter[experiment]string

Filter by logical experiment name. This is the name field set when creating an experiment through POST /experiments. Returns all experiment runs that share the same name, enabling cross-commit and cross-branch comparisons.

filter[metadata]string

Filter by JSONB metadata containment. Provide a JSON object string where experiments whose metadata contains all specified key-value pairs are returned. For example: {"commit":"abc123","branch":"main"}.

filter[parent_experiment_id]string

Filter experiments by the ID of their parent (baseline) experiment. Returns all experiments that were run against the given baseline. Can be specified multiple times.

filter[is_deleted]boolean

When true, return only soft-deleted experiments. Defaults to false.

include[user_data]boolean

When true, enrich each experiment with its author's user data in the author field.

include[dataset_names]boolean

When true, enrich each experiment with its dataset name in the dataset_name field.

page[cursor]string

Use the pagination cursor returned in meta.after to retrieve the next page of results.

page[limit]integer

Maximum number of results to return per page. Values above 5000 are clamped to 5000. Defaults to 5000.

Response

Example response

{
  "data": [
    {
      "attributes": {
        "author": {
          "email": "jane.doe@example.com",
          "handle": "jane.doe@example.com",
          "icon": "https://example.com/icon.png",
          "id": "00000000-0000-0000-0000-000000000010",
          "name": "Jane Doe"
        },
        "created_at": "2024-01-15T10:30:00Z",
        "dataset_id": "9f64e5c7-dc5a-45c8-a17c-1b85f0bec97d",
        "experiment": "my-pipeline",
        "name": "My Experiment v1",
        "parent_experiment_id": "3fd6b5e0-8910-4b1c-a7d0-5b84de329012",
        "project_id": "a33671aa-24fd-4dcd-9b33-a8ec7dde7751",
        "status": "completed",
        "updated_at": "2024-01-15T10:30:00Z"
      },
      "id": "3fd6b5e0-8910-4b1c-a7d0-5b84de329012",
      "type": "experiments"
    }
  ]
}