Error codes

Every AIDE API error returns the same envelope: code + human-readable message + a request_id.

INVALID_URLHTTP 400
When
URL scheme or hostname is invalid (missing scheme, javascript:, etc.).
How to fix
Use https:// with a hostname that contains at least one dot.
SSRF_BLOCKEDHTTP 400
When
URL resolved to private network, loopback, or blocklist.
How to fix
Submit a URL that resolves to a public DNS name and public IP.
NOT_FOUNDHTTP 404
When
Specified scan_id or resource was not found.
How to fix
Pick an id from GET /v1/scans that still exists.
UNAUTHORIZEDHTTP 401
When
Authorization header is missing or malformed.
How to fix
Send the Authorization: Bearer aide_… header.
FORBIDDENHTTP 403
When
Key doesn't have access to this resource (shared resource, denied).
How to fix
Access resources you own or have been shared with.
RATE_LIMITEDHTTP 429
When
Per-second or per-hour quota exceeded.
How to fix
Wait the duration specified in the Retry-After header.
QUOTA_EXCEEDEDHTTP 429
When
Monthly plan quota is exhausted.
How to fix
Upgrade your plan or wait until the next billing cycle.
VALIDATION_ERRORHTTP 422
When
Request body doesn't match the schema (extra field, wrong type).
How to fix
Match the schema in the API reference.
INTERNALHTTP 500
When
Unexpected server-side error.
How to fix
Share the request_id with support.