Skip to main content
POST
/
content
/
upload
{
  "content_id": "<string>",
  "name": "<string>",
  "file_type": "<string>",
  "size": 123,
  "status": "<string>",
  "created_at": {},
  "file_path": "<string>",
  "file_url": "<string>"
}

​
Overview

Uploads content to the system for evaluation. Supports text, video, audio, and image files. Content can be provided as direct text, file upload, or URL.

​
Request (Multipart Form)

​
file
file
File to upload (for video, audio, image content)
​
text_content
string
Direct text content (for text type only)
​
file_url
string
URL to external content file
​
name
string
required
Name/title of the content
​
description
string
Description of the content
​
file_type
string
required
Content type
  • text - Text content
  • video - Video files (mp4, avi, mov)
  • audio - Audio files (mp3, wav, m4a)
  • image - Image files (jpg, png, gif)
​
metadata
json
Additional metadata as JSON string

​
Response

​
content_id
string
required
Unique identifier for uploaded content
​
name
string
required
Content name
​
file_type
string
required
Content type
​
size
integer
required
File size in bytes
​
status
string
required
Processing status
  • uploaded - Successfully uploaded
  • processing - Being processed
  • ready - Ready for evaluation
​
created_at
datetime
required
Upload timestamp
​
file_path
string
Internal file storage path
​
file_url
string
External file URL if provided

​
Examples

curl -X POST https://api.judge.example.com/content/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "text_content=This is sample text content to evaluate" \
  -F "name=Sample Article" \
  -F "description=Article about API documentation" \
  -F "file_type=text"

curl -X POST https://api.judge.example.com/content/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]" \
  -F "name=Product Demo Video" \
  -F "description=Product demonstration" \
  -F "file_type=video"

curl -X POST https://api.judge.example.com/content/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]" \
  -F "name=Invalid File" \
  -F "file_type=text"