Skip to content

Read Endpoints

Note that access to the Comet REST endpoints require the {'Authorization': ${COMET_API_KEY}} header. You can find your API key in your account settings or by navigating to https://www.comet.com/api/my/settings/.

Get User Workspaces

GET/api/rest/v2/workspaces

Get a user's workspaces.

Example Response

{
    "workspaceNames": [
        "team name",
        "another team name"
    ]
}

Get Projects

GET/api/rest/v2/projects?workspaceName=aTeamName

Get a workspace's projects.

Example Response

{
    "projects": [
        {
            "projectId": "aProjectId",
            "projectName": "Project Name",
            "ownerUserName": "Owner User Name",
            "projectDescription": "Project Description",
            "workspaceName": "Name of the team for team_id above",
            "isPublic": "[boolean, true if this is a public project]",
            "numberOfExperiments": "[integer, number of experiments in this project]",
            "lastUpdated": "[long, last time this project was updated in the DB]"
        }
    ]
}

Get Projects by Query

GET/api/rest/v2/projects/page?workspaceName=NAME&offset=INT&count=INT&sort=STRℴ=STR&owner=STR&public=STR,starterProject=STR&search=STR

Get a page of projects by query variables

Example Response

{
    "rows": [
        {
            "projectId": "owner-NA",
            "userName": "owner",
            "projectName": "project-name",
            "projectDesc": "Project Description",
            "generalProject": true,
            "totalRowCount": "205",
            "filteredRowCount": "205",
            "experimentCount": 772,
            "imagePath": "https://s3.amazonaws.com/comet.ml/4.png",
            "isPublic": false,
            "teamId": "owner-default",
            "created_at": 1536971527000,
            "lastUpdated": 1643135859918,
            "lastUpdatedByUser": 1614970814926,
            "isStarterProject": false,
            "teamName": "owner",
            "isInProjectTeam": false,
            "owner": true,
            "canEdit": true
        }
    ],
    "filteredRowCount": 205,
    "totalRowCount": 205
}
Note: added 2022/02/01

Get Registry Models

GET/api/rest/v2/registry-model?workspaceName=aTeamName

Get a workspace's registry models.

Example Response

{
    "registryModels": [
        {
            "registryModelId": "someRegistryModelId",
            "modelName": "someModelName",
            "description": "someDescription",
            "isPublic": "[Boolean]",
            "createdAt": "[long, when this model was created in the DB]",
            "lastUpdated": "[long, last time this model was updated in the DB]",
            "userName": "someUserName",
            "latestVersion": {
                "registryModelItemId": "someRegistryModelItemId",
                "experimentModel": {
                    "experimentModelId": "someExperimentModelId",
                    "experimentModelName": "someExperimentModelName",
                    "experimentKey": "someExperimentKey"
                },
                "version": "someVersion",
                "comment": "someComment",
                "stages": [
                    "production",
                    "staging"
                ],
                "userName": "someUserName",
                "createdAt": "[long, when this model item was created in the DB]",
                "lastUpdated": "[long, last time this model item was updated in the DB]",
                "metadata": [
                    "metadata from first asset",
                    "metadata from second asset"
                ]
            }
        }
    ]
}

Get Registry Model Count

GET/api/rest/v2/registry-model/count?workspaceName=aTeamName

Get a count of a workspace's registry models.

Example Response

{
    "registryModelCount": 7
}

Get Registry Model Details

GET/api/rest/v2/registry-model/details?workspaceName=someWorkspaceName&modelName=someModelName

Get a registry model's details.

Example Response

