Skip to content

Commit f2ed2b4

Browse files
[skip ci] Updates
1 parent 3e627b3 commit f2ed2b4

2 files changed

Lines changed: 5 additions & 12 deletions

File tree

api-reference/user-provisioning/v4.user-provisioning.html

Lines changed: 3 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1432,11 +1432,10 @@ <h3 id="key-recommendations">Key Recommendations</h3>
14321432

14331433
<ul>
14341434
<li>Use the <code class="language-plaintext highlighter-rouge">/Bulk/</code> endpoint for batch operations (up to 100 operations per request) and <code class="language-plaintext highlighter-rouge">/Users/</code> for single-user operations.</li>
1435-
<li>Use <code class="language-plaintext highlighter-rouge">PATCH</code> operations instead of <code class="language-plaintext highlighter-rouge">PUT</code> for regular user updates to minimize error rates.</li>
1435+
<li>Use <code class="language-plaintext highlighter-rouge">PATCH</code> operations instead of <code class="language-plaintext highlighter-rouge">PUT</code> for regular user updates to minimize data loss risk.</li>
14361436
<li>Track provision completion using the <code class="language-plaintext highlighter-rouge">provisionId</code> returned in the response, either via polling (with exponential backoff) or webhook notifications.</li>
14371437
<li>Pre-validate data before submission — most failures are caused by data validation issues.</li>
14381438
<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 <code class="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 <code class="language-plaintext highlighter-rouge">provisionId</code> if requests remain pending for an extended period.</li>
14401439
</ul>
14411440

14421441
<h3 id="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>
14751474

14761475
<h3 id="operations-best-practices">Operations Best Practices</h3>
14771476

1478-
<p>For regular user updates, use <code class="language-plaintext highlighter-rouge">PATCH</code> operations rather than <code class="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 <code class="language-plaintext highlighter-rouge">PUT</code> only for initial user creation (or intentional full replacement of a user). Use <code class="language-plaintext highlighter-rouge">PATCH</code> for <strong>ALL</strong> incremental user updates. Reissuing <code class="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 <code class="language-plaintext highlighter-rouge">PATCH</code> to avoid unintended data loss.</p>
14791478

14801479
<h4 id="for-bulk-updates-hr-sync-daily-changes">For bulk updates (HR sync, daily changes)</h4>
14811480

@@ -1681,13 +1680,7 @@ <h3 id="reducing-failure-rates">Reducing Failure Rates</h3>
16811680

16821681
<h3 id="handling-long-pending-provision-requests">Handling Long Pending Provision Requests</h3>
16831682

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 <code class="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>
16911684

16921685
<h2 id="events"><a name="event-usage"></a>Events</h2>
16931686

feed.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@
55
<description>Concur docs provides comprehensive information on working with the Concur platform</description>
66
<link>https://preview.developer.concur.com/</link>
77
<atom:link href="https://preview.developer.concur.com/feed.xml" rel="self" type="application/rss+xml" />
8-
<pubDate>Tue, 05 May 2026 20:29:22 +0000</pubDate>
9-
<lastBuildDate>Tue, 05 May 2026 20:29:22 +0000</lastBuildDate>
8+
<pubDate>Wed, 06 May 2026 19:44:15 +0000</pubDate>
9+
<lastBuildDate>Wed, 06 May 2026 19:44:15 +0000</lastBuildDate>
1010
<generator>Jekyll v4.1.1</generator>
1111

1212
</channel>

0 commit comments

Comments
 (0)