Ephemeral Resource Upload API#
Overview#
This API allows you to upload temporary files that will be automatically deleted after 24 hours. This API is Free of charge for Creator/Pro Plan. If you are on Free plan, you can not use it.Base URL#
https://upload.theapi.app
Authentication#
Authentication is required via API key
Must be on the Creator plan or higher
Add your API key to the request headers as x-api-key
Endpoint: Upload Temporary File#
Upload a file that will be automatically deleted after 24 hours.HTTP Request#
POST /api/ephemeral_resource| Header | Value | Description |
|---|
| Content-Type | application/json | Request body format |
| x-api-key | YOUR_API_KEY | Your API authentication key |
Request Body Parameters#
| Parameter | Type | Required | Description |
|---|
| file_name | string | Yes | Name of the file with extension (max 128 characters) |
| file_data | string | Yes | Base64 encoded file data. Can include data URI if it matches the file's content type (max 10MB) |
Supported File Extensions#
The following file extensions are supported (case-insensitive):File Name Requirements#
Must include one of the supported extensions
Maximum length: 128 characters
Extensions are case-insensitive
File Data Requirements#
Must be provided as a base64 string
Optional data URI is supported
If data URI is included, its content-type must match the file extension's content-type
Example Request#
Success Response#
A successful request will return a 200 status code with the following response structure:{
"code": 200,
"data": {
"url": "https://example.com/example.png"
},
"message": "success"
}
Error Responses#
Invalid Request (400)#
Returned when the request parameters are invalid (e.g., unsupported file type, file too large).{
"code": 400,
"message": "Invalid request parameters"
}
Insufficient Permissions (403)#
Returned when the user's plan level is insufficient (requires Creator plan or higher).{
"code": 403,
"message": "Insufficient plan level"
}
Important Notes#
1.
Uploaded files are automatically deleted after 24 hours
2.
The service requires a Creator plan or higher
3.
The file_data field can include a data URI, but if included, its content-type must match the file extension's expected content-type
4.
File names are validated for supported extensions in a case-insensitive manner
Additional Examples#
Example with JPG file#
Example with MP3 file#
Modified at 2025-06-25 07:03:16
