Skip to main content
GET
/
api
/
runs
/
list
List runs with optional search and tag filtering
curl --request GET \
  --url https://pluto-api.trainy.ai/api/runs/list \
  --header 'Authorization: Bearer <token>'
{
  "runs": [
    {
      "id": 123,
      "name": "<string>",
      "number": 123,
      "displayId": "<string>",
      "status": "<string>",
      "tags": [
        "<string>"
      ],
      "createdAt": "<string>"
    }
  ],
  "total": 123
}

Authorizations

Authorization
string
header
required

API key obtained from the mlop dashboard

Query Parameters

projectName
string
required

Project name

Example:

"my-project"

Search term for run names (substring match)

Example:

"training"

tags
string

Comma-separated list of tags to filter by (OR logic)

Example:

"baseline,experiment"

limit
number
default:50

Maximum number of runs to return

Required range: 1 <= x <= 200
Example:

50

Response

List of runs

runs
object[]
required
total
number
required

Total count of matching runs