Skip to content

fix(asm): add missing 429 responses and document rate-limit headers #31

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dmchaledev merged 1 commit into from
Jul 19, 2026
Merged

fix(asm): add missing 429 responses and document rate-limit headers #31

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 36 additions & 0 deletions asm/openapi.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -125,6 +125,8 @@ paths:
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
patch:
operationId: updateAsset
summary: Update asset
Expand All @@ -151,6 +153,8 @@ paths:
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
delete:
operationId: archiveAsset
summary: Archive asset
Expand All @@ -167,6 +171,8 @@ paths:
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'

/scans:
get:
Expand Down Expand Up @@ -199,6 +205,8 @@ paths:
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/RateLimited'
post:
operationId: triggerScan
summary: Trigger scan
Expand Down Expand Up @@ -255,6 +263,8 @@ paths:
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'

/vulnerabilities:
get:
Expand Down Expand Up @@ -308,6 +318,8 @@ paths:
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/RateLimited'

/vulnerabilities/{vuln_id}:
parameters:
Expand Down Expand Up @@ -336,6 +348,8 @@ paths:
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
patch:
operationId: updateVulnerability
summary: Update vulnerability
Expand All @@ -362,6 +376,8 @@ paths:
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'

/tags:
get:
Expand All @@ -385,6 +401,8 @@ paths:
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/RateLimited'
post:
operationId: createTag
summary: Create tag
Expand Down Expand Up @@ -418,6 +436,8 @@ paths:
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/RateLimited'

/tags/{tag_id}:
parameters:
Expand Down Expand Up @@ -527,6 +547,18 @@ components:
pattern: '^tag_[a-z0-9]{16}$'
example: tag_0001aabbccdd0001

headers:
X-RateLimit-Limit:
description: Maximum number of requests allowed per minute for this API key
schema:
type: integer
example: 600
X-RateLimit-Remaining:
description: Number of requests remaining in the current one-minute window
schema:
type: integer
example: 542

responses:
Unauthorized:
description: Missing or invalid API key
Expand Down Expand Up @@ -571,6 +603,10 @@ components:
schema:
type: integer
description: Seconds until the rate limit window resets
X-RateLimit-Limit:
$ref: '#/components/headers/X-RateLimit-Limit'
X-RateLimit-Remaining:
$ref: '#/components/headers/X-RateLimit-Remaining'
content:
application/json:
schema:
Expand Down
Loading