# Uploads (temporary storage)

## Lists the uploaded documents

> Lists the uploaded documents.\<br /> The documents are kept for 24 hours.\<br /> The list includes the filenames of the documents.\<br /> The filenames can be used to reference the documents in request payloads.\<br /> When a document is referenced, Rialto will copy the document to a permanent storage.\<br /> During the copy operation, a key referencing the document in the final destination will be generated.\<br /> See the \[S3 documentation]\(<https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-presigned-url.html>) for more information on S3 pre-signed URLs.<br>

```json
{"openapi":"3.1.0","info":{"title":"Rialto API","version":"1.0.0"},"servers":[{"url":"https://api.rialtobridge.xyz/api/client/v1","description":"Main (production) server for the Rialto Client API"},{"url":"https://staging.api.rialtobridge.xyz/api/client/v1","description":"Test (staging) server for the Rialto Client API"},{"url":"http://localhost:3002/api/client/v1","description":"Development server for the Rialto Client API"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","name":"RIALTO_API_KEY","in":"header"}}},"paths":{"/uploads":{"get":{"summary":"Lists the uploaded documents","description":"Lists the uploaded documents.<br /> The documents are kept for 24 hours.<br /> The list includes the filenames of the documents.<br /> The filenames can be used to reference the documents in request payloads.<br /> When a document is referenced, Rialto will copy the document to a permanent storage.<br /> During the copy operation, a key referencing the document in the final destination will be generated.<br /> See the [S3 documentation](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-presigned-url.html) for more information on S3 pre-signed URLs.\n","operationId":"listDocuments","tags":["Uploads (temporary storage)"],"responses":{"200":{"description":"The list of uploaded documents.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"filename":{"description":"The filename of the uploaded document.","type":"string"},"updatedAt":{"description":"The last modified date of the uploaded document.","type":"string","format":"date-time"}}}}}}},"401":{"description":"Invalid API key"},"500":{"description":"An unexpected error occurred."}}}}}}
```

## Generates pre-signed URLs for uploading documents.

> Generates pre-signed URLs for uploading documents.\<br /> The uploaded documents are kept for 24 hours.\<br /> For each file, a pre-signed URL is generated.\<br /> Each pre-signed URL is valid for 5 minutes.\<br /> The filenames can be used to reference the documents in request payloads.\<br /> When a document is referenced, Rialto will copy the document to a permanent storage.\<br /> During the copy operation, a key referencing the document in the final destination will be generated.\<br /> See the \[S3 documentation]\(<https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-presigned-url.html>) for more information on S3 pre-signed URLs.<br>

```json
{"openapi":"3.1.0","info":{"title":"Rialto API","version":"1.0.0"},"servers":[{"url":"https://api.rialtobridge.xyz/api/client/v1","description":"Main (production) server for the Rialto Client API"},{"url":"https://staging.api.rialtobridge.xyz/api/client/v1","description":"Test (staging) server for the Rialto Client API"},{"url":"http://localhost:3002/api/client/v1","description":"Development server for the Rialto Client API"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","name":"RIALTO_API_KEY","in":"header"}}},"paths":{"/uploads/request-batch-upload":{"post":{"summary":"Generates pre-signed URLs for uploading documents.","description":"Generates pre-signed URLs for uploading documents.<br /> The uploaded documents are kept for 24 hours.<br /> For each file, a pre-signed URL is generated.<br /> Each pre-signed URL is valid for 5 minutes.<br /> The filenames can be used to reference the documents in request payloads.<br /> When a document is referenced, Rialto will copy the document to a permanent storage.<br /> During the copy operation, a key referencing the document in the final destination will be generated.<br /> See the [S3 documentation](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-presigned-url.html) for more information on S3 pre-signed URLs.\n","operationId":"requestUploads","tags":["Uploads (temporary storage)"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filenames":{"description":"The list of filenames for which to generate pre-signed URLs.<br /> It must only contain the following characters: <br /> - alphanumeric characters (a-z, A-Z, 0-9)<br /> - special characters: - _ . * ' ( ) & $ @ = ; / : space.\n","type":"array","items":{"type":"string"}}}}}}},"responses":{"201":{"description":"Pre-signed URLs for uploading documents.","content":{"application/json":{"schema":{"type":"object","properties":{"preSignedUrls":{"description":"The list of pre-signed URLs for uploading documents.","type":"array","items":{"type":"object","properties":{"filename":{"description":"The filename for which the pre-signed URL was generated.","type":"string"},"preSignedUrl":{"description":"The pre-signed URL for uploading the document.","type":"string"}}}}}}}}},"400":{"description":"Invalid request payload"},"401":{"description":"Invalid API key"},"500":{"description":"An unexpected error occurred."}}}}}}
```