Video Processing API
Upload videos, trigger asynchronous processing, and track job status through a scalable, secure video processing pipeline.
Base URL
https://manage.gretxp.com
All API endpoints are accessed relative to this base URL.
Authentication
All Video Processing APIs require authentication using a Client ID and Client Secret.
These credentials can be generated from your dashboard:
https://buildvr.gretxp.com/profile/api-credentials
Generate, rotate, and revoke API credentials securely.
Required Headers
X-Client-ID: <YOUR_CLIENT_ID> X-Client-Secret: <YOUR_CLIENT_SECRET>
Requests missing these headers will be rejected with 401 Unauthorized.
High-Level Workflow
- Initiate a video upload session
- Upload the video file to storage
- Complete the upload to trigger processing
- Monitor processing job status
- Retry the job if processing fails
How Processing Works
Video processing is handled asynchronously to support large files and long-running operations without blocking client applications.
- Initiate Upload creates a temporary upload session.
- Complete Upload confirms the file upload and starts processing.
- Processing Jobs represent each video’s processing lifecycle.
Job Lifecycle
PENDING → UPLOADING → PROCESSING → COMPLETED ↘ FAILED → RETRYING
Failed jobs can be retried using the retry endpoint.
Limits & Plans
API usage limits and processing capabilities depend on your subscription plan.
- Free / Trial Plans – Limited uploads and processing quotas.
- Paid Plans – Higher limits, faster processing, priority jobs.
- Enterprise Plans – Custom limits, dedicated infrastructure.
Common Errors
- 400 – Invalid request payload
- 401 – Plan limit exceeded
- 403 – Missing or invalid API credentials
- 404 – Processing job not found
- 429 – Rate limit exceeded
👉 Next: Initiate Upload – start processing your first video.