Runs

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

Request

  • Base URL
    https://pluto-api.trainy.ai
  • Auth
    HTTP bearer

Request body

runIdnumber

Numeric ID of the run to resume

displayIdstring

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

externalIdstring

User-provided external ID

projectNamestring

Project name. Required when using externalId (which is scoped to a project). Optional but recommended with displayId to disambiguate when distinct project names share a run-prefix.

Example request

{
  "runId": 123,
  "displayId": "MMP-1",
  "externalId": "my-training-run-v1",
  "projectName": "my-project"
}

Response

Run resumed successfully

runIdnumber required

Numeric ID of the resumed run

numbernumber nullable required

Sequential run number within the project

displayIdstring nullable required

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

projectNamestring required

Name of the project

organizationSlugstring required

Organization slug

urlstring required

URL to view the run

resumedboolean required

Always true for this endpoint

Changes

No recorded changes to this operation across all 1 revision of this API.