Resume an existing run

Resumes an existing run, setting its status back to RUNNING. Returns the same response format as create. Use this when you want to log additional data (e.g., evaluation metrics) to a previously completed run. Provide exactly one of: runId (numeric), displayId (e.g., ‘MMP-1’), or externalId (user-provided).

POST /api/runs/resume

Resume an existing run

cURL

curl --request POST \
  --url https://pluto-api.trainy.ai/api/runs/resume \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "runId": 123,
  "displayId": "MMP-1",
  "externalId": "my-training-run-v1",
  "projectName": "my-project"
}
'

200

{
  "runId": 123,
  "number": 123,
  "displayId": "<string>",
  "projectName": "<string>",
  "organizationSlug": "<string>",
  "url": "<string>",
  "resumed": true
}

Authorizations

Authorization · string · header · required

API key obtained from the mlop dashboard

Body

application/json

runId · number

Numeric ID of the run to resume

Example:

123

displayId · string

Human-readable display ID (e.g., 'MMP-1')

Example:

"MMP-1"

externalId · string

User-provided external ID

Example:

"my-training-run-v1"

projectName · string

Project name (required when using externalId, since externalId is scoped to a project)

Example:

"my-project"

Response

200

application/json

Run resumed successfully

runId · number · required

Numeric ID of the resumed run

number · number | null · required

Sequential run number within the project

displayId · string | null · required

Human-readable display ID (e.g., 'MMP-1')

projectName · string · required

Name of the project

organizationSlug · string · required

Organization slug

url · string · required

URL to view the run

resumed · boolean · required

Always true for this endpoint