POST Uploads (store)

Developing

POST

/api/uploads

Register a file upload in the database after a direct S3 upload via signed URL. The file must already be uploaded to S3; this endpoint records the metadata. Requires the S3 object key, filename, content type, and size.

Permission: write files

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-dev.commandroom.ai/api/api/uploads' \
--header 'Authorization: Bearer {{token}}' \
--header 'X-Tenant-UUID: ' \
--header 'Content-Type: application/json' \
--data '{
  "key": "string",
  "filename": "Sample Filename",
  "content_type": "string",
  "size": 1
}'

Response Example

201 - OK

{
  "data": {
    "upload_id": 1,
    "original_name": "Sample Original Name",
    "file_name": "Sample File Name",
    "file_path": "string",
    "mime_type": "string",
    "file_size": 1,
    "formatted_file_size": "string",
    "uploaded_by": 1,
    "uploader": {},
    "preview_url": "https://example.com/sample",
    "download_url": "https://example.com/sample",
    "created_at": "2026-01-15T10:30:00.000000Z",
    "updated_at": "2026-01-15T10:30:00.000000Z"
  },
  "message": "Success."
}

Modified at 2026-07-02 04:47:16

POST Set Team Lead (setTeamLead)

POST Signed Url (getSignedUrl)