Developer API
Uploader
Upload your own audio and animation files to Roblox in one batch and get the asset ID of each file.
Create a job
Code
POST https://api.jualgame.id/api/v1/uploader/jobsSend multipart/form-data.
| Field | Notes |
files | Required. Repeat the field for each file, up to 100 files. Allowed: .mp3, .ogg, .wav, .flac, .rbxm, .rbxmx. At most 25 MB per file and 200 MB per request. |
roblox_api_key | Required. A Roblox Open Cloud API key with Assets read and write access. |
creator_id | Required. Numeric Roblox user ID or group ID that will own the assets. |
creator_type | user (default) or group. |
external_id | Your own ID for this job, at most 100 characters. |
Code
curl -X POST https://api.jualgame.id/api/v1/uploader/jobs \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "[email protected]" \
-F "[email protected]" \
-F "roblox_api_key=YOUR_ROBLOX_OPEN_CLOUD_KEY" \
-F "creator_id=123456" \
-F "creator_type=group" \
-F "external_id=batch-77".rbxm and .rbxmx files are uploaded as Animation; the rest as Audio. The asset name is taken from the filename.
Read a job
Code
GET https://api.jualgame.id/api/v1/uploader/jobs/{job_id}Response
{
"success": true,
"data": {
"job_id": "cmutu55vj0003oildauwhldih",
"external_id": "batch-77",
"status": "completed",
"error": null,
"total_files": 2,
"approved_count": 1,
"reviewing_count": 0,
"rejected_count": 0,
"failed_count": 1,
"items": [
{
"index": 0,
"filename": "track-one.mp3",
"display_name": "track-one",
"asset_type": "Audio",
"size_bytes": 482113,
"status": "APPROVED",
"asset_id": "1234567890",
"operation_id": "9f1c...",
"error": null
},
{
"index": 1,
"filename": "dance.rbxm",
"display_name": "dance",
"asset_type": "Animation",
"size_bytes": 20311,
"status": "FAILED",
"asset_id": null,
"operation_id": null,
"error": "Message from Roblox"
}
],
"created_at": "2026-10-04T13:10:00.000Z",
"finished_at": "2026-10-04T13:10:21.000Z"
}
}| Item status | Meaning |
QUEUED | Waiting. |
UPLOADING | Being sent to Roblox. |
APPROVED | Uploaded and passed moderation. |
REVIEWING | Uploaded; Roblox moderation has not finished. |
REJECTED | Uploaded but rejected by Roblox moderation. |
FAILED | Not uploaded. See error. |
The job is completed when at least one file reached Roblox, and failed when every file failed. Always read the per-file status.
JualGame does not keep your Roblox key, so it cannot re-check items left in REVIEWING. Check those later with your own key, using asset_id or operation_id.
If the service restarts while a job is running, the job is marked failed after 2 hours with the message "The job was interrupted". Submit it again.
