From 084c49e33f19407a2bea515b570fd42fa9716fec Mon Sep 17 00:00:00 2001 From: "Aaron K. Clark" Date: Tue, 19 May 2026 07:26:02 -0500 Subject: [PATCH] docs(openapi): declare Idempotency-Replay on POST /v1/timeentry 201 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Single-create POST sweep (#245) — second endpoint after /v1/customer in #246. Flows through the same /v1 idempotency middleware as every other POST; emits the Idempotency-Replay header on replay; declare it on the 201 so SDKs surface the flag. Co-Authored-By: Claude Opus 4.7 (1M context) --- app/config/openapi.js | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/app/config/openapi.js b/app/config/openapi.js index d14e5e8..b931698 100644 --- a/app/config/openapi.js +++ b/app/config/openapi.js @@ -638,7 +638,14 @@ const spec = { }, }, responses: { - 201: { description: 'Created' }, + 201: { + description: 'Created (or a replay of a previously-cached create)', + // Same Idempotency-Key middleware path as /v1/customer + // (#246) and the 13 bulk endpoints (#168 / #240). + // Declare the replay header so SDK generators surface + // the field on single-create writes. + headers: idempotencyReplayResponseHeader, + }, 400: { description: 'Bad request — missing teCustId or teStartedAt' }, 403: { description: 'Missing or invalid authKey' }, },