{
    "registryModelId": "someRegistryModelId",
    "modelName": "someModelName",
    "description": "someDescription",
    "isPublic": "[Boolean]",
    "createdAt": "[long, when this model was created in the DB]",
    "lastUpdated": "[long, last time this model was updated in the DB]",
    "userName": "someUserName",
    "versions": [
        {
            "registryModelItemId": "someRegistryModelItemId",
            "experimentModel": {
                "experimentModelId": "someExperimentModelId",
                "experimentModelName": "someExperimentModelName",
                "experimentKey": "someExperimentKey"
            },
            "version": "someVersion",
            "comment": "someComment",
            "stages": [
                "production",
                "staging"
            ],
            "userName": "someUserName",
            "createdAt": "[long, when this model item was created in the DB]",
            "lastUpdated": "[long, last time this model item was updated in the DB]",
            "assets": [
                {
                    "fileName": "someFileName",
                    "fileSize": "[Long, file size]",
                    "runContext": "someRunContext",
                    "step": "[Integer, step asset was logged during]",
                    "link": "link to download asset file",
                    "createdAt": "[Long, timestamp asset was created in DB]",
                    "dir": "someDirectory",
                    "canView": "[Boolean, whether the asset is viewable as an image]",
                    "audio": "[Boolean, whether the asset is an audio file]",
                    "histogram": "[Boolean, whether the asset is a histogram file]",
                    "image": "[Boolean, whether the asset was stored as an image]",
                    "type": "the type of asset",
                    "metadata": "Metadata associated with the asset",
                    "assetId": "someAssetId"
                }
            ]
        }
    ]
}

Get Latest Registry Model Version

GET/api/rest/v2/registry-model/latest_version?workspaceName=someWorkspaceName&modelName=someModelName&stage=someStage&versionMajor=someMajorVersion&versionMinor=someMinorVersion

Get the latest version for a registry model. Optionally it is possible to return latest version that matches a stage or major and minor versions

Example Response

{
    "registryModelId": "someRegistryModelId",
    "modelName": "someModelName",
    "description": "someDescription",
    "isPublic": "[Boolean]",
    "createdAt": "[long, when this model was created in the DB]",
    "lastUpdated": "[long, last time this model was updated in the DB]",
    "userName": "someUserName",
    "versions": [
        {
            "registryModelItemId": "someRegistryModelItemId",
            "experimentModel": {
                "experimentModelId": "someExperimentModelId",
                "experimentModelName": "someExperimentModelName",
                "experimentKey": "someExperimentKey"
            },
            "version": "someVersion",
            "comment": "someComment",
            "stages": [
                "production",
                "staging"
            ],
            "userName": "someUserName",
            "createdAt": "[long, when this model item was created in the DB]",
            "lastUpdated": "[long, last time this model item was updated in the DB]",
            "assets": [
                {
                    "fileName": "someFileName",
                    "fileSize": "[Long, file size]",
                    "runContext": "someRunContext",
                    "step": "[Integer, step asset was logged during]",
                    "link": "link to download asset file",
                    "createdAt": "[Long, timestamp asset was created in DB]",
                    "dir": "someDirectory",
                    "canView": "[Boolean, whether the asset is viewable as an image]",
                    "audio": "[Boolean, whether the asset is an audio file]",
                    "histogram": "[Boolean, whether the asset is a histogram file]",
                    "image": "[Boolean, whether the asset was stored as an image]",
                    "type": "the type of asset",
                    "metadata": "Metadata associated with the asset",
                    "assetId": "someAssetId"
                }
            ]
        }
    ]
}

Get Registry Model Notes

GET/api/rest/v2/registry-model/notes?workspaceName=someWorkspaceName&modelName=someModelName

Get a registry model's notes.

Example Response

{
    "notes": "Potentially very long notes string"
}

Download Registry Model Version

GET/api/rest/v2/registry-model/item/download?workspaceName=someWorkspaceName&modelName=someModelName&version=someVersion

Download a zip file of a registry model version.

Example Response

"[Raw stream of zip file as octet-stream]"

Get Project

GET/api/rest/v2/project?projectId=someProjectId
GET/api/rest/v2/project?projectName=pname&workspaceName=aTeamName

Get details on a project.

Example Response

{
    "projectId": "aProjectId",
    "projectName": "Project Name",
    "ownerUserName": "Owner User Name",
    "projectDescription": "Project Description",
    "workspaceName": "Name of the team for team_id above",
    "isPublic": "[boolean, true if this is a public project]",
    "numberOfExperiments": "[integer, number of experiments in this project]",
    "lastUpdated": "[long, last time this project was updated in the DB]"
}

