Various improvements #2

[Samze]

• Remove "Links" and replace with explicit links. This way the links for a resource are discoverable.
• Add missing 401 error to all but /,/v3,/v3/info endpoints
• Add missing location headers for 202 operations
• 201 is only for User provided service creation
• Update jobs to have specific links]
• Add missing request bodies for services
• Add support for https://swagger.io/docs/specification/v3_0/links/ for referencing relationships
• Add missing endpoints for revisions

[Copilot]

Pull Request Overview

This PR implements comprehensive API improvements including standardizing error responses, adding location headers for asynchronous operations, and removing the generic "Links" schema in favor of explicit link definitions.

• Remove generic "Links" schema and replace with explicit link properties for better discoverability
• Add missing 401 (Unauthorized) error responses to all endpoints except root, /v3, and /v3/info
• Add Location headers to 202 (Accepted) responses for asynchronous job operations
• Update service creation to return 201 only for user-provided services, 202 for managed services
• Add missing request body schemas for service operations

Reviewed Changes

Copilot reviewed 69 out of 69 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
Multiple path files	Add 401 error responses and Location headers for async operations
Schema files	Replace generic Links with explicit link properties
Request body files	Add new service instance and credential binding request body schemas
Info.yaml	Remove 401 error from info endpoint (correctly excluded)
openapi.yaml	Remove Links schema reference

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}