agents

Reset To Upstream

Requests a fresh upstream root while preserving the assigned /data volume.

Active Agents reset now. Sleeping, stopped, and errored Agents keep their status and apply reset on their next boot. Each admitted POST is a new destructive request. After an uncertain result, start or restart continues existing intent; repeating this POST requests another reset.

post/api/agents/{agent_id}/reset-to-upstream

Request

  • Base URL
    https://api.maritime.sh (the document declares no server; this is the origin it was published from)
  • URL
    https://api.maritime.sh/api/agents/{agent_id}/reset-to-upstream
  • Auth
    HTTP bearer

Path parameters

agent_idstring required

Response

Successful Response

idstring required
namestring required
descriptionstring nullable
instructionsstring nullable
externalIdstring nullable
frameworkstring required
tierstring required
statusstring required
githubRepostring nullable
autoPairboolean
exposedPortinteger nullable
healthCheckPathstring nullable
hasWebUiboolean
templateIdstring nullable
publicPlayboolean
publicWebboolean
publicUrlstring nullable
visibility'private' | 'public'
webUrlstring nullable
desktopEnabledboolean
invocationCountinteger required
totalComputeSecondsinteger
memMbinteger nullable
vcpusnumber nullable
idleTtlSecondsinteger nullable
diskMbinteger nullable
computeMinutesLimitnumber nullable
sleepPolicystring
lastStartedAtstring date-time nullable
lastActiveAtstring date-time nullable
statusChangedAtstring date-time nullable
derivedImageTagstring nullable
browserbaseConfiguredboolean
projectIdstring nullable
projectRolestring nullable
createdAtstring date-time required
updatedAtstring date-time required

Changes

No recorded changes to this operation across all 2 revisions of this API.