diff --git a/design.md b/design.md
index 235e0e9..790d176 100644
--- a/design.md
+++ b/design.md
@@ -185,12 +185,17 @@ This design assumes request/response pairs (HTTP-like protocols) but works for a
 
 ### API Design
 
-The system implements a RESTful API with three core endpoints:
+The system implements a RESTful API with the following core endpoints:
 
 1. **GET /v1/version**: Retrieve current committed version and leader
 2. **POST /v1/commit**: Submit transactional operations
-3. **GET /v1/subscribe**: Stream committed transactions (implied)
-4. **GET /v1/status**: Check commit status by request_id (implied)
+3. **GET /v1/subscribe**: Stream committed transactions
+4. **GET /v1/status**: Check commit status by request_id
+5. **PUT /v1/retention/<policy_id>**: Creates or updates a retention policy
+6. **GET /v1/retention/<policy_id>**: Retrieves a retention policy by ID
+7. **GET /v1/retention/**: Retrieves all retention policies
+8. **DELETE /v1/retention/<policy_id>**: Removes a retention policy
+9. **GET /metrics**: Retrieves server metrics for monitoring
 
 ### Performance Characteristics