Add support for API artifact uploads and enhance import functionality

[Piumal1999]

Purpose

Enable users to import an API into the Developer Portal using a ZIP file that contains the all the related content.

Approach

Extended the existing POST /apis flow to detect and process API artifact uploads via multipart apiArtifact input, while preserving the existing metadata+definition path.

Also added artifact-based update support in PUT /apis/:apiId (and org-scoped equivalents), reusing the same artifact parsing/import logic.

Allowed API artifact ZIP structure

• manifest.yaml (optional path overrides)
• devportal-api.yaml (required)
• devportal-api-definition.yaml (required)
• docs/ (optional)
• apiContent/ (optional)

Refer to the newly added doc for more info on this

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 28a26fd1-5ffe-4df9-9174-ce5dab763a7e

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

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 and usage tips.}