DEVDOCS-6249 - Content Refresh S2S Super Admin

[bc-terra]

DEVDOCS-6249

Reformatted file with reusable schemas.
Added new copy.
Added missing fields and parameters.
Adjusted responses to clarify structure.

What changed?

• Introduction presents relevant groundwork for Super Admins and the API.
• Endpoints now include clear summaries and descriptions.
• Request and response bodies are up-to-date, showing all available fields and parameters.
• YAML file is organized into several schema to reduce redundant text lines and improve efficiency for subsequent edits.

Release notes draft

• As part of our ongoing content refresh for B2B Edition developer documentation, we've fully refreshed the Server-to-Server Super Admin documentation. This includes
  • New, thorough descriptive copy
  • Explanation of complex error reporting
  • Inclusion of previously-missing fields for all endpoints

Anything else?

ping { @bc-Vince @CNanninga @BC-EEspinosa }

[bc-Vince]

Let me know if you need additional clarification on any of the questions in the comments.

[bc-Vince]

Is this field blank/null/etc if the Super Admin only has a storefront account and not a backend account?

[bc-terra]

From testing, whether/how uuid shows depends if it has a defined value. If the customer account doesn't have a UUID assigned, some endpoints will omit it. Endpoints that always show the UUID list it as an empty string, e.g. "uuid": "" in the response. Since BigCommerce customers usually don't have a UUID assigned by default, this is blank unless the merchant explicitly includes it.