---
title: "register, remove or clear gRPC chaos"
method: PUT
path: "/mockserver/grpcChaos"
tags: ["chaos"]
---

# register, remove or clear gRPC chaos

`PUT /mockserver/grpcChaos`

## Request

- Base URL: `http://localhost:1080`
- URL: `http://localhost:1080/mockserver/grpcChaos`
- Auth: none declared

Registers a gRPC chaos / fault-injection profile for a service, removes a service's profile, or clears all gRPC chaos. Supply a 'service' with a 'chaos' object to register, 'service' with 'remove':true (or no 'chaos') to remove a single service, or 'clear':true to clear all.

## Request body

- object: gRPC chaos registration, removal or clear instruction with 'service', optional 'chaos', 'remove', 'clear' and 'ttlMillis' fields

## Response `200`

chaos registered, removed, patched or cleared

- object

## Other responses

- `400`: invalid request body or invalid chaos profile

---

[API](https://skmtc.dev/mock-server/apis/mockserver-api.md) · [All operations](https://skmtc.dev/mock-server/apis/mockserver-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mock-server/apis/mockserver-api/revisions/9239b693996e?raw)