Ensure the MediaPackage endpoint has a time-delay or DVR window long enough to contain the clip you want to harvest; harvest start and end times must fall within the available window
Call the CreateHarvestJob API with the endpoint ID, an ISO 8601 startTime and endTime (both in the past), and an S3Destination specifying the bucket, manifest key, and role ARN
Poll DescribeHarvestJob or subscribe to MediaPackage CloudWatch events to monitor job status; harvest jobs run once and cannot be modified after creation
Once status is SUCCEEDED, retrieve the manifest from the S3 destination; MediaPackage writes an HLS manifest (and optionally a DASH MPD) along with the media segments
Optionally ingest the harvested S3 asset into MediaPackage VOD or a CDN origin for on-demand delivery with DRM
Known gotchas
The maximum harvest duration is 24 hours; attempting to harvest a window longer than that returns a validation error — split longer clips into multiple jobs
Harvest jobs are immutable and cannot be deleted from your account history once created; plan job IDs carefully to avoid confusion in high-volume workflows
The S3 destination bucket must be in the same region as the MediaPackage channel and the role must have s3:PutObject permission on the destination prefix, or the job will fail silently during the segment write phase
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp