misc: fixes of api token spec

[kamal-devtron]

Description

Fixes #

Checklist:

• The title of the PR states what changed and the related issues number (used for the release note).
• Does this PR requires documentation updates?
• I've updated documentation as required by this PR.
• I have performed a self-review of my own code.
• I have commented my code, particularly in hard-to-understand areas.
• I have tested it for all user roles.
• I have added all the required unit/api test cases.

Does this PR introduce a user-facing change?

Summary by Bito

This pull request comprehensively refines the API specification by fixing formatting issues, standardizing structure, and addressing inconsistencies in security configurations. It adds a servers section, updates endpoint definitions, implements a dedicated API key authentication mechanism, and ensures consistent documentation across all endpoints, improving clarity and reliability.

[bito-code-review]

Code Review Agent Run #96e08d

Actionable Suggestions - 0

Review Details

• Files reviewed - 1 · Commit Range: dd7d821..dd7d821

  • specs/swagger/openapi.yaml
• Files skipped - 0
• Tools

  • Whispers (Secret Scanner) - ✔︎ Successful
  • Detect-secrets (Secret Scanner) - ✔︎ Successful

---

Bito Usage Guide

Commands

Type the following command in the pull request comment and save the comment.

• /review - Manually triggers a full AI review.

• /pause - Pauses automatic reviews on this pull request.

• /resume - Resumes automatic reviews.

• /resolve - Marks all Bito-posted review comments as resolved.

• /abort - Cancels all in-progress reviews.

Refer to the documentation for additional commands.

Configuration

This repository uses Default Agent You can customize the agent settings here or contact your Bito workspace admin at shivam@devtron.ai.

Documentation & Help

• Customize agent settings
• Review rules
• General documentation
• FAQ

AI Code Review powered by

[bito-code-review]

Changelist by Bito

This pull request implements the following key changes.

Key Change	Files Impacted
Bug Fix - API Token Spec Bug Fixes	- apiToken_api-spec.yaml - Updated API token endpoints with corrected server paths, refined summaries, and added security configurations.
Feature Improvement - Swagger Spec Improvements	- openapi.yaml - Refined security definitions, updated tag associations, corrected endpoint and parameter descriptions, standardized enum listings and schema definitions, and enhanced overall documentation clarity.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[bito-code-review]

Code Review Agent Run #57883f

Actionable Suggestions - 0

Review Details

• Files reviewed - 1 · Commit Range: dd7d821..bf0b9d8

  • specs/apiToken_api-spec.yaml
• Files skipped - 0
• Tools

  • Whispers (Secret Scanner) - ✔︎ Successful
  • Detect-secrets (Secret Scanner) - ✔︎ Successful

---

Bito Usage Guide

Commands

Type the following command in the pull request comment and save the comment.

• /review - Manually triggers a full AI review.

• /pause - Pauses automatic reviews on this pull request.

• /resume - Resumes automatic reviews.

• /resolve - Marks all Bito-posted review comments as resolved.

• /abort - Cancels all in-progress reviews.

Refer to the documentation for additional commands.

Configuration

This repository uses Default Agent You can customize the agent settings here or contact your Bito workspace admin at shivam@devtron.ai.

Documentation & Help

• Customize agent settings
• Review rules
• General documentation
• FAQ

AI Code Review powered by