Get Project Columns

GET/api/rest/v2/project/column-names?projectId=someProjectId&archived=false
GET/api/rest/v2/project/column-names?projectName=pname&workspaceName=ws&archived=false

Get a project's columns. These are the items that can be queried.

Example Response

{
    "columns": [
        {
            "name": "Column Name",
            "id": "unique-column-id",
            "type": "one of: double, string, datetime, boolean, or timenumber",
            "source": "one of: metrics, params, log_other, metadata, tag, or env_details"
        }
    ]
}

Apply Project Query

POST/api/rest/v2/project/query

Apply a query to a project.

Example Request

{
    "projectId": "someProjectId",
    "projectName": "someProjectName",
    "workspaceName": "someWorkspaceName",
    "predicates": "Json Predicates for search here, example below",
    "archived": "[boolean: if true search for archived experiments.  Optional]"
}

Example Response

{
    "experimentKeys": [
        "KEY",
        "anotherExperimentKey"
    ],
    "experimentsInProject": "[int count of experiments in project, including all those filtered out.  If archived was true this is the archived experiment count]"
}
Note: An example predicate:
[
    {
      "source": "metrics",
      "query": {
        "condition": "AND",
        "rules": [
          {
            "id": "columnNameA",
            "field": "columnNameA",
            "type": "double",
            "input": "text",
            "operator": "greater",
            "value": 1
          }
        ],
        "valid": true
      }
    }
  ]

Get Project Notes

GET/api/rest/v2/project/notes?projectId=PROJECTID

Get a project's notes.

Example Response

{
    "notes": "someProjectNotes"
}

GET/api/rest/v2/project/get-project-share-links?projectId=PROJECT-ID

Get a Project's share links

Example Response

{
    "shareCodes": [
        "37645346359823"
    ]
}
Note: added 2022/02/01

Get Multi Metric Chart

POST/api/rest/v2/experiments/multi-metric-chart

Get multi-metric chart data.

Example Request

{
    "targetedExperiments": [
        "KEY",
        "anotherExperimentKey"
    ],
    "metrics": [
        "someMetricName",
        "anotherMetricName"
    ],
    "params": [
        "someParameterName",
        "anotherParameterName"
    ],
    "independentMetrics": "[Boolean, whether the metrics should be fetched individually or as a correlated whole (only return values for steps for which you have values for every requested metric name)]",
    "fetchFull": "[Boolean, whether to fetch all values (up to 15,000) or a sampled subset (about 500 points)]"
}

Example Response

{
    "experiments": {
        "KEY": {
            "experimentKey": "KEY",
            "steps": [
                1,
                2,
                3
            ],
            "metrics": [
                {
                    "metricName": "someMetricName",
                    "values": [
                        1.2,
                        1.3,
                        1.4
                    ],
                    "steps": [
                        1,
                        2,
                        3
                    ],
                    "timestamps": [
                        "[Long, list of timestamps of metric values]"
                    ],
                    "durations": [
                        "[Long, time between each value and the previous value, 0 for the first]"
                    ]
                }
            ],
            "params": {
                "someParam": "8675309",
                "anotherParam": "whatever value you want"
            }
        }
    },
    "empty": "[Boolean, whether any metrics were returned]"
}

Get Experiments

GET/api/rest/v2/experiments?projectId=someProjectId&archived=false
GET/api/rest/v2/experiments?projectName=pname&workspaceName=wsname&archived=false

Get a project's experiments.

Example Response

{
    "experiments": [
        {
            "experimentKey": "SomeExperimentKey",
            "experimentName": "SomeExperimentName",
            "optimizationId": "optimization run associated with this experiment, if any",
            "durationMillis": "[long, How long the experiment ran for]",
            "startTimeMillis": "[long, As recorded by the backend, when this experiment started]",
            "endTimeMillis": "[long, As recorded by the backend, when this experiment ended]"
        }
    ]
}

Get Experiment Metadata

GET/api/rest/v2/experiment/metadata?experimentKey=KEY

Get an experiment's metadata.

Example Response

{
    "experimentKey": "KEY",
    "experimentName": "someExperimentName",
    "optimizationId": "someOptimizationId",
    "projectId": "someProjectId",
    "projectName": "someProjectName",
    "workspaceName": "someWorkspaceName",
    "durationMillis": "someDurationMillis",
    "startTimeMillis": "someStartTimeMillis",
    "endTimeMillis": "someEndTimeMillis"
}

Get Experiment Git Metadata

GET/api/rest/v2/experiment/git/metadata?experimentKey=KEY

Get the git metadata of an experiment.

Example Response

{
    "user": "gitUser",
    "root": "gitRoot",
    "branch": "gitBranch",
    "parent": "gitParent",
    "origin": "gitOrigin"
}

Get Experiment Git Patch

GET/api/rest/v2/experiment/git/patch?experimentKey=KEY

Get the git patch of an experiment.

Example Response

"[Raw stream of git patch as octet-stream]"

Get Experiment HTML

GET/api/rest/v2/experiment/html?experimentKey=KEY

Get an experiment's HTML.

Example Response

{
    "html": "HTML for Experiment"
}

Get Experiment Code

GET/api/rest/v2/experiment/code?experimentKey=KEY

Get an experiment's source code.

Example Response

{
    "code": "Code for Experiment"
}

Get Experiment Output

GET/api/rest/v2/experiment/output?experimentKey=KEY

Get an experiment's standard output and error.

Example Response

{
    "output": "stdout and stderr output for Experiment, with '\n' delimiters"
}

Get Experiment Graph

GET/api/rest/v2/experiment/graph?experimentKey=KEY

Get an experiment's model graph.

Example Response

{
    "graph": "Graph for Experiment"
}

Get Experiment Cloud Details

GET/api/rest/v2/experiment/cloud-details?experimentKey=KEY

Get an experiment's cloud details.

Example Response

{
    "experimentKey": null,
    "provider": null,
    "metadata": null
}
Note: added 2022/02/01

Get All Metrics For Name

GET/api/rest/v2/experiment/metrics/get-metric?experimentKey=KEY&metricName=NAME

Get all metric values for a metric name.

Example Response

{
    "metrics": [
        {
            "metricName": "someMetricName",
            "metricValue": "someMetricValue",
            "epoch": "[long, epoch this metric is from]",
            "timestamp": "[long, time this metric was recorded]",
            "step": "[long, step this metric is from]",
            "runContext": "someRunContext",
            "offset": "[Long, offset that this metric was sent as]"
        }
    ]
}

Get Metrics Summary

GET/api/rest/v2/experiment/metrics/summary?experimentKey=KEY

Get an experiment's metrics summary.

Example Response

{
    "values": [
        {
            "name": "someName",
            "valueMax": "max value",
            "valueMin": "min value",
            "valueCurrent": "last value",
            "timestampMax": "[long, time max value was recorded]",
            "timestampMin": "[long, time min value was recorded]",
            "timestampCurrent": "[long, time last value was recorded]",
            "runContextMax": "run context of max value",
            "runContextMin": "run context of min value",
            "runContextCurrent": "run context of last value",
            "stepMax": "[long, step max value is from]",
            "stepMin": "[long, step min value is from]",
            "stepCurrent": "[long, step current value is from]"
        }
    ]
}

Get Parameters

GET/api/rest/v2/experiment/parameters?experimentKey=KEY

Get an experiment's parameters summary.

Example Response

{
    "values": [
        {
            "name": "someName",
            "valueMax": "max value",
            "valueMin": "min value",
            "valueCurrent": "last value",
            "timestampMax": "[long, time max value was recorded]",
            "timestampMin": "[long, time min value was recorded]",
            "timestampCurrent": "[long, time last value was recorded]",
            "runContextMax": "run context of max value",
            "runContextMin": "run context of min value",
            "runContextCurrent": "run context of last value",
            "stepMax": "[long, step max value is from]",
            "stepMin": "[long, step min value is from]",
            "stepCurrent": "[long, step current value is from]"
        }
    ]
}

