---
title: Model Lab API
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > API Reference > Model Lab API
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Model Lab API

Manage Model Lab projects, runs, artifacts, and facets for ML experiment tracking.

## [List Model Lab projects →](https://docs.datadoghq.com/api/latest/model-lab-api/list-model-lab-projects.md) preview{% #list-model-lab-projects %}

| Datadog site      | API endpoint                                                    |
| ----------------- | --------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/model-lab-api/projects |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/model-lab-api/projects |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/model-lab-api/projects      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/model-lab-api/projects      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/model-lab-api/projects  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/model-lab-api/projects |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/model-lab-api/projects     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/model-lab-api/projects |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/model-lab-api/projects |

## [Get a Model Lab project →](https://docs.datadoghq.com/api/latest/model-lab-api/get-a-model-lab-project.md) preview{% #get-a-model-lab-project %}

| Datadog site      | API endpoint                                                                 |
| ----------------- | ---------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/model-lab-api/projects/{project_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/model-lab-api/projects/{project_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/model-lab-api/projects/{project_id}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/model-lab-api/projects/{project_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/model-lab-api/projects/{project_id}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/model-lab-api/projects/{project_id} |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/model-lab-api/projects/{project_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/model-lab-api/projects/{project_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/model-lab-api/projects/{project_id} |

## [List Model Lab project facet keys →](https://docs.datadoghq.com/api/latest/model-lab-api/list-model-lab-project-facet-keys.md) preview{% #list-model-lab-project-facet-keys %}

| Datadog site      | API endpoint                                                              |
| ----------------- | ------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/model-lab-api/project-facet-keys |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/model-lab-api/project-facet-keys |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/model-lab-api/project-facet-keys      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/model-lab-api/project-facet-keys      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/model-lab-api/project-facet-keys  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/model-lab-api/project-facet-keys |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/model-lab-api/project-facet-keys     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/model-lab-api/project-facet-keys |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/model-lab-api/project-facet-keys |

## [List Model Lab project facet values →](https://docs.datadoghq.com/api/latest/model-lab-api/list-model-lab-project-facet-values.md) preview{% #list-model-lab-project-facet-values %}

| Datadog site      | API endpoint                                                                |
| ----------------- | --------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/model-lab-api/project-facet-values |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/model-lab-api/project-facet-values |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/model-lab-api/project-facet-values      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/model-lab-api/project-facet-values      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/model-lab-api/project-facet-values  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/model-lab-api/project-facet-values |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/model-lab-api/project-facet-values     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/model-lab-api/project-facet-values |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/model-lab-api/project-facet-values |

## [Star a Model Lab project →](https://docs.datadoghq.com/api/latest/model-lab-api/star-a-model-lab-project.md) preview{% #star-a-model-lab-project %}

| Datadog site      | API endpoint                                                                       |
| ----------------- | ---------------------------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/model-lab-api/projects/{project_id}/star |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/model-lab-api/projects/{project_id}/star |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/model-lab-api/projects/{project_id}/star      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/model-lab-api/projects/{project_id}/star      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/model-lab-api/projects/{project_id}/star  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/model-lab-api/projects/{project_id}/star |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/model-lab-api/projects/{project_id}/star     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/model-lab-api/projects/{project_id}/star |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/model-lab-api/projects/{project_id}/star |

## [Remove star from a Model Lab project →](https://docs.datadoghq.com/api/latest/model-lab-api/remove-star-from-a-model-lab-project.md) preview{% #remove-star-from-a-model-lab-project %}

| Datadog site      | API endpoint                                                                         |
| ----------------- | ------------------------------------------------------------------------------------ |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/model-lab-api/projects/{project_id}/star |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/model-lab-api/projects/{project_id}/star |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/model-lab-api/projects/{project_id}/star      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/model-lab-api/projects/{project_id}/star      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/model-lab-api/projects/{project_id}/star  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/model-lab-api/projects/{project_id}/star |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/model-lab-api/projects/{project_id}/star     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/model-lab-api/projects/{project_id}/star |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/model-lab-api/projects/{project_id}/star |

## [List Model Lab runs →](https://docs.datadoghq.com/api/latest/model-lab-api/list-model-lab-runs.md) preview{% #list-model-lab-runs %}

| Datadog site      | API endpoint                                                |
| ----------------- | ----------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/model-lab-api/runs |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/model-lab-api/runs |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/model-lab-api/runs      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/model-lab-api/runs      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/model-lab-api/runs  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/model-lab-api/runs |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/model-lab-api/runs     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/model-lab-api/runs |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/model-lab-api/runs |

## [Get a Model Lab run →](https://docs.datadoghq.com/api/latest/model-lab-api/get-a-model-lab-run.md) preview{% #get-a-model-lab-run %}

| Datadog site      | API endpoint                                                         |
| ----------------- | -------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/model-lab-api/runs/{run_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/model-lab-api/runs/{run_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/model-lab-api/runs/{run_id}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/model-lab-api/runs/{run_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/model-lab-api/runs/{run_id}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/model-lab-api/runs/{run_id} |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/model-lab-api/runs/{run_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/model-lab-api/runs/{run_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/model-lab-api/runs/{run_id} |

## [Delete a Model Lab run →](https://docs.datadoghq.com/api/latest/model-lab-api/delete-a-model-lab-run.md) preview{% #delete-a-model-lab-run %}

| Datadog site      | API endpoint                                                            |
| ----------------- | ----------------------------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/model-lab-api/runs/{run_id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/model-lab-api/runs/{run_id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/model-lab-api/runs/{run_id}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/model-lab-api/runs/{run_id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/model-lab-api/runs/{run_id}  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/model-lab-api/runs/{run_id} |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/model-lab-api/runs/{run_id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/model-lab-api/runs/{run_id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/model-lab-api/runs/{run_id} |

## [Pin a Model Lab run →](https://docs.datadoghq.com/api/latest/model-lab-api/pin-a-model-lab-run.md) preview{% #pin-a-model-lab-run %}

| Datadog site      | API endpoint                                                              |
| ----------------- | ------------------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/model-lab-api/runs/{run_id}/pin |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/model-lab-api/runs/{run_id}/pin |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/model-lab-api/runs/{run_id}/pin      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/model-lab-api/runs/{run_id}/pin      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/model-lab-api/runs/{run_id}/pin  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/model-lab-api/runs/{run_id}/pin |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/model-lab-api/runs/{run_id}/pin     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/model-lab-api/runs/{run_id}/pin |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/model-lab-api/runs/{run_id}/pin |

## [Unpin a Model Lab run →](https://docs.datadoghq.com/api/latest/model-lab-api/unpin-a-model-lab-run.md) preview{% #unpin-a-model-lab-run %}

| Datadog site      | API endpoint                                                                |
| ----------------- | --------------------------------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/model-lab-api/runs/{run_id}/pin |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/model-lab-api/runs/{run_id}/pin |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/model-lab-api/runs/{run_id}/pin      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/model-lab-api/runs/{run_id}/pin      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/model-lab-api/runs/{run_id}/pin  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/model-lab-api/runs/{run_id}/pin |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/model-lab-api/runs/{run_id}/pin     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/model-lab-api/runs/{run_id}/pin |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/model-lab-api/runs/{run_id}/pin |

## [List Model Lab run facet keys →](https://docs.datadoghq.com/api/latest/model-lab-api/list-model-lab-run-facet-keys.md) preview{% #list-model-lab-run-facet-keys %}

| Datadog site      | API endpoint                                                      |
| ----------------- | ----------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/model-lab-api/facet-keys |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/model-lab-api/facet-keys |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/model-lab-api/facet-keys      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/model-lab-api/facet-keys      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/model-lab-api/facet-keys  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/model-lab-api/facet-keys |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/model-lab-api/facet-keys     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/model-lab-api/facet-keys |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/model-lab-api/facet-keys |

## [List Model Lab run facet values →](https://docs.datadoghq.com/api/latest/model-lab-api/list-model-lab-run-facet-values.md) preview{% #list-model-lab-run-facet-values %}

| Datadog site      | API endpoint                                                        |
| ----------------- | ------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/model-lab-api/facet-values |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/model-lab-api/facet-values |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/model-lab-api/facet-values      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/model-lab-api/facet-values      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/model-lab-api/facet-values  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/model-lab-api/facet-values |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/model-lab-api/facet-values     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/model-lab-api/facet-values |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/model-lab-api/facet-values |

## [List Model Lab run artifacts →](https://docs.datadoghq.com/api/latest/model-lab-api/list-model-lab-run-artifacts.md) preview{% #list-model-lab-run-artifacts %}

| Datadog site      | API endpoint                                                                   |
| ----------------- | ------------------------------------------------------------------------------ |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/model-lab-api/runs/{run_id}/artifacts |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/model-lab-api/runs/{run_id}/artifacts |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/model-lab-api/runs/{run_id}/artifacts      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/model-lab-api/runs/{run_id}/artifacts      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/model-lab-api/runs/{run_id}/artifacts  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/model-lab-api/runs/{run_id}/artifacts |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/model-lab-api/runs/{run_id}/artifacts     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/model-lab-api/runs/{run_id}/artifacts |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/model-lab-api/runs/{run_id}/artifacts |

## [List Model Lab project artifacts →](https://docs.datadoghq.com/api/latest/model-lab-api/list-model-lab-project-artifacts.md) preview{% #list-model-lab-project-artifacts %}

| Datadog site      | API endpoint                                                                           |
| ----------------- | -------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/model-lab-api/projects/{project_id}/artifacts |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/model-lab-api/projects/{project_id}/artifacts |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/model-lab-api/projects/{project_id}/artifacts      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/model-lab-api/projects/{project_id}/artifacts      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/model-lab-api/projects/{project_id}/artifacts  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/model-lab-api/projects/{project_id}/artifacts |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/model-lab-api/projects/{project_id}/artifacts     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/model-lab-api/projects/{project_id}/artifacts |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/model-lab-api/projects/{project_id}/artifacts |

## [Get Model Lab artifact content →](https://docs.datadoghq.com/api/latest/model-lab-api/get-model-lab-artifact-content.md) preview{% #get-model-lab-artifact-content %}

| Datadog site      | API endpoint                                                             |
| ----------------- | ------------------------------------------------------------------------ |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/model-lab-api/artifacts/content |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/model-lab-api/artifacts/content |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/model-lab-api/artifacts/content      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/model-lab-api/artifacts/content      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/model-lab-api/artifacts/content  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/model-lab-api/artifacts/content |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/model-lab-api/artifacts/content     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/model-lab-api/artifacts/content |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/model-lab-api/artifacts/content |