From 76fe3ba086f9bcab4455de6b032a672bc2ffb6cf Mon Sep 17 00:00:00 2001 From: Julius Jogela Date: Fri, 14 Aug 2026 16:00:07 +0100 Subject: [PATCH 1/3] docs(ipa0132): require core metadata fields in the correct example --- ipa/general/0132.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/ipa/general/0132.mdx b/ipa/general/0132.mdx index 20679a9..1b49f62 100644 --- a/ipa/general/0132.mdx +++ b/ipa/general/0132.mdx @@ -1418,6 +1418,7 @@ components: schemas: OperationResponse: type: object + required: [operationId, operationType, createdAt, updatedAt] properties: operationId: type: string @@ -1438,7 +1439,8 @@ components: The OperationResponse exposes a stable identifier, a standard operation kind, and record timestamps, so generic clients and tooling can identify the operation, understand what kind of work it represents, and tell when its - status last changed. + status last changed. The four core fields are declared required, while + `customMethod` stays optional because it applies only to `CUSTOM` operations. From 9444a684c6ce59e80accb740b59a7a6ee9a4158e Mon Sep 17 00:00:00 2001 From: Julius Jogela Date: Mon, 17 Aug 2026 10:43:49 +0100 Subject: [PATCH 2/3] docs(ipa0132): require the status field in the status enum example --- ipa/general/0132.mdx | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/ipa/general/0132.mdx b/ipa/general/0132.mdx index 1b49f62..d07a4cf 100644 --- a/ipa/general/0132.mdx +++ b/ipa/general/0132.mdx @@ -1032,6 +1032,7 @@ components: schemas: OperationResponse: type: object + required: [status] properties: status: type: string @@ -1039,8 +1040,8 @@ components: ``` - The OperationResponse schema reports its lifecycle through a single status - field whose enum is exactly [PENDING, IN_PROGRESS, SUCCEEDED, FAILED, + The OperationResponse schema reports its lifecycle through a single required + status field whose enum is exactly [PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED, SUPERSEDED], so a generic client can reason about any operation the same way and SUCCEEDED is the single success terminal. From 86ea117601bc137324347be1ab3fc470a46d5255 Mon Sep 17 00:00:00 2001 From: Julius Jogela Date: Mon, 17 Aug 2026 11:10:37 +0100 Subject: [PATCH 3/3] docs(ipa0132): fix the List incorrect example path --- ipa/general/0132.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ipa/general/0132.mdx b/ipa/general/0132.mdx index d07a4cf..eaa5bb0 100644 --- a/ipa/general/0132.mdx +++ b/ipa/general/0132.mdx @@ -210,7 +210,7 @@ paths: ```yaml paths: - /orders/{orderId}: + /orders: get: operationId: listOrders responses: