docs: document allowQueue parameter for job execution creation

[devin-ai-integration]

Summary

Documents the new allowQueue parameter on job execution creation (blaxel-ai/controlplane#5229).

• Jobs/Manage-job-execution-ts.mdx and Jobs/Manage-job-execution-py.mdx: new "Reject immediately when capacity is unavailable" section. Omitted or true keeps queue-and-retry; allowQueue: false (Python allow_queue=False) checks capacity synchronously and returns 429 (temporary shortage) or 400 (never fits quota), with no execution created and nothing queued on rejection.

POST .../jobs/my-job/executions
{"tasks":[{}],"allowQueue":false}

• api-reference/controlplane.yml: synced from controlplane main (same copy the poll-upstream workflow performs) so the Management API reference shows allowQueue on CreateJobExecutionRequest. The sync also picks up the unrelated upstream SandboxInfrastructureError schema added since the last auto-update.

Companion SDK PRs: blaxel-ai/sdk-typescript#431, blaxel-ai/sdk-python#226.

Link to Devin session: https://app.devin.ai/sessions/829498efd05742f79300261953889d6d
Requested by: @drappier-charles

---

Note

Low Risk
Documentation and OpenAPI schema updates only; no runtime or security behavior changes in this repo.

Overview
Documents the new allowQueue / allow_queue flag on job execution creation so callers can fail fast when workspace capacity is full instead of queueing.

Python and TypeScript job-execution guides add a Reject immediately when capacity is unavailable section: default remains queue-and-retry; false checks capacity at create time and returns 429 (temporary) or 400 (never fits quota), with no execution created.

The OpenAPI spec adds allowQueue on CreateJobExecutionRequest. The same spec sync also introduces read-only sandbox errors and the SandboxInfrastructureError schema.

^{Reviewed by Cursor Bugbot for commit 01e5cdc. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

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

Project	Status	Preview	Updated (UTC)
blaxel	🟢 Ready	View Preview	Aug 21, 2026, 8:30 PM

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR that start with 'DevinAI' or '@devin'.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment, CI, and merge conflict monitoring

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.