Generate pre-signed credentials for uploading files directly to cloud storage.

Workflow

1. Request credentials: Call this endpoint with the resource type, id, purpose, and file extension
2. Upload your file: Use the response fields to upload directly to the storage provider
3. Update the resource: After upload completes, update the resource with the returned url (e.g., PATCH /v2/courses/{id} with thumbnail_url)

How to Upload

Build your upload request using the response fields:

1. Send a request to upload_url using upload_method
2. Set all headers from upload_headers (includes Content-Type)
3. Include each key-value pair from upload_body in your request body
4. Include your file using the field name from file_field_name

Note: Serialize upload_body according to the Content-Type header. If file_field_name is present, include your file as a field with that name alongside the upload_body fields. If file_field_name is null, send the file as the raw request body.

Example

# 1. Request upload credentials
curl -X POST "https://developers.teachable.com/v2/uploads" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "course", "id": 123, "purpose": "thumbnail", "extension": "jpg"}'

# Response:
# {
#   "upload_url": "https://api2.transloadit.com/assemblies",
#   "upload_method": "POST",
#   "upload_headers": {"Content-Type": "multipart/form-data"},
#   "upload_body": {"params": "...", "signature": "..."},
#   "file_field_name": "file",
#   "url": "https://cdn.teachablecdn.com/...",
#   "expires": "2024-01-01T13:00:00Z",
#   "upload_id": "abc-123"
# }

# 2. Upload the file using the credentials
curl -X POST "https://api2.transloadit.com/assemblies" \
  -H "Content-Type: multipart/form-data" \
  -F "params=..." \
  -F "signature=..." \
  -F "file=@/path/to/image.jpg"

# 3. Update the resource with the CDN URL
curl -X PATCH "https://developers.teachable.com/v2/courses/123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"thumbnail_url": "https://cdn.teachablecdn.com/..."}'

Response Fields

Supported Resources

Constraints

• Maximum file size: 20 GB
• Extension: 1-10 alphanumeric characters (e.g., jpg, pdf, mp4)
• Credentials expire: 1 hour after creation