---
title: "Run a reliability test for a service."
method: POST
path: "/reliability-tests/{reliabilityTestId}/runs"
tags: ["reliability-tests"]
---

# Run a reliability test for a service.

`POST /reliability-tests/{reliabilityTestId}/runs`

Requires the privilege [`SERVICES_RUN`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Path parameters

- `reliabilityTestId` string, required

## Query parameters

- `teamId` string, required

## Request body

- ReliabilityTestRunParameters — Represents a request with parameters necessary to run a reliability test for a service, dependency (optional) or failure flag name (optional)
  - `serviceId` string, required
  - `dependencyId` string
  - `failureFlagName` string

## Response `201`

The started reliability test run

## Other responses

- `400` — Invalid request, e.g. mutually exclusive params both set, the test does not support the requested dependency/failure flag, or the service is not eligible to run the test
- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege for target team: SERVICES_RUN
- `404` — Reliability test is not part of the team's test suite, the service was not found, or the referenced dependency was not found
- `409` — Reliability management is not available for the company

## Changes

- **2026-09-02** `358b43b8f258` — 4 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `404`
  - added the non-success response with the status `409`
  - added the success response with the status `201`

[Change history](https://skmtc.dev/gremlin/apis/gremlin-api/changes/reliability-tests/:reliabilityTestId/runs/post.md)

---

[API](https://skmtc.dev/gremlin/apis/gremlin-api.md) · [All operations](https://skmtc.dev/gremlin/apis/gremlin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gremlin/gremlin-api/revisions/358b43b8f258/schema)