Workflows

Resume a failed run

Retry the failed Action of a failed run with the same inputs; finished Actions and finished units keep their outputs, and the olives already spent are not charged again. A run that failed because an Action needs revision fails the same way when resumed unchanged: change the inputs and start a new run instead. Answers 200 with the run, pending again; poll GET /v1/runs/{runId}.

post/v1/runs/{runId}/resume

Request

  • Base URL: https://api.martini.film
  • URL: https://api.martini.film/v1/runs/{runId}/resume
  • Auth: HTTP bearer

Path parameters

runIdstring required

The run id.

Response

The run, pending again.

compileboolean

True for a script build, which generates no media.

thenRunIdstring nullable

Present only when a build will automatically start execution. Null until handoff: keep polling this build, including after completed, until the execution id appears. Then poll /v1/runs/{thenRunId} for media results. Absent for build-only requests.

idstring required
fingerprintstring required
workflowIdstring
status'pending' | 'awaiting_approval' | 'running' | 'paused' | 'completed' | 'failed' | 'needs_revision' | 'cancelled' required
phasestring nullable required

What Martini is doing right now ("unit 3/7 · waiting on generations"), the line the app shows. Display copy, not parseable; null unless the run is running.

origin'ui' | 'chat' | 'mcp' | 'api' required
createdAtstring required
startedAtstring nullable required
completedAtstring nullable required
errorstring nullable required
errorCode'model_provider_unavailable' nullable required

Why a failed run failed, as a stable code to branch on; error carries the copy for a human. Null unless the run failed and Martini can name the cause. model_provider_unavailable: the AI model provider (Anthropic) kept failing or could not be reached, so the run stopped. The workflow and its inputs did not cause it: start the run again.

variablesobject required
binsobject required
openInMartinistring required

Changes

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