---
title: "Roll dice using standard notation (e.g. 2d6+3, 4d8, d20). Supports comma-separated pools and keep-high/low (4d6kh3)."
method: POST
path: "/api/tools/dice_roll"
---

# Roll dice using standard notation (e.g. 2d6+3, 4d8, d20). Supports comma-separated pools and keep-high/low (4d6kh3).

`POST /api/tools/dice_roll`

## Request

- Base URL: `https://tools.moddable.games`
- URL: `https://tools.moddable.games/api/tools/dice_roll`
- Auth: none declared

## Request body

- object
  - `notation` string: Dice notation (e.g. 2d6+3, 4d6kh3, 3d8,1d12+2)
  - `expression` string: Alias for notation
  - `count` number: Number of times to roll (default 1)

## Response `200`

Tool result

---

[API](https://skmtc.dev/moddable/apis/moddable-games-tools.md) · [All operations](https://skmtc.dev/moddable/apis/moddable-games-tools/llms.txt) · [OpenAPI document](https://skmtc.dev/moddable/apis/moddable-games-tools/revisions/637a0b62cb9a?raw)