Foreign vitals mapping: Update SCIM integration instructions

[noahtalerman]

• Update the best practice is to create an API-only user w/ the admin role and access only to necessary SCIM API endpoints
  • These doc updates require this bug to be fixed because the /scim/* API endpoints aren't exposed as API endpoints one can pick when creating an API only user
• Document the /scim/* API endpoints

Summary by CodeRabbit

• New Features
  • Added SCIM API endpoints for managing users and groups.
  • Supported actions include listing, creating, viewing, replacing, updating, and deleting SCIM users and groups.
  • Added read-only endpoints for SCIM schemas, service provider configuration, and resource types.

[claude]

Claude Code Review

This repository is configured for manual code reviews. Comment @claude review to trigger a review and subscribe this PR to future pushes, or @claude review once for a one-time review.

_{Tip: disable this comment in your organization's Code Review settings.}

[noahtalerman]

@rachaelshaw PR is ready for review!

[noahtalerman]

Hey @lucasmrod when you get the chance can you please double check the request/response examples for the SCIM endpoints? I got Claude's help writing them.

(I don't think your review blocks merge b/c we can tweak if they’re wrong)

FYI @rachaelshaw

[rachaelshaw]

Suggested change

	`DELETE /api/v1/fleet/scim/Users/{id}`
	`DELETE /api/v1/fleet/scim/Users/:id`

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 75f85711-13b6-47d1-8790-ac7b567960ff

📥 Commits

Reviewing files that changed from the base of the PR and between af2d4db and c8a090d.

⛔ Files ignored due to path filters (2)

• articles/foreign-vitals-map-idp-users-to-hosts.md is excluded by !**/*.md
• docs/REST API/rest-api.md is excluded by !**/*.md

📒 Files selected for processing (1)

• server/api_endpoints/api_endpoints.yml

---

Walkthrough

server/api_endpoints/api_endpoints.yml gains 15 new route entries under /api/v1/fleet/scim/. Full CRUD operations (GET list, POST, GET by ID, PUT, PATCH, DELETE) are declared for /Users and /Groups. Three read-only GET endpoints are added for /Schemas, /ServiceProviderConfig, and /ResourceTypes.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The description is missing the required template sections, including Related issue, checklist items, testing, and other required subsections.	Rewrite the PR description using the repository template and fill in the Related issue, checklist, testing, and other required sections.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title is concise and accurately reflects the SCIM integration instruction update.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch noahtalerman-patch-79

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 55.64%. Comparing base (af2d4db) to head (c8a090d).
⚠️ Report is 14 commits behind head on main.

Additional details and impacted files

@@             Coverage Diff             @@
##             main   #48413       +/-   ##
===========================================
- Coverage   67.48%   55.64%   -11.84%     
===========================================
  Files        3675     3675               
  Lines      233489   233535       +46     
  Branches    12230    12230               
===========================================
- Hits       157563   129947    -27616     
- Misses      61782    91607    +29825     
+ Partials    14144    11981     -2163     

Flag	Coverage Δ
backend	54.87% <ø> (-14.15%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.