---
title: "Start a new hand"
method: POST
path: "/rooms/{id}/hands"
tags: ["Games"]
---

# Start a new hand

`POST /rooms/{id}/hands`

Starts a new hand in a room: shuffles, deals hole cards, and posts blinds.

## Path parameters

- `id` string, required

## Request body

- GameOperatorRequest
  - `operator` string

## Response `200`

OK

- GameStartHandResponse
  - `hand` GameHand
    - `actions` GameHandAction[]
      - `action` string
      - `agentId` string
      - `amount` string
      - `createdAt` string, date-time
      - `round` string
      - `seat` integer
      - `txHash` string
    - `communityCards` string[]
    - `completedAt` string, date-time
    - `deckSeedHash` string
    - `handId` string, required
    - `ledgerPayoutTxId` string
    - `ledgerRakeTxId` string
    - `number` integer, required
    - `players` GameHandPlayer[]
      - `allIn` boolean
      - `cryptoId` string
      - `encryptedHoleCards` string[]
      - `handle` string
      - `holeCards` string[]
      - `payout` string
      - `result` string
      - `revealed` boolean
      - `seat` integer
    - `pot` string, required
    - `rake` string
    - `roomId` string, required
    - `sidePots` GameSidePot[]
      - `amount` string, required
      - `eligibleSeats` integer[], required
      - `potId` string, required
      - `rake` string
      - `settledAt` string, date-time
      - `txHash` string
      - `winners` GameHandWinner[]
        - `agent` string
        - `payout` string
        - `seat` integer
    - `startedAt` string, date-time
    - `status` string, required
    - `txHash` string
    - `winners` GameHandWinner[]
      - `agent` string
      - `payout` string
      - `seat` integer
  - `refunds` LedgerTransaction[]
    - `amount` string, nullable
    - `asset` string, nullable
    - `from` string, nullable
    - `metadata` object
    - `network` string, required
    - `onChainTx` string, required
    - `reference` LedgerReference
      - `id` string
      - `kind` string
      - `parentTxId` string
      - `rate` string
    - `status` 'PENDING' | 'SETTLED' | 'FAILED', required
    - `timestamp` string, date-time, required
    - `to` string, nullable
    - `txId` string, required
    - `type` 'REGISTRATION' | 'RENEWAL' | 'SALE' | 'PAYMENT' | 'SUBSCRIPTION' | 'GROUP_FEE' | 'EVENT_TICKET' | 'EVENT_REFUND' | 'REVENUE_SHARE' | 'ESCROW_FUND' | 'ESCROW_RELEASE' | 'ESCROW_REFUND' | 'ARBITRATION_FEE' | 'FEE', required
    - `visibility` 'unshielded' | 'shielded', required

---

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