Fous Docs
Open Studio
FousDocs
esc
Studio

Retry a build

Retry a failed or cancelled build, updating access and authorizing live tests when required.

POST/v1/builds/{build_id}/retry

Submits a failed or cancelled build again with the same prompt, optionally with other connections or keys. Live tests can repeat real actions. Show the BuildRiskAcknowledgment notice and obtain fresh explicit authorization. Needs tools:write.

Requires Authorization: Bearer $FOUS_API_KEY. Create a key.

Path parameters

  • build_idstringrequired

Headers

  • Idempotency-Keystring

Request body

Required. JSON.

  • risk_acknowledgmentBuildRiskAcknowledgment

    Required once a managed build notice is active. A missing or outdated acknowledgment returns 409 risk_acknowledgment_required with the exact current notice in error.details.notice. Present its full text and affirmation and obtain explicit authorization before each build, edit or user-requested retry, then send its version. Live tests and repairs can perform repeated real actions. Never infer authorization from a request to build a tool.

  • connectionsobject
  • environmentobject

Response 202

Admitted

  • successtruerequired
  • dataBuildrequired

    A build: from queued through exploring, compiling, verifying and publishing to ready, failed or cancelled. Once ready, api names the tool and method its operation; prepared_request carries an input the builder verified it with.

Errors

Every failure is an Error: branch on error.code. The errors guide lists each code.

  • 400
  • 401WWW-Authenticate
  • 402
  • 403
  • 404
  • 408
  • 409
  • 410
  • 413
  • 422
  • 429Retry-After
  • 500
  • 502
  • 503Retry-After
  • 504