Get Others

GET/api/rest/v2/experiment/log-other?experimentKey=KEY

Get an experiment's others (logged with log-other) summary.

Example Response

{
    "values": [
        {
            "name": "someName",
            "valueMax": "max value",
            "valueMin": "min value",
            "valueCurrent": "last value",
            "timestampMax": "[long, time max value was recorded]",
            "timestampMin": "[long, time min value was recorded]",
            "timestampCurrent": "[long, time last value was recorded]",
            "runContextMax": "run context of max value",
            "runContextMin": "run context of min value",
            "runContextCurrent": "run context of last value",
            "stepMax": "[long, step max value is from]",
            "stepMin": "[long, step min value is from]",
            "stepCurrent": "[long, step current value is from]"
        }
    ]
}

Get Tags

GET/api/rest/v2/experiment/tags?experimentKey=KEY

Get an experiment's tags.

Example Response

{
    "tags": [
        "a tag",
        "another tag"
    ]
}

Get System Details

GET/api/rest/v2/experiment/system-details?experimentKey=KEY

Get an experiment's system details.

Example Response

{
    "experimentKey": "KEY",
    "user": "system username",
    "pythonVersion": "python version",
    "pythonVersionVerbose": "python version with verbose flag",
    "pid": "[Integer, pid]",
    "osType": "os experiment ran on",
    "os": "os with version info",
    "ip": "ip address",
    "hostname": "hostname",
    "gpuStaticInfoList": [
        {
            "gpuIndex": "[Integer, index]",
            "name": "name",
            "uuid": "someUniqueId",
            "totalMemory": "[Integer, total memory used???]",
            "powerLimit": "[Integer, max power used????]"
        }
    ],
    "logAdditionalSystemInfoList": [
        {
            "key": "someKey",
            "value": "someValue"
        }
    ],
    "systemMetricNames": [
        "name",
        "anotherName"
    ],
    "maxTotalMemory": "[double, max memory used]",
    "networkInterfaceIps": [
        "ip",
        "anotherIp"
    ],
    "command": [
        "myScript.py",
        "-arg",
        "theArgument"
    ],
    "executable": "/usr/local/bin/python",
    "osPackages": [
        "package",
        "anotherPackage"
    ],
    "installedPackages": [
        "package",
        "anotherPackage"
    ]
}

Get Asset List

GET/api/rest/v2/experiment/asset/list?experimentKey=KEY&type=all

Get an experiment's asset list.

Example Response

{
    "assets": [
        {
            "fileName": "someFileName",
            "fileSize": "[Long, file size]",
            "runContext": "someRunContext",
            "step": "[Integer, step asset was logged during]",
            "link": "link to download asset file",
            "createdAt": "[Long, timestamp asset was created in DB]",
            "dir": "someDirectory",
            "canView": "[Boolean, whether the asset is viewable as an image]",
            "audio": "[Boolean, whether the asset is an audio file]",
            "histogram": "[Boolean, whether the asset is a histogram file]",
            "image": "[Boolean, whether the asset was stored as an image]",
            "type": "the type of asset",
            "metadata": "Metadata associated with the asset",
            "assetId": "someAssetId",
            "remote": false,
            "tags": []
        }
    ]
}
Note: allowed types: all, unknown, audio, video, image, histogram3d, histogram_combined_3d, confusion-matrix

Get Asset Details

GET/api/rest/v2/experiment/asset/details?experimentKey=KEY&assetId=someAssetId

Get the asset details. This is the same information returned by experiment/asset/list but for a single assitId

Example Response

{
    "fileName": "someFileName",
    "fileSize": "[Long, file size]",
    "runContext": "someRunContext",
    "step": "[Integer, step asset was logged during]",
    "link": "link to download asset file",
    "createdAt": "[Long, timestamp asset was created in DB]",
    "dir": "someDirectory",
    "canView": "[Boolean, whether the asset is viewable as an image]",
    "audio": "[Boolean, whether the asset is an audio file]",
    "histogram": "[Boolean, whether the asset is a histogram file]",
    "image": "[Boolean, whether the asset was stored as an image]",
    "type": "the type of asset",
    "metadata": "Metadata associated with the asset",
    "assetId": "someAssetId",
    "remote": false,
    "tags": []
}
Note: added 2022/02/01

