Feat (Insomnia): Explain automated SCIM token refresh #3858

TuannasCodeCatastrophe · 2026-01-08T15:32:45Z

Description

Jobs to be done (optional)
As an administrator managing SCIM provisioning, I want SCIM tokens to automatically refresh so that I do not need to regenerate them manually every 90 days.
If automatic refresh fails, I should receive clear guidance — both in the product UI — so I know what went wrong and how to fix it.

Definition of done
Update the following Doc: https://developer.konghq.com/insomnia/scim/

MVP:
Remove FAQ about token refresh

Nice to have:
Include the following information:

Explain that SCIM tokens now automatically refresh before expiration.
Define where the admin can view the token information
Describe what happens during failure.
Add explicit guidance explaining that when SCIM is enabled, it does not modify, remove, or reconcile users who were manually added prior to enabling SCIM. This is a known and expected behavior.
Post meeting 7 JAN: SCIM page to be uplifted to focus on user journey and avoid users main pain points (manually managed users and understanding license consumption.)
Information
Jira

Due date (optional)
14 Jan

Size
M

Fixes #3671

Preview Links

https://deploy-preview-3858--kongdeveloper.netlify.app/insomnia/scim/

Checklist

Tested how-to docs. If not, note why here.
All pages contain metadata.
Any new docs link to existing docs.
All autogenerated instructions render correctly (API, decK, Konnect, Kong Manager).
Style guide (capitalized gateway entities, placeholder URLs) implemented correctly.
Every page has a description entry in frontmatter.
Add new pages to the product documentation index (if applicable).

CLAassistant · 2026-01-08T15:32:56Z

All committers have signed the CLA.

netlify · 2026-01-08T15:33:35Z

✅ Deploy Preview for kongdeveloper ready!

Name	Link
🔨 Latest commit	`4aed09b`
🔍 Latest deploy log	https://app.netlify.com/projects/kongdeveloper/deploys/69668d9b1d70680008813da4
😎 Deploy Preview	https://deploy-preview-3858--kongdeveloper.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

app/insomnia/scim.md

cloudjumpercat

Left some suggestions, let me know if you have any questions!

app/insomnia/scim.md

Signed-off-by: Diana <[email protected]>

cloudjumpercat

LGTM! and approved by PM https://kongstrong.slack.com/archives/CLDMTEH5M/p1768328564309359?thread_ts=1768326492.526189&cid=CLDMTEH5M

* Feat (Insomnia) View Enterprise Organization count and User-role badges added (#3822) * INS-1685 Insomnia Admin - Org Count, Sort Order, and User's Role * vale fixes * tweak * formatting tweak * Update app/insomnia/enterprise-account-management.md Co-authored-by: tomek-labuk <[email protected]> --------- Co-authored-by: TuannasCodeCatastrophe <[email protected]> Co-authored-by: tomek-labuk <[email protected]> * updated ling for git sync storage (#3823) Co-authored-by: TuannasCodeCatastrophe <[email protected]> * Feat (Insomnia): External Vault/ Allow empty credential configs to work with different cloud providers (#3840) * Content added 2 FAQs * commit to fix view error * tweak numero dos --------- Co-authored-by: TuannasCodeCatastrophe <[email protected]> * Feat (Insomnia): Outline Git and Cloud Sync support for MCP (#3873) * refined content to not mention mcp clients being unsupported in any project, and clarified mcp clients availability. * add new in label --------- Co-authored-by: TuannasCodeCatastrophe <[email protected]> Co-authored-by: Diana <[email protected]> * Feat (Insomnia): Explain automated SCIM token refresh (#3858) * First pass - SCIM uplift * Vale fix * updated related resourced section * applied PM feedback AND added full expanded FAQ from 3869 * fix SCIM note * Apply suggestions from code review * Small wording changes Signed-off-by: Diana <[email protected]> * Stronger wording for token failure Signed-off-by: Diana <[email protected]> --------- Signed-off-by: Diana <[email protected]> Co-authored-by: TuannasCodeCatastrophe <[email protected]> Co-authored-by: Diana <[email protected]> * feat(insomnia): Git sync credentials (#3898) * Change Cloud Credentials tab name, add info about where you can add credentials Signed-off-by: Diana <[email protected]> * fix the cloud credentials and credentials version thingy Signed-off-by: Diana <[email protected]> * Apply suggestions from code review Co-authored-by: lena-larionova <[email protected]> --------- Signed-off-by: Diana <[email protected]> Co-authored-by: lena-larionova <[email protected]> * Add 12.3 version and mark as latest Signed-off-by: Diana <[email protected]> --------- Signed-off-by: Diana <[email protected]> Co-authored-by: Cora <[email protected]> Co-authored-by: TuannasCodeCatastrophe <[email protected]> Co-authored-by: tomek-labuk <[email protected]> Co-authored-by: lena-larionova <[email protected]>

TuannasCodeCatastrophe added this to the Insomnia V12.3 milestone Jan 8, 2026

TuannasCodeCatastrophe self-assigned this Jan 8, 2026

TuannasCodeCatastrophe requested a review from a team as a code owner January 8, 2026 15:32

TuannasCodeCatastrophe added do not merge Issues/ PRs whose changes should not be merged at this time release-docs Docs for release product:insomnia labels Jan 8, 2026