v1

latestOpenAPI 3.1.02026-07-17141136.0 KB

experiments

Get experiment

Retrieve detailed information about a specific experiment, including all stages and agent configurations.

This endpoint returns the experiment configuration without participant data. Use the /experiments/{id}/export endpoint to get participant responses and cohort data.

get/experiments/{id}

Path parameters

idstring required

Experiment ID

Response

Successful operation. Returns experiment configuration without participant data.

stageMapobject

Maps stage ID to stage config

agentMediatorMapobject

Maps agent mediator persona ID to agent template

agentParticipantMapobject

Maps agent participant ID to agent template

Example response

{
  "experiment": {
    "id": "exp123",
    "versionId": 18,
    "metadata": {
      "name": "Decision Making Study",
      "publicName": "Decision Study",
      "description": "Research on group decision making",
      "tags": [
        "research",
        "decision-making"
      ],
      "creator": "experimenter123"
    },
    "permissions": {
      "visibility": "private",
      "readers": [
        "experimenter123"
      ]
    },
    "stageIds": [
      "stage1",
      "stage2"
    ]
  }
}