Runs

Delete Runs

Changed on

Deletes up to 250 runs in one fail-soft, non-transactional request. Each run is processed independently. A valid batch returns 200 even when some items fail; inspect results and summary for per-run outcomes. Invalid request bodies are rejected before mutating any run.

post/api/v1/runs/delete

Request

  • The document declares no server URL.
  • Auth
    • HTTP bearer
    • or API key in cookie __fabro_session

Request body

run_idsstring[] required

Run IDs to process, in result order.

forceboolean

Whether to force deletion of active runs. Defaults to false.

Example request

{
  "run_ids": [
    "01HZX6M29F1CD5YYMHT1F5D7WQ"
  ]
}

Response

Batch processed

Example response

{
  "results": [
    {
      "sandbox": {
        "provider": "docker"
      },
      "error": {
        "status": "404",
        "title": "Not Found",
        "detail": "Run not found.",
        "code": "access_token_expired"
      }
    }
  ]
}

Changes

  • efc644ab09d4Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property /// to the response with the status

  • 478e995209e9Revision changes
    • info

      removed the daytona enum value from the /// response property for the response status

    • info

      removed the docker enum value from the /// response property for the response status

    • info

      removed the local enum value from the /// response property for the response status

    • info

      the /// response's property pattern ^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$ was added for the status