Skip to main content
Glama

runtime_jobs

Destructive

Jobs run a command in a fresh sandbox, once or on a cron schedule. Each run spends the free usage first while it fits the limits without credit, then credit at the sandbox rates, within your spending limits. An unknown outcome is never retried by itself. A run that cannot start says why in blockedReason (credits, capacity, cost_cap, permission) and tries again every 30 seconds. create(input), list, get, pause, resume and cancel(id), trigger(id): run it now, once, beside its schedule (a paused job stays paused; refused with run_in_progress while a run is starting or going), reschedule(id, schedule): a new schedule, the next run at its next time, runs(id): a job's attempts, run(id): one attempt, logs(id of a run, cursor?): its output.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
idNo
inputNocreate: {name, schedule: {kind: once, at (Unix ms; a past time runs at once)} or {kind: cron, expression (five fields), timezone? (IANA, default UTC)}, compute: {region (us-east), vcpu (1-16, usually 2), cpuMode (shared), cpuFloorMillis (50), memoryMiB (up to 65536, usually 4096), diskMiB (at least 3072), durationSeconds (the paid time per run, at most 3600, at least timeoutSeconds)}, command: {argv (no shell: ["bash", "-lc", "..."]), cwd? (under /workspace)}, timeoutSeconds, retry?: {maxAttempts (1-5), backoffSeconds}, secrets?: [{name, secretId}] (from runtime_secrets action jobs_put), maxTotalCostMicros?}.
limitNo
actionYes
cursorNo
scheduleNoreschedule: {kind: once, at (Unix ms; a past time runs at once)} or {kind: cron, expression (five fields), timezone? (IANA, default UTC)}.
limitBytesNo
idempotencyKeyNoOptional: left out, one is made and returned as idempotencyKey. Send it back only to retry this exact call after a temporary error.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "create",
      -  "list",
      -  "get",
      -  "pause",
      -  "resume",
      -  "cancel",
      -  "runs",
      -  "run",
      -  "logs"
      -]New value: +[
      +  "create",
      +  "list",
      +  "get",
      +  "pause",
      +  "resume",
      +  "cancel",
      +  "trigger",
      +  "reschedule",
      +  "runs",
      +  "run",
      +  "logs"
      +]
    • addedInput schema / properties / schedule
      Added value: +{
      +  "description": "reschedule: {kind: once, at (Unix ms; a past time runs at once)} or {kind: cron, expression (five fields), timezone? (IANA, default UTC)}.",
      +  "type": "object"
      +}
  2. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.