Skip to main content

Delete run

Endpoint: DELETE /runs/{run_id}

Description

Permanently deletes an evaluation run and its associated evaluations. You may delete a run if you own it (user on the run is your account), or the run is org-only (no individual owner) and you are an organization administrator in that run's organization.

Runs shared with your organization but owned by another user are visible via Get run but cannot be deleted with your API key — only the owning user (or an org admin for org-only runs) may delete them.

Parameters

  • Path: run_id — integer.

Error responses

  • 401 — Authentication failed.
  • 403 — Not allowed to delete (for example: not the owner, or org-only run without org-admin role).
  • 404 — Run not found or not accessible to your API key.
  • 400 — Database constraint or integrity error.
  • 500 — Server error.

Responses

  • 204 — No response body.

curl

curl -o /dev/null -w "%{http_code}\n" -X DELETE \
  "https://api.aegisevals.ai/api/v1/runs/991" \
  -H "Authorization: Bearer sk_00000000000000000000000000000000"