You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<li>Use the <codeclass="language-plaintext highlighter-rouge">/Bulk/</code> endpoint for batch operations (up to 100 operations per request) and <codeclass="language-plaintext highlighter-rouge">/Users/</code> for single-user operations.</li>
1435
-
<li>Use <codeclass="language-plaintext highlighter-rouge">PATCH</code> operations instead of <codeclass="language-plaintext highlighter-rouge">PUT</code> for regular user updates to minimize error rates.</li>
1435
+
<li>Use <codeclass="language-plaintext highlighter-rouge">PATCH</code> operations instead of <codeclass="language-plaintext highlighter-rouge">PUT</code> for regular user updates to minimize data loss risk.</li>
1436
1436
<li>Track provision completion using the <codeclass="language-plaintext highlighter-rouge">provisionId</code> returned in the response, either via polling (with exponential backoff) or webhook notifications.</li>
1437
1437
<li>Pre-validate data before submission — most failures are caused by data validation issues.</li>
1438
1438
<li>When identity extensions fail, retry the entire operation after fixing the issue. When spend/travel extensions fail, retry only those extensions via a subsequent <codeclass="language-plaintext highlighter-rouge">PATCH</code> request.</li>
1439
-
<li>There is a 240-minute provision request timeout; please reach out to us with the <codeclass="language-plaintext highlighter-rouge">provisionId</code> if requests remain pending for an extended period.</li>
1440
1439
</ul>
1441
1440
1442
1441
<h3id="when-to-use-each-endpoint">When to Use Each Endpoint</h3>
@@ -1475,7 +1474,7 @@ <h3 id="when-to-use-each-endpoint">When to Use Each Endpoint</h3>
1475
1474
1476
1475
<h3id="operations-best-practices">Operations Best Practices</h3>
1477
1476
1478
-
<p>For regular user updates, use <codeclass="language-plaintext highlighter-rouge">PATCH</code>operations rather than <codeclass="language-plaintext highlighter-rouge">PUT</code>(full replace), whether for single user requests or bulk operations. This is the approach used by our large enterprise customers handling thousands of daily updates.</p>
1477
+
<p>Use <codeclass="language-plaintext highlighter-rouge">PUT</code> only for initial user creation (or intentional full replacement of a user). Use <codeclass="language-plaintext highlighter-rouge">PATCH</code>for <strong>ALL</strong> incremental user updates. Reissuing <codeclass="language-plaintext highlighter-rouge">PUT</code>overwrites the user and removes all previous edits. This is critical: large enterprise customers handling thousands of daily updates exclusively use <codeclass="language-plaintext highlighter-rouge">PATCH</code> to avoid unintended data loss.</p>
<h3id="handling-long-pending-provision-requests">Handling Long Pending Provision Requests</h3>
1683
1682
1684
-
<p>Currently the timeout for each provision request is 240 minutes. The provision request is marked as failure by the system if it exceeds the timeout.</p>
1685
-
1686
-
<p>If you have a provision request that is pending for a long time, please reach out to us with the <codeclass="language-plaintext highlighter-rouge">provisionId</code> for investigation. The operation can be retried after the timeout based on the failure scenarios mentioned above.</p>
1687
-
1688
-
<blockquote>
1689
-
<p><strong>Note:</strong> We have plans to reduce this timeout under 60 minutes.</p>
1690
-
</blockquote>
1683
+
<p>Currently the timeout for each provision request is <strong>120 minutes</strong> (60 minutes in CCPS environments). The provision request is marked as failure by the system if it exceeds the timeout. The operation can be retried after the timeout based on the failure scenarios mentioned above.</p>
0 commit comments