From 7159bad175de69f46a49e504d8632a65ef54e1bd Mon Sep 17 00:00:00 2001
From: saquib-adobe <ssiddique@adobe.com>
Date: Tue, 26 Nov 2024 01:40:02 +0530
Subject: [PATCH] Added the referrences of new API to the home page

---
 .../api-reference.md                          | 40 ++++++++++++++++++-
 1 file changed, 38 insertions(+), 2 deletions(-)

diff --git a/src/pages/edge/adobe-journey-optimizer-decisioning/api-reference.md b/src/pages/edge/adobe-journey-optimizer-decisioning/api-reference.md
index 95a32d7da0..6e2685a018 100644
--- a/src/pages/edge/adobe-journey-optimizer-decisioning/api-reference.md
+++ b/src/pages/edge/adobe-journey-optimizer-decisioning/api-reference.md
@@ -53,6 +53,22 @@ iOS
 
 <Tabs query="platform=ios&api=get-propositions"/>
 
+## getPropositionsWithTimeout
+
+This API retrieves the previously fetched propositions for the provided decision scopes from the in-memory extension propositions cache, similar to `getPropositions`. The completion callback is invoked with the decision propositions corresponding to the given decision scopes. If a certain decision scope has not been fetched prior to this API call, it will not be included in the returned propositions. 
+
+Additionally, this API allows specifying a timeout for the operation. If the propositions retrieval does not complete within the given timeout, an error is returned, providing improved control over handling delays and ensuring timely application responses.
+
+<TabsBlock orientation="horizontal" slots="heading, content" repeat="2"/>
+
+Android
+
+<Tabs query="platform=android&api=get-propositions-withTimeout"/>
+
+iOS
+
+<Tabs query="platform=ios&api=get-propositions-withTimeout"/>
+
 ## onPropositionsUpdate
 
 This API registers a permanent callback which is invoked whenever the Edge extension dispatches a response event with an `eventType` of `personalization.response`. Additionally, the callback is only invoked if the response event contains at least one valid offer. The personalization response can be triggered by the `updatePropositions` API.
@@ -116,11 +132,31 @@ Completion callback passed to `updatePropositions` supports network timeout and
 
 Android
 
-<Tabs query="platform=android&api=update-propositions-withError"/>
+<Tabs query="platform=android&api=update-propositions-withCallback"/>
+
+iOS
+
+<Tabs query="platform=ios&api=update-propositions-withCallback"/>
+
+## updatePropositionsWithCompletionHandlerWithCompletionTimeout
+
+This API dispatches an event for the Edge network extension to fetch decision propositions for the provided decision scopes array from the decisioning services enabled in the Experience Edge. Similar to `updatePropositionsWithCompletionHandler`, the returned decision propositions are cached in-memory within the Optimize SDK extension and can be retrieved using the `getPropositions` API. 
+
+Additionally, this API allows specifying a completion timeout, ensuring that the operation either completes within the given time frame or returns an error indicating a timeout. This feature provides better control over the responsiveness of the application when interacting with decisioning services.
+
+<InlineAlert variant="help" slots="text"/>
+
+Completion callback passed to `updatePropositions` supports network timeout and fatal errors returned by edge network along with fetched propositions data. The SDK's internal retry mechanism handles the recoverable HTTP errors. As a result, recoverable HTTP errors are not returned through this callback.
+
+<TabsBlock orientation="horizontal" slots="heading, content" repeat="2"/>
+
+Android
+
+<Tabs query="platform=android&api=update-propositions-withCallback-withTimeout"/>
 
 iOS
 
-<Tabs query="platform=ios&api=update-propositions-withError"/>
+<Tabs query="platform=ios&api=update-propositions-withCallback-withTimeout"/>
 
 ## Public classes