# Build a stateful users API

> Create a REST mock, store users, return them by ID, and prove the missing-user branch.

- Canonical URL: https://dotmock.com/docs/quickstart
- Capability status: Available
- Last verified: 2026-07-24

## Prerequisites
- A DotMock workspace you can access
- The API ID in $API_ID and its published runtime URL in $MOCK_URL when the example calls the mock

## In this guide
- Create a REST workspace
- Add the users-by-id state resource
- Create and store a user
- Read the user and model the 404
- Merge a partial update
- Prove the behavior safely

## Verified boundaries
- Management commands require a DotMock credential; calls to $MOCK_URL use only credentials configured for the mock runtime.

Read the canonical guide for its complete examples and expected results: https://dotmock.com/docs/quickstart