Skip to content

Document serverless run, status, and health CLI commands - #770

Open
promptless[bot] wants to merge 2 commits into
mainfrom
promptless/serverless-cli-run-health-status
Open

Document serverless run, status, and health CLI commands#770
promptless[bot] wants to merge 2 commits into
mainfrom
promptless/serverless-cli-run-health-status

Conversation

@promptless

@promptless promptless Bot commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

What changed

Documents three new invoke-time Serverless subcommands added to runpodctl in runpod/runpodctl#316 (CON-688), on the runpodctl serverless CLI reference page. The reference previously covered only the endpoint-management verbs (list, get, create, update, delete), so these were undocumented.

  • run — submit a job (via --input, --input-file, or stdin), wait for a terminal status, and print the response. Covers the JSON-object payload rule, the local 10 MiB request-body limit, automatic input nesting, --wait/--no-wait behavior (and that they are mutually exclusive), the stdout/stderr split, and exit codes with the new timeout and job_failed error semantics.
  • status — check or poll a previously submitted job by endpoint and job ID; the follow-up to run --no-wait or an expired wait.
  • health — print an endpoint's health response, with the caveat that it can answer for a recently deleted endpoint (invoke-side caching), so it is not a reliable existence check.

Notes

  • All claims are source-verified against the merged final state of PR Public endpoints: Update model-specific parameters, remove beta tags #316 (merge commit c094cac86526a446cb4358bcb100e5098f85885f), including the two validations added after the initial draft: the local 10 MiB /run body-size limit (measured on the compacted {"input": ...} request body) and the --no-wait/--wait mutual-exclusivity check, both rejected locally as usage errors before any request.
  • Single file touched: runpodctl/reference/runpodctl-serverless.mdx. The page is already in navigation; no config change needed.

Generated by Promptless.

promptless Bot added 2 commits August 4, 2026 20:14
Add reference sections for the new runpodctl serverless invoke-time
subcommands (run, status, health) introduced in runpod/runpodctl#316
(CON-688), including input/payload rules, wait behavior, exit codes,
and the timeout/job_failed error semantics.
@mintlify

mintlify Bot commented Aug 6, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
runpod-docs 🟢 Ready View Preview Aug 6, 2026, 9:45 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants