Praecise Platform
Menu

Praecise Cloud/ Reference/ Projects

Serve a kept release again

post/api/projects/{name}/rollback

Serve a kept release again. Answers when the release is live and healthy, which can take a few minutes; allow five. Anything that is not a kept release answers 400.

Before you call

Credential
Authorization: Bearer $KEY with rollback
Scope
rollback
Role
member

Parameters

  • namestringrequired
    In the path. The project's name.
  • Idempotency-Keystring
    Header. Send the same key when retrying. Within 24 hours the first successful answer is returned again, with Idempotent-Replayed: true, instead of running twice.

Request bodyapplication/json, required

  • releasestringrequired
    A release id from the kept releases, or "previous" for the release that was live before the current one.

Responses

  • 200application/json
    The release is live.

    object

  • 400application/json
    The request is not valid: a bad parameter, or a release that is not kept. Code bad_request or bad_release.
    • errorstringrequired
    • codestringrequired
  • 401application/json
    No token, or the token is unknown, revoked or expired. Code unauthenticated, token_revoked or token_expired.
    • errorstringrequired
    • codestringrequired
  • 403application/json
    The token lacks the scope, the call is not open to tokens, or the caller is not an owner. Code scope_missing, session_required or owner_required.
    • errorstringrequired
    • codestringrequired
  • 404application/json
    No such project, or one the caller cannot see. The two are not told apart. Code not_found.
    • errorstringrequired
    • codestringrequired
  • 409application/json
    A deploy is already running for the project, or the first request with this Idempotency-Key has not finished. Code deploy_running, no_source or request_in_progress.
    • errorstringrequired
    • codestringrequired
  • 422application/json
    The Idempotency-Key was already used for a different request. Code idempotency_key_reused.
    • errorstringrequired
    • codestringrequired
  • 429application/json
    Too many requests for this token. Retry-After says how many seconds to wait. Code rate_limited.
    • errorstringrequired
    • codestringrequired
  • 500application/json
    The rollback did not complete; the answer carries its output. Code rollback_failed.
    • errorstringrequired
    • codestringrequired

This page as Markdown