Create Reference Content Upload URL
Judges
Create Reference Content Upload URL
Generate a pre-signed upload URL for judge reference content
Create Reference Content Upload URL
Authentication
Required: API Key authentication viaX-API-Key header
Request Body
The file extension of the content to upload. Must be between 1-10 characters.Examples:
mp4, jpg, png, wav, pdfOptional display name for the file (without extension). Max 50 characters. The name is sanitized to lowercase alphanumeric characters, hyphens, and underscores. If omitted, a random identifier is generated.Examples:
episode_1, intro_segmentRequest Example
cURL
JSON Body
Response
A pre-signed GCS (Google Cloud Storage) URL for uploading the reference content.This URL is valid for a limited time (15 minutes) and should be used with a PUT request to upload the file directly.
ISO 8601 timestamp indicating when the upload URL expires (15 minutes from creation)
The GCS URI where the file will be stored. This can be used to reference the file in subsequent API call to create a judge.Format:
gs://bucket-name/path/to/fileResponse Example
How to Upload Content
After receiving the response, use theupload_url to upload your file:
Important Notes
- The upload URL expires after 15 minutes (see
expires_atfield) - The file must be uploaded using a PUT request
- Set the appropriate
Content-Typeheader when uploading - The
reference_content_urireturned should be used to reference this content when creating a judge