ACCS-1983 - companyRoles REST details

[jhadobe]

Purpose of this pull request

This pull request (PR) adds documentation for the new Adobe Commerce as a Cloud Service companyRoles REST endpoint (GET /V1/customers/:customerId/companyRoles). With one request, the endpoint returns every role and permission a customer holds across all assigned companies.

Affected pages

• https://developer.adobe.com/commerce/webapi/rest/saas-integrations/company-roles
• https://developer.adobe.com/commerce/webapi/rest/saas-integrations

What's New highlights

whatsnew
Added a Company roles page, which documents a REST endpoint that returns all of a customer's company roles and permissions in one request.

[github-actions]

🔍 Linter Report

Click to expand full report

═══════════════════════════════════════════════════════════════
                     LINTER REPORT
═══════════════════════════════════════════════════════════════

Generated: 2026-10-01T20:45:20.696Z
Mode: Full Linting (all rules + dead links check)
Target Directory: /home/runner/work/commerce-webapi/commerce-webapi
Skipped Rules:
  - check-frontmatter → src/pages/includes
  - missing-heading → src/pages/includes

───────────────────────────────────────────────────────────────

Files to process: 3

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/config.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 1:1
    Message: Missing frontmatter section - add --- at the beginning with title and description
    Rule: check-frontmatter


═══════════════════════════════════════════════════════════════
                        SUMMARY
═══════════════════════════════════════════════════════════════

  📁 Files processed:    3
  📄 Files with issues:  1
  ❌ Total errors:       0
  ⚠️  Total warnings:     1
  📋 Total issues:       1

Result: ⚠️  PASSED WITH WARNINGS - No fatal errors

═══════════════════════════════════════════════════════════════

---

This comment was automatically generated by the linter bot.

[github-actions]

🔍 Linter Report

Click to expand full report

═══════════════════════════════════════════════════════════════
                     LINTER REPORT
═══════════════════════════════════════════════════════════════

Generated: 2026-10-07T19:11:37.119Z
Mode: Full Linting (all rules + dead links check)
Target Directory: /home/runner/work/commerce-webapi/commerce-webapi
Skipped Rules:
  - check-frontmatter → src/pages/includes
  - missing-heading → src/pages/includes

───────────────────────────────────────────────────────────────

Files to process: 3

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/config.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 1:1
    Message: Missing frontmatter section - add --- at the beginning with title and description
    Rule: check-frontmatter


═══════════════════════════════════════════════════════════════
                        SUMMARY
═══════════════════════════════════════════════════════════════

  📁 Files processed:    3
  📄 Files with issues:  1
  ❌ Total errors:       0
  ⚠️  Total warnings:     1
  📋 Total issues:       1

Result: ⚠️  PASSED WITH WARNINGS - No fatal errors

═══════════════════════════════════════════════════════════════

---

This comment was automatically generated by the linter bot.

[github-actions]

🔍 Linter Report

Click to expand full report

═══════════════════════════════════════════════════════════════
                     LINTER REPORT
═══════════════════════════════════════════════════════════════

Generated: 2026-10-07T19:18:08.173Z
Mode: Full Linting (all rules + dead links check)
Target Directory: /home/runner/work/commerce-webapi/commerce-webapi
Skipped Rules:
  - check-frontmatter → src/pages/includes
  - missing-heading → src/pages/includes

───────────────────────────────────────────────────────────────

Files to process: 3

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/config.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 1:1
    Message: Missing frontmatter section - add --- at the beginning with title and description
    Rule: check-frontmatter


═══════════════════════════════════════════════════════════════
                        SUMMARY
═══════════════════════════════════════════════════════════════

  📁 Files processed:    3
  📄 Files with issues:  1
  ❌ Total errors:       0
  ⚠️  Total warnings:     1
  📋 Total issues:       1

Result: ⚠️  PASSED WITH WARNINGS - No fatal errors

═══════════════════════════════════════════════════════════════

---

This comment was automatically generated by the linter bot.