---
title: "Creates a reliability test suite"
method: POST
path: "/test-suites"
tags: ["test-suites"]
---

# Creates a reliability test suite

`POST /test-suites`

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

## Request body

- CreateTestSuiteRequest — Create a request to create a test suite for a team
  - `name` string, required
  - `targetTeamIds` string[]
  - `scenarios` TestSuiteScenario[], required
    - `name` string, required
    - `description` string, required
    - `policyCategory` 'OTHER' | 'REDUNDANCY' | 'SCALABILITY' | 'DEPENDENCIES' | 'RISKS' | 'EXTRA_CREDIT', required
    - `scenarioToPromote` ScenarioToPromote, required
      - `scenarioId` string, required
      - `scenarioType` 'RECOMMENDED' | 'SHARED' | 'GENERAL', required
      - `teamId` string
  - `excludedRiskIds` string[]

## Response `default`

default response

- TestSuiteResponse
  - `identifier` string
  - `name` string
  - `description` string
  - `testResponses` TestResponse[]
    - `testPolicy` TestPolicyResponse
      - `name` string
      - `description` string
      - `policyCategory` 'OTHER' | 'REDUNDANCY' | 'SCALABILITY' | 'DEPENDENCIES' | 'RISKS' | 'EXTRA_CREDIT'
      - `policyTarget` 'SERVICE' | 'SERVICE_DEPENDENCY'
      - `reliabilityTestId` string
    - `sourceScenarioId` string
    - `sourceScenarioType` 'RECOMMENDED' | 'SHARED' | 'GENERAL'
    - `sourceScenarioEditCounter` integer
  - `targetTeamIds` string[]
  - `excludedRiskIds` string[]
  - `default` boolean
  - `isDefault` boolean
  - `official` boolean
  - `isOfficial` boolean

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege: TEST_SUITES_WRITE

---

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