Get Asset

GET/api/rest/v2/experiment/asset/get-asset?experimentKey=KEY&assetId=someAssetId

Get an asset.

Example Response

"[Raw binary stream of asset or JSON {'msg':'no patch for experiment','code':200,'data':null,'sdk_error_code':0}]"

Get Experiment Model List

GET/api/rest/v2/experiment/model?experimentKey=KEY

Get the list of models created by a given experiment.

Example Response

{
    "models": [
        {
            "experimentModelId": "someExperimentModelId",
            "experimentKey": "KEY",
            "modelName": "someExperimentModelName"
        }
    ]
}

Get Experiment Model Asset List

GET/api/rest/v2/experiment/model/asset/list?experimentKey=KEY&modelName=myExperimentModelName

Get the list of assets for a particular experiment model.

Example Response

{
    "assets": [
        {
            "fileName": "someFileName",
            "fileSize": "[Long, file size]",
            "runContext": "someRunContext",
            "step": "[Integer, step asset was logged during]",
            "link": "link to download asset file",
            "createdAt": "[Long, timestamp asset was created in DB]",
            "dir": "someDirectory",
            "canView": "[Boolean, whether the asset is viewable as an image]",
            "audio": "[Boolean, whether the asset is an audio file]",
            "histogram": "[Boolean, whether the asset is a histogram file]",
            "image": "[Boolean, whether the asset was stored as an image]",
            "type": "the type of asset",
            "metadata": "Metadata associated with the asset",
            "assetId": "someAssetId"
        }
    ]
}

Download Experiment Model

GET/api/rest/v2/experiment/model/download?experimentKey=KEY&modelName=myExperimentModelName

Download a zip file of an experiment model.

Example Response

"[Raw stream of zip file as octet-stream]"

Download Artifact

GET/api/rest/v2/artifacts/version/download?workspace=NAME&project=ID&artifactName=NAME&artifactId=ID&versionId=ID&version=VER&alias=ALIAS&versionOrAlias=WHICH&experimentKey=KEY

Download an artifact

Example Response

"[Raw binary of asset]"
Note: added 2022/02/01

Get Store

GET/api/rest/v2/viz-instance/store/get?instanceId=INSTANCE_ID&projectId=PROJECT_ID

Get an entire store.

Example Response

"{'store': '{key1: value1, ...}'}"

Get Account Details

GET/api/rest/v2/account-details?userName=USERNAME&defaultWorkspaceName=WORKSPACE

Get account details from authenticated user's apiKey in header

Example Response

{
    "userName": "USERNAME",
    "defaultWorkspaceName": "WORKSPACE"
}

Get Panels in workspace

GET/api/rest/v2/code-panel/get-all?workspace=NAME

Get a list of metadata for all panels in workspace

Example Response

{
    "codePanelTemplateRows": [
        {
            "templateId": "SzUYHmX7hnR7KrLzU1tBrHilq",
            "owner": "owner",
            "teamId": "owner-default",
            "templateName": "Panel Name",
            "queryBuilderId": "",
            "scopeType": "PUBLIC",
            "revisionId": 1596673911412,
            "createdAt": 1584445331784
        }
    ]
}
Note: added 2022/02/01

Get Panel JSON

GET/api/rest/v2/code-panel/download?templateId=TEMPLATE-ID
GET/api/rest/v2/code-panel/download?instanceId=INSTANCE-ID

Get the Panel JSON

Example Response

