Ctrl+K

Upload a report for a stablecoin (Admin only)

post/api/stablecoin/v1/admin/reports

Allocates a row and returns a presigned PUT URL. The browser uploads the file directly to S3 via the URL. No further BE call is required.

Request Body

stablecoin string required
Stablecoin identifier
Allowed values: gousd usd1 sofid cusd fyusd goqxmp
Example: GOUSD
title string required
Display title for the report
Min length: >= 1 characters
Example: Monthly Audit Report - January 2025
reportType string required
Report type (e.g. AUDIT)
Allowed value: AUDIT
Example: AUDIT
format string required
Report file format
Allowed values: PDF CSV
Example: PDF
fileName string required
Original filename with extension
Min length: >= 1 characters
Example: audit-report-jan-2025.pdf
fileSize number required
File size in bytes; rejected if > 50 * 1024 * 1024 (50 MB).
Example: 1048576
reportPeriodFrom string <date-time>
Start of report period
Example: 2025-01-01T00:00:00.000Z
reportPeriodTo string <date-time>
End of report period
Example: 2025-01-31T23:59:59.999Z
description string
Optional description of the report
Example: Monthly audit report covering all mint/burn transactions

200 Response

presignedUrl string required
Presigned S3 PUT URL the browser uses for the actual file upload.
Min length: >= 1 characters
expiresAt string <date-time>required
ISO timestamp when the presigned URL stops being valid (5 min from issuance).
id string <uuid>required
Unique identifier for the report
Example: 95bdbd9c-9cdc-41a4-ae70-165387b7aa51
stablecoin string required
Stablecoin identifier
Allowed values: gousd usd1 sofid cusd fyusd goqxmp
Example: GOUSD
title string required
Display title for the report
Min length: >= 1 characters
Example: Monthly Audit Report - January 2025
reportType string required
Report type (e.g. AUDIT)
Allowed value: AUDIT
Example: AUDIT
format string required
Report file format
Allowed values: PDF CSV
Example: PDF
status string required
Report status
Allowed values: ACTIVE ARCHIVED
Example: ACTIVE
fileName string required
Original filename with extension
Min length: >= 1 characters
Example: audit-report-jan-2025.pdf
fileSize number required
File size in bytes
Example: 1048576
createdAt string <date-time>required
Timestamp when the report was created
Example: 2025-01-15T10:30:00.000Z
createdBy string required
User ID who created the report
Min length: >= 1 characters
Example: 677cfdceca8396cf5f7534ddeb8d11e3
updatedAt string <date-time>required
Timestamp when the report was last updated
Example: 2025-01-15T10:30:00.000Z
reportPeriodFrom string <date-time>
Start of report period
Example: 2025-01-01T00:00:00.000Z
reportPeriodTo string <date-time>
End of report period
Example: 2025-01-31T23:59:59.999Z
description string
Description of the report
Example: Monthly audit report covering all mint/burn transactions

400 Response

500 Response