{
    "templateId": "DyfpvKGZJvrtY1jjsYuMmLgz5",
    "owner": "owner",
    "teamId": "owner-default",
    "templateName": "Panel Name",
    "queryBuilderId": "",
    "code": {
        "code": "// JavaScript Code",
        "css": "/** CSS **/",
        "description": "Panel Description",
        "html": "<div id=\"chart-mount\"></div>",
        "defaultConfig": "\"\"",
        "internalResources": [
            {
                "name": "Comet SDK",
                "version": "latest",
                "enabled": true
            },
            {
                "name": "Plotly.js",
                "version": "1.50.1",
                "enabled": true
            }
        ],
        "userResources": [],
        "pyCode": "## Python Code",
        "type": "py",
        "pyConfig": ""
    },
    "rank": {
        "templateId": "DyfpvKGZJvrtY1jjsYuMmLgz5",
        "voteCount": 0,
        "userVoteType": "NOVOTE"
    },
    "scopeType": "PRIVATE",
    "revisionId": 1642709054245,
    "createdAt": 1642709054465,
    "thumbnailName": "template-thumbnail-DyfpvKGZJvrtY1jjsYuMmLgz5",
    "editable": true
}
Note: added 2022/02/01

Download Panel as Zipfile

GET/api/rest/v2/template/{templateId}/download

Download the contents of a Panel as zipfile contents.

Example Response

"[Raw binary stream of compress panel JSON]"
Note: added 2022/02/01

Get Dashboard Template List

GET/api/rest/v2/dashboard-template/get-all?workspace=WORKSPACE-NAME

Get a list of dashboard template JSON objects

Example Response

{
    "dashboardTemplates": [
        {
            "templateId": "owner-unsaved-035669d7f91a4ac7a3058fba0c7264b0",
            "templateName": "Template Name",
            "projectId": "035669d7f91a4ac7a3058fba0c7AAA",
            "projectName": "Project Name",
            "createdBy": "owner"
        }
    ]
}
Note: added 2022/02/01

Download Dashboard

GET/api/rest/v2/dashboard-template/download?projectId=PROJECT-ID&templateId=TEMPLATE-ID

Download a dashboard template

Example Response

{
    "project_id": "ff9f723aa70f4fb6a2e6f3d23f6fe848",
    "template_name": "ARP",
    "template_id": "ipPl7zaLAX9aNa9bwoCaY6HBi",
    "experimentQueryState": "{\"filters\":[],\"activeSegment\":{}}",
    "dashboardChartState": "{\"downsample_size\":1000,\"entire_row_charts\":false, ...}",
    "reactGridTableState": "{\"selection\":[],\"pageSize\":25,\"pageNumber\":0, ...}",
    "v2": {
        "reactGridTableState": "{\"selection\":[],\"pageSize\":25, ...}",
        "toggles": {
            "DASHBOARD_TOGGLE": {
                "isVisible": true,
                "toggleId": "DASHBOARD_TOGGLE"
            },
            "EXPERIMENT_TABLE_TOGGLE": {
                "isVisible": true,
                "toggleId": "EXPERIMENT_TABLE_TOGGLE"
            }
        }
    },
    "source": "",
    "current": false,
    "unsaved_view": false,
    "created_by": "owner",
    "project_default": false,
    "pinnedExperiments": [],
    "codePanelTemplateIds": [],
    "isAutoRefreshEnabled": true
}
Note: added 2022/02/01

Get an Optimizer's Best Experiment

GET/api/rest/v2/get-best-experiment?optimizationId=OPTIMIZATION-ID&metricName=METRIC-NAME&goal=MIN-OR-MAX

Get an optimizer's best experiment so far.

Example Response

{
    "experimentKey": "5e6dbb408c694d1cb6e7ca4edc80b921",
    "metricValue": 0.010686935856938362,
    "experimentCount": 12
}
Note: added 2022/02/01

Get Webhook Configuration

GET/api/rest/v2/webhooks/config?workspaceName=aTeamName&modelName=someModelName

Get the configuration for a webhook. The webhook notifies about any change in the Stage status of a specific registered model, or of any registered model in a specific workspace.

Example Response

{
    "workspaceName": "some-workspace",
    "modelName": "some-model",
    "webhookUrls": [
        {
            "url": "https://{customer-webhook-url-a}",
            "header": {
                "Authorization": "secret_token",
                "Other": "other_info"
            }
        }
    ]
}

Nov. 18, 2024